openclaw agent (직접 에이전트 실행)

openclaw agent는 수신 채팅 메시지 없이도 단일 에이전트 턴을 실행합니다. 기본적으로 게이트웨이를 통해 실행되며, --local을 추가하면 현재 머신의 임베디드 런타임을 강제로 사용합니다.

동작

• 필수: --message <text>
• 세션 선택:
  • --to <dest>는 세션 키를 파생합니다 (그룹/채널 대상은 격리를 유지하고, 다이렉트 채팅은 main으로 통합), 또는
  • --session-id <id>는 기존 세션을 ID로 재사용, 또는
  • --agent <id>는 구성된 에이전트를 직접 대상으로 합니다 (해당 에이전트의 main 세션 키 사용)
• 일반 수신 응답과 동일한 임베디드 에이전트 런타임을 실행합니다.
• 씽킹/상세 플래그가 세션 저장소에 유지됩니다.
• 출력:
  • 기본값: 응답 텍스트 출력 (추가로 MEDIA:<url> 행)
  • --json: 구조화된 페이로드 + 메타데이터 출력
• --deliver + --channel로 채널에 선택적 전달 (대상 형식은 openclaw message --target과 동일).
• --reply-channel/--reply-to/--reply-account를 사용하여 세션 변경 없이 전달을 오버라이드합니다.

게이트웨이에 연결할 수 없으면 CLI가 임베디드 로컬 실행으로 폴백합니다.

예시

openclaw agent --to +15555550123 --message "status update"
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --to +15555550123 --message "Summon reply" --deliver
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

플래그

• --local: 로컬 실행 (셸에 모델 프로바이더 API 키 필요)
• --deliver: 선택한 채널로 응답 전송
• --channel: 전달 채널 (whatsapp|telegram|discord|googlechat|slack|signal|imessage, 기본값: whatsapp)
• --reply-to: 전달 대상 오버라이드
• --reply-channel: 전달 채널 오버라이드
• --reply-account: 전달 계정 ID 오버라이드
• --thinking <off|minimal|low|medium|high|xhigh>: 씽킹 레벨 유지 (GPT-5.2 + Codex 모델만 해당)
• --verbose <on|full|off>: 상세 레벨 유지
• --timeout <seconds>: 에이전트 타임아웃 오버라이드
• --json: 구조화된 JSON 출력