에이전트 전송

​

빠른 시작

openclaw agent --agent main --message "What is the weather today?"

openclaw agent --agent ops --message-file ./task.md

# 특정 에이전트 지정
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"

​

플래그

​

동작

• 기본적으로 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"

​

관련 항목