CLI 명령어 참조
기준일: 2026-07-26
난이도: 중급
공식 기준: CLI reference, Config, Doctor, Tasks
OpenClaw CLI는 빠르게 확장되고 있습니다. 이 페이지는 공식 CLI에 현재 등록된 핵심 명령만 다루며, 전체 하위 옵션은 실행 중인 버전의 --help와 공식 command page에서 확인합니다. 가이드 반영 버전: 2026.7.1-2.
핵심 개념
| 목적 | 대표 명령 | 공식 문서 |
|---|---|---|
| 첫 설정 | setup, onboard, configure |
Setup과 onboarding |
| 설정 조회·변경 | config |
Config |
| Gateway 운영 | gateway, status, health, logs |
Gateway |
| 진단·복구 | doctor, security, secrets |
Doctor |
| 채널 | channels, pairing |
Channels |
| 모델·추론 | models, infer, promos |
Models, infer |
| 자동화 원장 | tasks, cron, hooks |
Tasks, Cron |
| 코딩 에이전트 연동 | attach, acp, mcp |
Attach |
| Skills | skills |
Skills |
| 메모리·wiki | memory, wiki |
Memory, Wiki |
| 상태 보존 | backup, update, uninstall, migrate |
Backup |
선택 기준
- 처음 설치했다면
openclaw onboard로 Gateway, model auth, workspace, channels, skills, health를 함께 설정합니다. - 기존 설치의 일부만 바꿀 때는
openclaw configure --section <name>을 사용합니다. - 자동화에서 설정을 검사할 때는
openclaw config validate --json과 읽기 전용openclaw doctor --lint --json을 사용합니다. - 복구 명령을 실행하기 전
openclaw backup create --verify로 검증된 백업을 만듭니다.
실습
1. 현재 버전과 첫 설정
openclaw --help
openclaw onboard
openclaw dashboard
baseline config와 workspace만 만들려면 전체 onboarding 대신 다음 명령을 사용합니다.
openclaw setup --baseline
2. 설정 확인과 안전한 변경
openclaw config file
openclaw config schema
openclaw config unset --help
openclaw config get agents.defaults.model --json
openclaw config set gateway.mode local --dry-run
openclaw config set gateway.mode local
openclaw config validate --json
현재 Config 공식 문서는 get, set, patch, unset, file, schema, validate 흐름을 설명합니다. 설치된 버전의 command tree와 openclaw config --help를 최종 기준으로 사용합니다.
3. Gateway와 진단
openclaw gateway status
openclaw gateway probe
openclaw status --all
openclaw doctor --lint
openclaw logs --follow
openclaw logs는 --limit, --max-bytes, --follow, --json, --plain, --utc 등을 지원합니다. 필터가 필요하면 문서에 없는 옵션을 추측하지 말고 JSON lines 출력을 별도 도구로 처리합니다.
4. 채널 상태
openclaw channels list --all
openclaw channels status --probe
openclaw channels capabilities --channel discord --target channel:123
openclaw pairing list
채널 socket 상태는 sessions 목록이 아니라 channels status --probe로 확인합니다.
5. 모델과 인증
openclaw models list
openclaw models status
openclaw models auth list --provider openai
openclaw models auth login --provider openai --set-default
openclaw models auth setup-token --provider anthropic
openclaw models set <provider/model>
provider 인증을 추가하는 것과 기본 모델을 바꾸는 것은 별도 작업입니다. 기본 모델 변경 의도가 있을 때만 --set-default 또는 models set을 사용합니다.
6. Skills
openclaw skills search "calendar"
openclaw skills install @owner/<slug>
openclaw skills verify @owner/<slug>
openclaw skills list --eligible
openclaw skills check
ClawHub에서 받은 Skill은 설치 전에 출처와 권한을 검토합니다. 공식 CLI는 위험 확인이 필요한 설치에 별도 acknowledge 플래그를 요구할 수 있으므로 강제로 우회하지 않습니다.
7. 백업과 업데이트 전 점검
openclaw backup create --verify
openclaw status --deep
openclaw doctor --post-upgrade --json
기존 archive를 검증할 때는 파일 경로를 전달합니다.
openclaw backup verify ./openclaw-backup.tar.gz
8. Sessions와 live docs
openclaw sessions
openclaw sessions cleanup --dry-run
openclaw docs gateway auth token secretref
openclaw path resolve 'oc://gateway.jsonc/server/port' --human
session cleanup은 dry-run 결과를 먼저 확인합니다. docs와 path는 설치된 command tree에 나타날 때 live 문서 검색과 구조화 파일 탐색에 사용할 수 있습니다.
여러 Gateway는 격리된 profile로 실행할 수 있습니다. 동일 시스템에서 무조건 지원되지 않는다는 설명은 현재 공식 Gateway 문서와 맞지 않습니다.
9. Background tasks와 Task Flow
openclaw tasks list
openclaw tasks audit
openclaw tasks show <task-id>
openclaw tasks cancel <task-id>
openclaw tasks flow list
openclaw tasks flow show <flow-id>
openclaw tasks flow cancel <flow-id>
레거시 openclaw flows ... 는 openclaw tasks flow 로 리다이렉트됩니다. 새 스크립트는 tasks flow를 쓰세요.
10. infer, attach, transcripts, commitments
openclaw infer list
openclaw infer model list
openclaw infer image generate --help
openclaw attach --help
openclaw transcripts list
openclaw transcripts show <id>
openclaw commitments list
openclaw commitments dismiss <id>
infer(alias:capability): provider 백엔드 모델·이미지·오디오·TTS·비디오·웹·임베딩 워크플로attach: Claude Code를 선택된 Gateway 세션에 임시 MCP grant로 연결 (세션 종료 시 회수)transcripts: 저장된 대화 transcript 조회·exportcommitments: 대화에서 추론된 follow-up 정리
11. 선택 플러그인·고급 표면
설치된 플러그인/버전에 따라 나타날 수 있습니다. 없으면 --help에 없다고 보고 문서만 따르세요.
openclaw wiki status
openclaw workboard list
openclaw policy --help
openclaw fleet --help
openclaw promos list
도구에 입력할 프롬프트
내 OpenClaw 설치를 변경하지 말고 읽기 전용으로 진단해줘.
openclaw config validate --json,
openclaw doctor --lint --json,
openclaw status --all,
openclaw channels status --probe 결과를 비교하고
문제, 공식 복구 명령, 변경 전 백업 절차를 순서대로 제시해줘.
체크리스트
- 실행 중인 버전의
openclaw --help를 확인했다. - 설정 파일을 추측하지 않고
openclaw config file로 찾았다. - 변경 전에
--dry-run과config validate를 사용했다. - 진단은
doctor --lint로 먼저 수행했다. - 채널 상태는
channels status --probe로 확인했다. - update·repair 전에 검증된 백업을 만들었다.
다음 단계
- Configuration 참조에서 live schema 기반 설정 방법을 봅니다.
- Gateway 운영에서 서비스와 원격 Gateway를 관리합니다.
- 디버깅에서 읽기 전용 진단 순서를 연습합니다.