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.