메인 콘텐츠로 건너뛰기

​
Agent Send

openclaw agent는 수신 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 기반 워크플로, 테스트, 프로그래밍 방식 전달에 사용하세요.

​
빠른 시작

1

간단한 에이전트 턴 실행

openclaw agent --message "What is the weather today?"
이 명령은 메시지를 Gateway를 통해 전송하고 응답을 출력합니다.
2

특정 에이전트 또는 세션 대상으로 실행

# 특정 에이전트 대상으로 실행
openclaw agent --agent ops --message "Summarize logs"

# 전화번호 대상으로 실행(세션 키를 파생)
openclaw agent --to +15555550123 --message "Status update"

# 기존 세션 재사용
openclaw agent --session-id abc123 --message "Continue the task"
3

응답을 채널에 전달

# WhatsApp으로 전달(기본 채널)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Slack으로 전달
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​
플래그

Flag설명
--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\>thinking 수준 설정(off, minimal, low, medium, high, xhigh)
--verbose \<on|full|off\>verbose 수준 설정
--timeout \<seconds\>에이전트 타임아웃 재정의
--json구조화된 JSON 출력

​
동작

  • 기본적으로 CLI는 Gateway를 통해 실행됩니다. 현재 머신에서 임베디드 런타임을 강제로 사용하려면 --local을 추가하세요.
  • Gateway에 연결할 수 없으면 CLI는 로컬 임베디드 실행으로 폴백합니다.
  • 세션 선택: --to는 세션 키를 파생합니다(그룹/채널 대상은 격리를 유지하고, 직접 채팅은 main으로 합쳐집니다).
  • thinking 및 verbose 플래그는 세션 저장소에 유지됩니다.
  • 출력: 기본적으로 일반 텍스트이며, 구조화된 payload + 메타데이터가 필요하면 --json을 사용하세요.

​
예시

# JSON 출력이 포함된 간단한 턴
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# thinking 수준을 지정한 턴
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# 세션과 다른 채널로 전달
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
관련 문서