Agent coordination
에이전트 전송
openclaw agent는 수신 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 기반 워크플로, 테스트 및 프로그래밍 방식의 전달에 사용하세요. 전체 플래그 및 동작 참조:
에이전트 CLI 참조.
빠른 시작
간단한 에이전트 턴 실행
openclaw agent --agent main --message "What is the weather today?"Gateway를 통해 메시지를 보내고 응답을 출력합니다.
파일에서 여러 줄 프롬프트 보내기
openclaw agent --agent ops --message-file ./task.md유효한 UTF-8 파일을 에이전트 메시지 본문으로 읽습니다.
특정 에이전트 또는 세션 지정
# 특정 에이전트 지정openclaw agent --agent ops --message "Summarize logs" # 전화번호 지정(세션 키 파생)openclaw agent --to +15555550123 --message "Status update" # 기존 세션 재사용openclaw agent --session-id abc123 --message "Continue the task" # 정확한 세션 키 지정openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"채널로 응답 전달
# WhatsApp으로 전달(기본 채널)openclaw agent --to +15555550123 --message "Report ready" --deliver # Slack으로 전달openclaw 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로 기존 세션 재사용 |
--model <id> |
이번 실행의 모델 재정의(provider/model 또는 모델 ID) |
--local |
로컬 내장 런타임 강제 사용(Gateway 건너뛰기) |
--deliver |
채팅 채널로 응답 전송 |
--channel <name> |
전달 채널. --agent + --to와 함께 사용하면 DM 범위에도 적용 |
--reply-to <target> |
전달 대상 재정의 |
--reply-channel <name> |
전달 채널 재정의 |
--reply-account <id> |
전달 계정 ID 재정의 |
--thinking <level> |
선택한 모델 프로필의 사고 수준 설정 |
--verbose <on|full|off> |
세션의 상세 출력 수준 유지(full은 도구 출력도 기록) |
--timeout <seconds> |
에이전트 시간 제한 재정의(기본값 600 또는 구성값) |
--json |
구조화된 JSON 출력 |
동작
- 기본적으로 CLI는 Gateway를 통과합니다. 현재 머신에서 내장 런타임을 강제로 사용하려면
--local을 추가하세요. --message또는--message-file중 정확히 하나만 전달하세요. 파일 메시지는 선택적인 UTF-8 BOM을 제거한 후에도 여러 줄 콘텐츠를 유지합니다.- Gateway 요청이 실패하면 CLI는 로컬 내장 실행으로 폴백합니다. Gateway 시간 초과 시에는 원래 트랜스크립트와 경합하지 않고 새 세션으로 폴백합니다.
- 세션 선택:
--to는 세션 키를 파생합니다(그룹/채널 대상은 격리를 유지하고, 직접 채팅은main으로 통합됩니다).--agent,--channel,--to를 함께 사용하면 채널의 정규 수신자와session.dmScope에 따라 라우팅됩니다. 안정적인 발신 전용 ID는 에이전트의 기본 세션과 격리된 공급자 소유 세션을 사용합니다. --session-key는 명시적 키를 선택합니다. 에이전트 접두사가 있는 키는agent:<agent-id>:<session-key>형식을 사용해야 하며,--agent도 함께 제공된 경우 해당 에이전트 ID와 일치해야 합니다. 센티널이 아닌 접두사 없는 키는--agent가 제공되면 해당 에이전트 범위로 지정됩니다. 예를 들어--agent ops --session-key incident-42는agent:ops:incident-42로 라우팅됩니다.--agent가 없으면 센티널이 아닌 접두사 없는 키는 구성된 기본 에이전트 범위로 지정됩니다. 리터럴global과unknown은--agent가 제공되지 않은 경우에만 범위가 지정되지 않은 상태로 유지되며, 내장 폴백 경로에서는 이러한 센티널 세션을 구성된 기본 에이전트로 해석합니다.--reply-channel과--reply-account는 전달에만 영향을 줍니다.- 사고 및 상세 출력 플래그는 세션 저장소에 유지됩니다.
- 출력: 기본적으로 일반 텍스트를 사용하며, 구조화된 페이로드와 메타데이터를 출력하려면
--json을 사용합니다. --json --deliver를 함께 사용하면 JSON에 전송됨, 억제됨, 부분 전송 및 실패한 전송의 전달 상태가 포함됩니다. JSON 전달 상태를 참조하세요.
예시
# JSON 출력이 포함된 간단한 턴openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # 모델 재정의가 포함된 턴openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # 사고 수준이 포함된 턴openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # 파일에서 여러 줄 프롬프트 읽기openclaw agent --agent ops --message-file ./task.md # 정확한 세션 키openclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # 에이전트 범위로 지정된 레거시 키openclaw agent --agent ops --session-key incident-42 --message "Summarize status" # 세션과 다른 채널로 전달openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"관련 항목
Was this useful?
