Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw agent는 인바운드 채팅 메시지 없이 명령줄에서 단일 에이전트 턴을 실행합니다. 스크립트 워크플로, 테스트, 프로그래밍 방식 전달에 사용하세요.
빠른 시작
플래그
| 플래그 | 설명 |
|---|---|
--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\> | 선택한 모델 프로필의 사고 수준 설정 |
--verbose \<on|full|off\> | 상세 출력 수준 설정 |
--timeout \<seconds\> | 에이전트 제한 시간 재정의 |
--json | 구조화된 JSON 출력 |
동작
- 기본적으로 CLI는 Gateway를 통해 실행됩니다. 현재 머신에서 임베디드 런타임을 강제로 사용하려면
--local을 추가하세요. - Gateway에 연결할 수 없으면 CLI는 로컬 임베디드 실행으로 대체합니다.
- 세션 선택:
--to는 세션 키를 파생합니다(그룹/채널 대상은 격리를 유지하고, 직접 채팅은main으로 합쳐집니다). - 사고 및 상세 출력 플래그는 세션 저장소에 유지됩니다.
- 출력: 기본값은 일반 텍스트이며, 구조화된 페이로드와 메타데이터에는
--json을 사용합니다. --json --deliver를 사용하면 JSON에 전송됨, 억제됨, 부분 전송, 전송 실패에 대한 전달 상태가 포함됩니다. JSON 전달 상태를 참조하세요.
예제
관련 항목
에이전트 CLI 참조
전체
openclaw agent 플래그 및 옵션 참조입니다.하위 에이전트
백그라운드 하위 에이전트 생성입니다.
세션
세션 키가 작동하는 방식과
--to, --agent, --session-id가 이를 해석하는 방식입니다.슬래시 명령
에이전트 세션 내에서 사용되는 네이티브 명령 카탈로그입니다.