Opencode 세션, 에이전트 모드 및 모델 제공자 구성을 오케스트레이션하기 위한 전문가급 명령 인터페이스입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install opencode-controller
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 opencode-controller 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Opencode 컨트롤러란 무엇인가요?
Opencode 컨트롤러는 AI 보조 개발 환경의 중심 오케스트레이션 계층 역할을 합니다. 세션 및 에이전트 상태를 관리하기 위한 구조화된 프레임워크를 제공함으로써 인간의 지시와 자율적 실행 사이의 간극을 메우도록 설계되었습니다. Openclaw Skills를 활용함으로써 이 도구는 코딩 환경이 조직적이고 안전하며 효율적으로 유지되도록 보장합니다.
이 스킬은 관심사 분리 철학을 바탕으로 구축되었습니다. 계획 단계와 구축 단계를 구분하여 검증된 아키텍처 계획 없이는 코드가 작성되지 않도록 합니다. 제공자 인증 및 세션 지속성의 복잡성을 간소화하여 일상적인 작업에서 Openclaw Skills를 활용하는 개발자에게 필수적인 구성 요소가 됩니다.
Opencode 컨트롤러 활용 사례
- 세션 선택기를 통해 여러 동시 코딩 프로젝트를 관리합니다.
- 아키텍처 오류를 최소화하기 위해 '계획 후 구축(Plan-then-Build)' 워크플로우를 강제합니다.
- 특정 작업을 위해 Anthropic 또는 OpenAI와 같은 서로 다른 LLM 제공자 간에 빠르게 전환합니다.
- 다양한 AI 모델 제공자에 대한 인증 워크플로우를 중앙 집중화합니다.
Opencode 컨트롤러 작동 원리
- 사용자가 컨트롤러를 시작하고 선호하는 AI 제공자 및 인증 방법을 선택합니다.
- 스킬이
\/sessions명령을 사용하여 세션 관리 인터페이스를 열고 작업 공간을 재개하거나 생성합니다. - 사용자가
\/agents명령을 통해 Plan 에이전트를 활성화하여 작업을 분석하고 단계별 로드맵을 생성합니다. - 계획이 검증되면 사용자는 구현을 위해 Build 에이전트로 전환합니다.
- 컨트롤러는 작업이 완료될 때까지 계획과 구축 사이의 연속 루프를 관리합니다.
Opencode 컨트롤러 설정 가이드
이 스킬을 로컬 환경에 통합하려면 다음 단계를 따르세요.
- 환경이 Openclaw Skills를 지원하도록 구성되었는지 확인합니다.
- 스킬 매니페스트에
opencode-controller를 추가합니다. - 세션 관리자를 시작하기 위해 초기화 명령을 실행합니다.
\/sessions
- AI 모델 제공자를 구성하고 인증을 처리합니다.
\/models
Opencode 컨트롤러 데이터 스키마 및 분류 체계
| 데이터 요소 | 유형 | 목적 |
|---|---|---|
| 세션 레지스트리 | 메타데이터 | 기존 프로젝트 ID 및 세션 기록 추적 |
| 에이전트 상태 | Enum | 현재 모드 정의: Plan 또는 Build |
| 제공자 구성 | 객체 | 제공자별 설정 및 인증 상태 저장 |
| 로그인逐字 (Verbatim) | 문자열 | 보안 인증 링크 캡처 및 전달 |
Opencode 컨트롤러 고급 기능
- 프로젝트 중복을 방지하기 위한 컨텍스트 인식 세션 전환.
- Plan 모드에서 코드 생성을 방지하는 엄격한 상태 머신 적용.
- Build 에이전트가 모호함에 직면했을 때 Plan 모드로의 복귀를 강제하는 자동 전환 후크.
- 사용자의 안전한 수동 인증을 보장하기 위한 Verbatim 로그인 링크 처리.
- 포괄적인 자동화를 위한 다른 Openclaw Skills와의 긴밀한 통합.
SKILL.md
로드 중
관련 Openclaw 스킬
AgentPay
AI 에이전트가 사람이 승인한 암호화 위임장을 통해 판매자 웹사이트에서 구매를 제안하고 실행할 수 있도록 하는 안전한 결제 브리지입니다.
Evolution WhatsApp 스킬
Evolution API v2를 통해 AI 에이전트가 WhatsApp과 상호 작용하여 자동 메시징 및 관리를 수행할 수 있게 해주는 포괄적인 도구입니다.
MarkItDown 문서 변환기
다양한 파일 형식을 깔끔하고 구조화된 Markdown으로 변환하기 위한 다재다능한 문서 변환 엔진입니다.
OpenClaw 문서 검색 및 구성 패턴
OpenClaw 에이전트 설정 수정 시 오류를 방지하도록 설계된 전문 문서 검색 및 구성 가드레일 시스템입니다.
추천*
