Hello Claw: OpenClaw 입문

#부록 A: 명령 요약본

OpenClaw는 다양한 명령줄 도구를 제공합니다. 이 부록은 공식 문서를 기반으로 일반적으로 사용되는 모든 명령을 정리합니다.

참고자료 : OpenClaw CLI Reference

빠른 탐색

安装与更新
初始化与配置
网关管理
Agent 管理
技能管理
记忆管理
设备管理
诊断与调试
配置操作
消息发送
模型管理
系统管理

글로벌 옵션

bash

openclaw [--dev] [--profile <name>] <command>

--dev              # 隔离状态到 ~/.openclaw-dev，并偏移默认端口
--profile <name>   # 隔离状态到 ~/.openclaw-<name>
--no-color         # 禁用 ANSI 颜色
--update           # 简写为 openclaw update（仅源码安装）
-V, --version, -v  # 打印版本并退出

설치 및 업데이트

OpenClaw 설치

bash

# 通过 npm 安装（推荐）
npm install -g openclaw@latest

# 或通过 pnpm
pnpm add -g openclaw@latest

OpenClaw 업데이트

bash

# 检查并更新到最新版本
openclaw update

# 切换到特定频道
openclaw update --channel stable|beta|dev

# 查看当前版本
openclaw --version

OpenClaw 제거

bash

# 卸载网关服务和本地数据（CLI 保留）
openclaw uninstall

# 指定范围卸载
openclaw uninstall --service --state --workspace --app --all

# 重置配置和状态（保留 CLI）
openclaw reset
openclaw reset --scope config+creds+sessions --yes

초기화 및 구성

초기화 마법사

bash

# 交互式设置向导（推荐）
openclaw onboard

# 初始化并安装守护进程
openclaw onboard --install-daemon

# 非交互式模式
openclaw onboard --non-interactive --mode local

# 重置后重新初始化
openclaw onboard --reset

구성 마법사

bash

# 交互式配置向导
openclaw configure

# 验证配置
openclaw doctor
openclaw doctor --fix          # 自动修复
openclaw doctor --deep         # 深度扫描

콘솔을 엽니다

bash

# 启动 Web Dashboard
openclaw dashboard

게이트웨이 관리

Gateway는 OpenClaw의 핵심 서비스로 기본적으로 ws://127.0.0.1:18789에서 실행됩니다.

게이트웨이 시작

bash

# 前台运行（调试模式）
openclaw gateway --port 18789 --verbose

# 指定绑定地址
openclaw gateway --bind loopback|lan|tailnet|auto|custom

# 使用 Token 认证
openclaw gateway --auth token --token <token>

# 使用密码认证
openclaw gateway --auth password --password <password>

# Tailscale 集成
openclaw gateway --tailscale serve|funnel

# 开发模式
openclaw gateway --dev

게이트웨이 서비스 관리

bash

# 查看网关服务状态
openclaw gateway status

# 安装为系统服务
openclaw gateway install

# 卸载服务
openclaw gateway uninstall

# 启动/停止/重启服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 查看日志
openclaw logs
openclaw logs --limit 100

게이트웨이 상태 점검

bash

# 获取网关健康状态
openclaw health
openclaw health --json
openclaw health --verbose

# 网关调用（RPC）
openclaw gateway call <method> --params '<json>'

에이전트 관리

모든 에이전트 나열

bash

openclaw agents list
openclaw agents list --json
openclaw agents list --bindings

에이전트 추가

bash

# 交互式添加
openclaw agents add

# 指定名称添加
openclaw agents add [name]

# 非交互式添加
openclaw agents add my-agent \
  --workspace ~/.openclaw/workspace-my-agent \
  --model anthropic/claude-sonnet-4-5 \
  --bind whatsapp:personal \
  --non-interactive

바인딩 관리

bash

# 查看绑定
openclaw agents bindings
openclaw agents bindings --agent <id>

# 添加绑定
openclaw agents bind --agent <id> --bind <channel[:accountId]>

# 移除绑定
openclaw agents unbind --agent <id> --bind <channel[:accountId]>
openclaw agents unbind --agent <id> --all

에이전트 삭제

bash

openclaw agents delete <id>
openclaw agents delete <id> --force

에이전트 실행

bash

# 单次对话
openclaw agent --message "Hello" --to <dest>

# 指定会话
openclaw agent --message "Hello" --session-id <id>

# 指定思考级别
openclaw agent --message "Hello" --thinking high

# 本地模式（不通过网关）
openclaw agent --message "Hello" --local

# 指定渠道回复
openclaw agent --message "Hello" --channel whatsapp --deliver

스킬 관리

스킬 나열

bash

openclaw skills list
openclaw skills list --eligible    # 仅显示就绪技能
openclaw skills list --json
openclaw skills list -v            # 显示缺失需求详情

스킬 상세보기

bash

openclaw skills info <name>

스킬 상태 확인

bash

openclaw skills check

팁: npx clawhub을 사용하여 스킬을 검색하고 설치하고 동기화하세요.

플러그인 관리

플러그인 목록

bash

openclaw plugins list
openclaw plugins list --json

플러그인 세부정보 보기

bash

openclaw plugins info <id>

플러그인 설치

bash

openclaw plugins install <path|.tgz|npm-spec>

플러그인 활성화/비활성화

bash

openclaw plugins enable <id>
openclaw plugins disable <id>

플러그인 진단

bash

openclaw plugins doctor

메모리 관리

메모리 상태 보기

bash

openclaw memory status

인덱스 메모리

bash

openclaw memory index

메모리 검색

bash

openclaw memory search "<query>"
openclaw memory search --query "<query>"

장치 관리

장치 나열

bash

openclaw devices list
openclaw devices list --json

승인 장치

bash

openclaw devices approve [requestId]
openclaw devices approve --latest

장치 거부

bash

openclaw devices reject <requestId>

장치 제거

bash

openclaw devices remove <deviceId>

기기 지우기

bash

openclaw devices clear --yes
openclaw devices clear --yes --pending

페어링 관리

페어링 요청 나열

bash

openclaw pairing list
openclaw pairing list [channel] --channel <channel> --account <id>

페어링 승인

bash

openclaw pairing approve <channel> <code>
openclaw pairing approve --channel <channel> <code> --notify

채널 관리

채널 나열

bash

openclaw channels list
openclaw channels list --json

채널 상태 확인

bash

openclaw channels status
openclaw channels status --probe

채널 로그 보기

bash

openclaw channels logs
openclaw channels logs --channel <name> --limit 200

채널 추가

bash

# 交互式添加
openclaw channels add

# 非交互式添加 Telegram
openclaw channels add \
  --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# 非交互式添加 Discord
openclaw channels add \
  --channel discord \
  --account work \
  --name "Work Bot" \
  --token $DISCORD_BOT_TOKEN

채널 삭제

bash

openclaw channels remove --channel <channel> --account <id>
openclaw channels remove --channel <channel> --account <id> --delete

로그인/로그아웃

bash

# WhatsApp Web 登录
openclaw channels login
openclaw channels login --channel whatsapp --account <id> --verbose

# 登出
openclaw channels logout
openclaw channels logout --channel <channel> --account <id>

메시지 보내기

bash

openclaw message send --target +15555550123 --message "Hello"

투표 보내기

bash

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza \
  --poll-option Sushi

기타 메시지 작업

bash

openclaw message react
openclaw message reactions
openclaw message read
openclaw message edit
openclaw message delete
openclaw message pin
openclaw message unpin

모델 관리

모델 목록

bash

openclaw models list
openclaw models status

모델 설정

bash

openclaw models set <model>
openclaw models set-image <model>

모델 별칭

bash

openclaw models aliases list
openclaw models aliases add <alias> <model>
openclaw models aliases remove <alias>

모델 롤백

bash

openclaw models fallbacks list
openclaw models fallbacks add <model>
openclaw models fallbacks remove <model>
openclaw models fallbacks clear

모델 인증

bash

openclaw models auth add
openclaw models auth setup-token
openclaw models auth paste-token
openclaw models auth order get|set|clear

구성 작업

구성 가져오기

bash

openclaw config get <path>
openclaw config get agents.defaults.workspace

구성 설정

bash

openclaw config set <path> <value>
openclaw config set agents.defaults.heartbeat.every "2h"

구성 삭제

bash

openclaw config unset <path>

구성 파일 경로

bash

openclaw config file

구성 확인

bash

openclaw config validate
openclaw config validate --json

시스템 관리

시스템 이벤트

bash

openclaw system event

하트비트 관리

bash

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

온라인 상태

bash

openclaw system presence

보안 관리

보안 감사

bash

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

키 관리

bash

openclaw secrets reload
openclaw secrets audit
openclaw secrets configure
openclaw secrets apply --from <plan.json>

세션 관리

세션 나열

bash

openclaw sessions list
openclaw sessions --json
openclaw sessions --verbose

상태 확인

bash

openclaw status
openclaw status --json
openclaw status --deep
openclaw status --usage

브라우저 관리

bash

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser reset-profile
openclaw browser tabs
openclaw browser open <url>
openclaw browser screenshot
openclaw browser navigate <url>

예약된 작업

bash

openclaw cron status
openclaw cron list
openclaw cron add
openclaw cron edit <id>
openclaw cron rm <id>
openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron runs
openclaw cron run <id>

바로가기 명령 별명

효율성을 높이기 위해 일반적으로 사용되는 명령에 대한 별칭을 설정할 수 있습니다.

bash

# 添加到 ~/.bashrc 或 ~/.zshrc
alias oc='openclaw'
alias ocg='openclaw gateway'
alias ocs='openclaw skills'
alias oca='openclaw agents'
alias ocd='openclaw dashboard'
alias ocdr='openclaw doctor'
alias occh='openclaw channels'

# 快速启动别名
alias ocstart='openclaw gateway start && openclaw dashboard'
alias ocstop='openclaw gateway stop'
alias ocrestart='openclaw gateway restart'

문제 해결 빠른 확인

문제	진단 명령	솔루션
게이트웨이를 시작할 수 없습니다	`openclaw doctor`	포트 점유 확인 및 로그 보기
대시보드에 액세스할 수 없습니다	`openclaw gateway status`	게이트웨이가 실행 중인지 확인하고 방화벽을 확인
채널 연결 실패	`openclaw channels status --probe`	채널 구성 및 인증 확인
모델 연결 실패	`openclaw models status`	API 키 및 모델 구성 확인
장치 페어링 실패	`openclaw devices list`	보류 중인 장치 승인
구성 확인 실패	`openclaw config validate`	오류 프롬프트에 따라 구성을 복구합니다

추가 도움말

bash

# 查看全局帮助
openclaw --help

# 查看子命令帮助
openclaw <command> --help

# 查看具体命令帮助
openclaw gateway --help
openclaw channels add --help

팁: 이 치트 시트는 공식 OpenClaw 문서를 기반으로 합니다. 최신 정보를 확인하려면 docs.openclaw.ai을 방문하는 것이 좋습니다.

빠른 탐색 ​

글로벌 옵션 ​

설치 및 업데이트 ​

OpenClaw 설치 ​

OpenClaw 업데이트 ​

OpenClaw 제거 ​

초기화 및 구성 ​

초기화 마법사 ​

구성 마법사 ​

콘솔을 엽니다 ​

게이트웨이 관리 ​

게이트웨이 시작 ​

게이트웨이 서비스 관리 ​

게이트웨이 상태 점검 ​

에이전트 관리 ​

모든 에이전트 나열 ​

에이전트 추가 ​

바인딩 관리 ​

에이전트 삭제 ​

에이전트 실행 ​

스킬 관리 ​

스킬 나열 ​

스킬 상세보기 ​

스킬 상태 확인 ​

플러그인 관리 ​

플러그인 목록 ​

플러그인 세부정보 보기 ​

플러그인 설치 ​

플러그인 활성화/비활성화 ​

플러그인 진단 ​

메모리 관리 ​

메모리 상태 보기 ​

인덱스 메모리 ​

메모리 검색 ​

장치 관리 ​

장치 나열 ​

승인 장치 ​

장치 거부 ​

장치 제거 ​

기기 지우기 ​

페어링 관리 ​

페어링 요청 나열 ​

페어링 승인 ​

채널 관리 ​

채널 나열 ​

채널 상태 확인 ​

채널 로그 보기 ​

채널 추가 ​

채널 삭제 ​

로그인/로그아웃 ​

메시지 보내기 ​

메시지 보내기 ​

투표 보내기 ​

기타 메시지 작업 ​

모델 관리 ​

모델 목록 ​

모델 설정 ​

모델 별칭 ​

모델 롤백 ​

모델 인증 ​

구성 작업 ​

구성 가져오기 ​

구성 설정 ​

구성 삭제 ​

구성 파일 경로 ​

구성 확인 ​

시스템 관리 ​

시스템 이벤트 ​

하트비트 관리 ​

온라인 상태 ​

보안 관리 ​

보안 감사 ​

키 관리 ​

세션 관리 ​

세션 나열 ​

상태 확인 ​

브라우저 관리 ​

예약된 작업 ​

바로가기 명령 별명 ​

문제 해결 빠른 확인 ​

빠른 탐색

글로벌 옵션

설치 및 업데이트

OpenClaw 설치

OpenClaw 업데이트

OpenClaw 제거

초기화 및 구성

초기화 마법사

구성 마법사

콘솔을 엽니다

게이트웨이 관리

게이트웨이 시작

게이트웨이 서비스 관리

게이트웨이 상태 점검

에이전트 관리

모든 에이전트 나열

에이전트 추가

바인딩 관리

에이전트 삭제

에이전트 실행

스킬 관리

스킬 나열

스킬 상세보기

스킬 상태 확인

플러그인 관리

플러그인 목록

플러그인 세부정보 보기

플러그인 설치

플러그인 활성화/비활성화

플러그인 진단

메모리 관리

메모리 상태 보기

인덱스 메모리

메모리 검색

장치 관리

장치 나열

승인 장치

장치 거부

장치 제거

기기 지우기

페어링 관리

페어링 요청 나열

페어링 승인

채널 관리

채널 나열

채널 상태 확인

채널 로그 보기

채널 추가

채널 삭제

로그인/로그아웃

메시지 보내기

메시지 보내기

투표 보내기

기타 메시지 작업

모델 관리

모델 목록

모델 설정

모델 별칭

모델 롤백

모델 인증

구성 작업

구성 가져오기

구성 설정

구성 삭제

구성 파일 경로

구성 확인

시스템 관리

시스템 이벤트

하트비트 관리

온라인 상태

보안 관리

보안 감사

키 관리

세션 관리

세션 나열

상태 확인

브라우저 관리

예약된 작업

바로가기 명령 별명

문제 해결 빠른 확인