openclaw agent는 인바운드 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 기반 워크플로, 테스트, 프로그래밍 방식 전달에 사용하세요.
빠른 시작
플래그
| 플래그 | 설명 |
|---|---|
--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 전달 상태를 참고하세요.
예시
관련 항목
Agent CLI 참조
전체
openclaw agent 플래그 및 옵션 참조입니다.하위 에이전트
백그라운드 하위 에이전트 생성입니다.
세션
세션 키가 작동하는 방식과
--to, --agent, --session-id가 이를 해석하는 방식입니다.슬래시 명령
에이전트 세션 안에서 사용되는 네이티브 명령 카탈로그입니다.