Skip to content

#Lampiran A: Lembar Cheat Perintah

OpenClaw menyediakan banyak alat baris perintah. Lampiran ini mengatur semua perintah yang umum digunakan berdasarkan dokumentasi resmi.

Sumber referensi: OpenClaw CLI Reference


Opsi global ​

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

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

Instalasi dan pembaruan ​

Instal OpenClaw ​

bash
# 通过 npm 安装(推荐)
npm install -g openclaw@latest

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

Perbarui OpenClaw ​

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

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

# 查看当前版本
openclaw --version

Copot pemasangan OpenClaw ​

bash
# 卸载网关服务和本地数据(CLI 保留)
openclaw uninstall

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

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

Inisialisasi dan konfigurasi ​

Wisaya Inisialisasi ​

bash
# 交互式设置向导(推荐)
openclaw onboard

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

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

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

Panduan Konfigurasi ​

bash
# 交互式配置向导
openclaw configure

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

Buka konsol ​

bash
# 启动 Web Dashboard
openclaw dashboard

Manajemen Gerbang ​

Gateway adalah layanan inti OpenClaw dan berjalan pada ws://127.0.0.1:18789 secara default.

Mulai gerbang ​

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

Manajemen layanan gerbang ​

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

Pemeriksaan kesehatan gerbang ​

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

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

Manajemen Agen ​

Daftar semua Agen ​

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

Tambahkan Agen ​

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

Manajemen pengikatan ​

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

Hapus Agen ​

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

Jalankan Agen ​

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

Manajemen Keterampilan ​

Daftar keterampilan ​

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

Lihat detail keterampilan ​

bash
openclaw skills info <name>

Periksa status keterampilan ​

bash
openclaw skills check

Tip: Gunakan npx clawhub untuk mencari, menginstal dan menyinkronkan keterampilan.


Manajemen pengaya ​

Daftar plugin ​

bash
openclaw plugins list
openclaw plugins list --json

Lihat detail pengaya ​

bash
openclaw plugins info <id>

Pasang plugin ​

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

Mengaktifkan/menonaktifkan plugin ​

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

Diagnostik plugin ​

bash
openclaw plugins doctor

Manajemen memori ​

Melihat status memori ​

bash
openclaw memory status

Indeks memori ​

bash
openclaw memory index

Cari memori ​

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

Manajemen Perangkat ​

Daftar perangkat ​

bash
openclaw devices list
openclaw devices list --json

Perangkat Persetujuan ​

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

Tolak perangkat ​

bash
openclaw devices reject <requestId>

Hapus perangkat ​

bash
openclaw devices remove <deviceId>

Hapus perangkat ​

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

Manajemen penyandingan ​

Daftar permintaan penyandingan ​

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

Setujui pemasangan ​

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

Manajemen Saluran ​

Daftar saluran ​

bash
openclaw channels list
openclaw channels list --json

Periksa status saluran ​

bash
openclaw channels status
openclaw channels status --probe

Lihat log saluran ​

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

Tambahkan saluran ​

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

Hapus saluran ​

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

Masuk/Keluar ​

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

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

Pengiriman pesan ​

Kirim pesan ​

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

Kirim suara ​

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

Operasi pesan lainnya ​

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

Manajemen model ​

Daftar model ​

bash
openclaw models list
openclaw models status

Siapkan modelnya ​

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

Model alias ​

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

Pengembalian model ​

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

Sertifikasi Model ​

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

Operasi konfigurasi ​

Dapatkan konfigurasi ​

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

Atur konfigurasi ​

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

Hapus konfigurasi ​

bash
openclaw config unset <path>

Jalur file konfigurasi ​

bash
openclaw config file

Verifikasi konfigurasi ​

bash
openclaw config validate
openclaw config validate --json

Manajemen Sistem ​

Peristiwa sistem ​

bash
openclaw system event

Manajemen detak jantung ​

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

Status daring ​

bash
openclaw system presence

Manajemen keamanan ​

Audit Keamanan ​

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

Manajemen kunci ​

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

Manajemen sesi ​

Daftar sesi ​

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

Periksa status ​

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

Manajemen peramban ​

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>

Tugas terjadwal ​

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>

Alias perintah pintasan ​

Untuk meningkatkan efisiensi, Anda dapat menyetel alias untuk perintah yang umum digunakan:

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'

Memecahkan masalah pemeriksaan cepat ​

MasalahPerintah DiagnostikSolusi
Gerbang tidak dapat dimulaiopenclaw doctorPeriksa okupansi port dan lihat log
Dasbor tidak dapat diaksesopenclaw gateway statusKonfirmasikan bahwa gateway sedang berjalan dan periksa firewall
Sambungan saluran gagalopenclaw channels status --probePeriksa konfigurasi saluran dan otentikasi
Koneksi model gagalopenclaw models statusVerifikasi kunci API dan konfigurasi model
Penyandingan perangkat gagalopenclaw devices listSetujui perangkat yang tertunda
Verifikasi konfigurasi gagalopenclaw config validatePerbaiki konfigurasi sesuai dengan prompt kesalahan

Bantuan lebih lanjut ​

bash
# 查看全局帮助
openclaw --help

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

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

Tips: Lembar contekan ini didasarkan pada dokumentasi resmi OpenClaw. Disarankan untuk mengunjungi docs.openclaw.ai untuk informasi terbaru.