Agent coordination
에이전트 전송
openclaw agent는 인바운드 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 워크플로, 테스트, 프로그래밍 방식 전달에 사용하세요.
빠른 시작
간단한 에이전트 턴 실행
openclaw agent --message "What is the weather today?"이 명령은 Gateway를 통해 메시지를 보내고 응답을 출력합니다.
특정 에이전트 또는 세션 대상으로 지정
# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task"응답을 채널로 전달
# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \ --deliver --reply-channel slack --reply-to "#reports"플래그
| 플래그 | 설명 |
|---|---|
--message \<text\> |
보낼 메시지(필수) |
--to \<dest\> |
대상(전화, 채팅 ID)에서 세션 키 파생 |
--agent \<id\> |
구성된 에이전트를 대상으로 지정(main 세션 사용) |
--session-id \<id\> |
ID로 기존 세션 재사용 |
--local |
로컬 임베디드 런타임 강제 사용(Gateway 건너뜀) |
--deliver |
응답을 채팅 채널로 전송 |
--channel \<name\> |
전달 채널(whatsapp, telegram, discord, slack 등) |
--reply-to \<target\> |
전달 대상 재정의 |
--reply-channel \<name\> |
전달 채널 재정의 |
--reply-account \<id\> |
전달 계정 ID 재정의 |
--thinking \<level\> |
선택한 모델 프로필의 사고 수준 설정 |
--verbose \<on|full|off\> |
상세 출력 수준 설정 |
--timeout \<seconds\> |
에이전트 제한 시간 재정의 |
--json |
구조화된 JSON 출력 |
동작
- 기본적으로 CLI는 Gateway를 통해 실행됩니다. 현재 머신에서 임베디드 런타임을 강제로 사용하려면
--local을 추가하세요. - Gateway에 연결할 수 없으면 CLI는 로컬 임베디드 실행으로 대체합니다.
- 세션 선택:
--to는 세션 키를 파생합니다(그룹/채널 대상은 격리를 유지하고, 직접 채팅은main으로 합쳐집니다). - 사고 및 상세 출력 플래그는 세션 저장소에 유지됩니다.
- 출력: 기본값은 일반 텍스트이며, 구조화된 페이로드와 메타데이터에는
--json을 사용합니다. --json --deliver를 사용하면 JSON에 전송됨, 억제됨, 부분 전송, 전송 실패에 대한 전달 상태가 포함됩니다. JSON 전달 상태를 참조하세요.
예제
# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"