Agent coordination
에이전트 전송
openclaw agent는 인바운드 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 기반 워크플로, 테스트, 프로그래밍 방식 전달에 사용하세요.
빠른 시작
간단한 에이전트 턴 실행
openclaw agent --agent main --message "What is the weather today?"이 명령은 Gateway를 통해 메시지를 보내고 응답을 출력합니다.
파일에서 여러 줄 프롬프트 보내기
openclaw agent --agent ops --message-file ./task.md이 명령은 유효한 UTF-8 파일을 에이전트 메시지 본문으로 읽습니다.
특정 에이전트 또는 세션 지정
# 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" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"응답을 채널로 전달
# 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\> |
보낼 인라인 메시지 |
--message-file \<path\> |
유효한 UTF-8 파일에서 메시지 읽기 |
--to \<dest\> |
대상(전화번호, 채팅 ID)에서 세션 키 파생 |
--session-key \<key\> |
명시적 세션 키 사용 |
--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을 추가하세요. --message또는--message-file중 정확히 하나만 전달하세요. 파일 메시지는 선택적 UTF-8 BOM을 제거한 뒤 여러 줄 콘텐츠를 보존합니다.- Gateway에 연결할 수 없으면 CLI는 로컬 내장 실행으로 폴백합니다.
- 세션 선택:
--to는 세션 키를 파생합니다(그룹/채널 대상은 격리를 유지하고, 직접 채팅은main으로 합쳐집니다). --session-key는 명시적 키를 선택합니다. 에이전트 접두사가 붙은 키는agent:<agent-id>:<session-key>를 사용해야 하며,--agent도 함께 제공된 경우 해당 에이전트 ID와 일치해야 합니다. 접두사가 없는 비 sentinel 키는--agent가 제공되면 해당 에이전트로 범위가 지정됩니다. 예를 들어--agent ops --session-key incident-42는agent:ops:incident-42로 라우팅됩니다.--agent가 없으면 접두사가 없는 비 sentinel 키는 구성된 기본 에이전트로 범위가 지정됩니다. 리터럴global및unknown은--agent가 제공되지 않은 경우에만 범위가 지정되지 않은 상태로 유지됩니다. 이 경우 내장 폴백과 스토어 소유권은 구성된 기본 에이전트를 사용합니다.- Thinking 및 verbose 플래그는 세션 스토어에 유지됩니다.
- 출력: 기본값은 일반 텍스트이며, 구조화된 페이로드와 메타데이터가 필요하면
--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 # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"관련 항목
Was this useful?
