claude_local 어댑터는 Anthropic의 Claude Code CLI를 로컬 환경에 통합합니다. 세션 지속성, 스킬 주입, 구조화된 출력 파싱을 제공합니다. 요구사항 Claude Code CLI 설치 (claude 명령 접근 가능) ANTHROPIC_API_KEY 환경변수 또는 에이전트 설정에서 구성 주요 설정 옵션 설정 설명 cwd (필수) 에이전트의 작업 디렉토리 절대 경로 model 사용할 Claude 버전 promptTemplate 변수 치환 지원 커스텀 프롬프트 ({{agentId}}, {{runId}}, {{agent.name}} 등) env 시크릿 참조를 포함한 환경 변수 timeoutSec 프로세스 타임아웃 graceSec 강제 종료 유예 기간 maxTurnsPerRun 하트비트당 에이전트 반복 제한 dangerouslySkipPermissions (개발 전용) 권한 검사 우회 플래그 세션 관리 하트비트 간 Claude Code 세션 ID를 유지합니다. 전체 컨텍스트 보존으로 대화를 재개합니다. 작업 디렉토리가 변경되거나 알 수 없는 세션 오류가 발생하면 세션이 리셋됩니다. ...

개요 web_search 도구는 에이전트가 인터넷 검색을 수행하여 최신 정보를 가져올 수 있게 한다. 10개의 검색 프로바이더를 지원하며, 15분 캐시를 통해 중복 검색 비용을 절감한다. 지원 프로바이더 프로바이더 특징 Brave 프라이버시 중심, 자체 인덱스 DuckDuckGo API 키 불필요, 무료 Exa 시맨틱 검색 특화 Firecrawl 웹 스크래핑 + 검색 Gemini Google AI 기반 검색 Grok xAI 기반 검색 Kimi 중국어 검색 특화 Perplexity AI 요약 검색 SearXNG 셀프 호스팅 메타 검색 Tavily AI 에이전트 최적화 검색 프로바이더 자동 감지 API 키가 설정된 프로바이더를 자동으로 감지하여 우선순위에 따라 사용한다. 수동으로 프로바이더를 지정할 수도 있다. ...

codex_local 어댑터는 OpenAI의 Codex CLI를 로컬에서 실행합니다. 요구사항 Codex CLI 설치 OPENAI_API_KEY 환경변수 또는 에이전트 설정에서 구성 주요 설정 옵션 설정 설명 cwd (필수) 에이전트가 작업하는 절대 디렉토리 경로 model 사용할 모델 promptTemplate 모든 실행에 적용되는 커스텀 프롬프트 env 시크릿 참조를 포함한 환경 변수 timeoutSec 프로세스 타이밍 제어 graceSec 종료 동작 dangerouslyBypassApprovalsAndSandbox (개발용) 안전 메커니즘 비활성화 작동 방식 세션 간 previous_response_id 체이닝으로 대화 연속성을 유지합니다. ~/.codex/skills에 심링크를 생성하여 Paperclip 스킬을 자동 통합하며, 기존 사용자 스킬을 보존합니다. ...

개요 exec 도구는 에이전트가 셸 명령어를 실행할 수 있게 한다. 포그라운드 실행과 process를 통한 백그라운드 실행을 지원하며, 승인 모드와 허용 목록으로 보안을 관리한다. 실행 방식 포그라운드 실행 명령어를 실행하고 완료될 때까지 대기한다. 기본 타임아웃은 **1800초(30분)**이다. exec("ls -la /tmp") 백그라운드 실행 process 도구를 통해 장시간 실행되는 명령어를 백그라운드에서 처리한다. process.start("npm run build") process.status("pid-123") process.kill("pid-123") 실행 호스트 명령어가 실행되는 환경을 지정한다. 호스트 설명 sandbox 샌드박스 환경 (기본값). Docker 또는 SSH 격리 gateway 게이트웨이 프로세스에서 직접 실행 node 특정 노드에서 실행 { "tools": { "exec": { "host": "sandbox", "timeout": 1800 } } } 승인 모드 명령어 실행 전 승인을 요구하는 수준을 설정한다. ...

gemini_local 어댑터는 Google의 Gemini CLI를 로컬에서 실행합니다. --resume으로 세션 지속성, 스킬 주입, 구조화된 stream-json 출력 처리를 지원합니다. 요구사항 Gemini CLI 설치 및 접근 가능 GEMINI_API_KEY, GOOGLE_API_KEY 또는 로컬 CLI 설정으로 인증 설정 옵션 필드 용도 cwd 작업 디렉토리 (필수, 절대 경로) model Gemini 모델 선택 (기본값: auto) promptTemplate 모든 실행용 커스텀 프롬프트 instructionsFilePath 앞에 추가할 마크다운 지시사항 env 시크릿 지원 환경 변수 timeoutSec 프로세스 타임아웃 임계값 graceSec 강제 종료 유예 기간 yolo 무인 작업 모드 활성화 세션 관리 작업 디렉토리가 일관되면 세션이 자동 재개됩니다. 디렉토리가 변경되거나 재개 실패 시 새 세션이 시작됩니다. ...

개요 서브 에이전트는 주 에이전트가 생성하는 백그라운드 프로세스이다. 독립된 컨텍스트에서 실행되며, 비동기적으로 작업을 처리하고 결과를 요청 채널에 요약하여 보고한다. 동작 방식 주 에이전트가 서브 에이전트를 스폰(spawn) 서브 에이전트가 격리된 컨텍스트에서 작업 수행 논블로킹(non-blocking) 방식으로 runId 즉시 반환 작업 완료 시 요약을 요청 채널에 포스팅 [주 에이전트] ──spawn──→ [서브 에이전트 #1] ──(작업 중)──→ [요약 포스트] ──spawn──→ [서브 에이전트 #2] ──(작업 중)──→ [요약 포스트] ──(계속 다른 작업)──→ /subagents 명령어 명령어 설명 /subagents list 활성 서브 에이전트 목록 /subagents kill <runId> 특정 서브 에이전트 종료 /subagents log <runId> 서브 에이전트 실행 로그 확인 /subagents spawn <task> 수동으로 서브 에이전트 스폰 서브 에이전트 목록 확인 /subagents list RunID | Status | Task | Started -----------|----------|-------------------|------------------ run-abc123 | running | 웹 리서치 | 2026-04-01 09:15 run-def456 | complete | 데이터 분석 | 2026-04-01 09:10 중첩 (Nesting) 서브 에이전트는 자체적으로 다시 서브 에이전트를 스폰할 수 있다. ...

HTTP 어댑터는 외부 에이전트 서비스를 트리거하는 웹훅 메커니즘입니다. Fire-and-forget 모델로 작동하며 stdout 캡처나 실시간 실행 가시성을 제공하지 않습니다. 적합한 경우 외부 서비스 배포 (클라우드 함수, 전용 서버) 비동기 호출 패턴 서드파티 에이전트 플랫폼 통합 부적합한 경우 같은 머신에서 로컬 실행하는 에이전트 출력 스트림 캡처가 필요한 시나리오 설정 파라미터 필드 설명 필수 URL POST 요청을 보낼 웹훅 URL 예 헤더 커스텀 HTTP 헤더 아니오 타임아웃 초 단위 타임아웃 아니오 작동 흐름 Paperclip이 지정 엔드포인트에 실행 메타데이터가 담긴 POST 요청 전송 외부 에이전트가 페이로드 처리 제공된 API 자격증명으로 Paperclip에 인증된 콜백 요청 요청 구조 { "runId": "...", "agentId": "...", "companyId": "...", "context": { "taskId": "...", "wakeReason": "...", "commentId": "..." } }

개요 image_generate 도구를 통해 에이전트가 텍스트 프롬프트로 이미지를 생성하거나 기존 이미지를 편집할 수 있다. 여러 프로바이더를 지원하며, 프로바이더 장애 시 자동 폴백을 제공한다. 지원 프로바이더 프로바이더 모델 이미지 편집 OpenAI gpt-image-1 지원 Google gemini 지원 fal flux 미지원 MiniMax minimax 미지원 편집 지원 여부는 프로바이더에 따라 다르다. OpenAI와 Google은 기존 이미지를 입력받아 편집할 수 있지만, fal과 MiniMax는 텍스트-투-이미지만 지원한다. 파라미터 파라미터 타입 설명 기본값 prompt string 이미지 생성 프롬프트 (필수) action string generate 또는 edit generate model string 사용할 모델 프로바이더 기본값 size string 이미지 크기 (1024x1024 등) 1024x1024 aspectRatio string 종횡비 (16:9, 1:1 등) 1:1 count number 생성할 이미지 수 1 size vs aspectRatio size: 정확한 픽셀 크기 지정 (예: 1024x1024, 1792x1024) aspectRatio: 비율만 지정하고 크기는 프로바이더가 결정 (예: 16:9) 둘 다 지정하면 size가 우선 자동 폴백 프로바이더 장애 시 자동으로 다음 프로바이더로 전환한다. ...

Process 어댑터는 임의의 셸 명령을 실행합니다. 간단한 스크립트, 일회성 작업, 커스텀 프레임워크 에이전트에 적합합니다. 적합한 경우 Paperclip API를 호출하는 Python 스크립트 실행 커스텀 에이전트 루프 실행 셸 명령으로 호출 가능한 모든 런타임 부적합한 경우 실행 간 세션 지속성이 필요한 시나리오 하트비트 간 대화 컨텍스트가 필요한 에이전트 설정 파라미터 필드 타입 필수 용도 command string 예 실행할 셸 명령 cwd string 아니오 작업 디렉토리 env object 아니오 환경 변수 timeoutSec number 아니오 프로세스 타임아웃 작동 흐름 명령을 자식 프로세스로 생성 표준 Paperclip 환경 변수 주입 (PAPERCLIP_AGENT_ID, PAPERCLIP_API_KEY 등) 프로세스를 완료까지 실행 종료 코드로 성공 여부 판단

개요 WhatsApp 채널은 OpenClaw 에이전트를 WhatsApp 메신저에 연결한다. QR 코드 페어링으로 설정하며, DM/그룹 정책, 미디어 처리, 멀티 계정을 지원한다. 설치 및 설정 플러그인 설치 openclaw onboard # 또는 openclaw channels add whatsapp QR 코드 페어링 openclaw channels login whatsapp 터미널에 QR 코드가 표시되면 WhatsApp 모바일 앱의 연결된 기기 메뉴에서 스캔한다. DM 정책 정책 설명 pairing 최초 메시지 시 페어링 승인 필요 (기본값) allowlist 허용 목록에 있는 번호만 DM 가능 open 모든 사용자의 DM 허용 disabled DM 비활성화 { "channels": { "whatsapp": { "dmPolicy": "pairing", "allowlist": [ "+82-10-1234-5678", "+82-10-9876-5432" ] } } } 페어링 방식 새 사용자가 에이전트에 DM 발송 에이전트가 “페어링 요청"을 관리자에게 알림 관리자가 승인하면 해당 사용자와 대화 시작 거부하면 해당 사용자의 메시지 무시 그룹 정책 그룹 허용 목록으로 에이전트가 참여할 그룹을 제한한다. ...