CLI 命令参考
本文档描述当前 CLI 的行为。如果命令发生变化，请更新此文档。
命令列表
setup- 初始化配置和工作区onboard- 交互式设置向导configure- 交互式配置向导config- 非交互式配置助手doctor- 健康检查和快速修复dashboard- 打开本地控制面板reset- 重置本地配置和状态uninstall- 卸载网关服务和本地数据update- 更新 OpenClawmessage- 统一出站消息和通道操作agent- 通过网关运行单个智能体回合agents- 管理隔离的智能体acp- ACP 桥接器（连接 IDE 到网关）status- 显示链接会话状态和健康信息health- 获取网关健康状态sessions- 列出存储的对话会话gateway- 运行 WebSocket 网关logs- 查看网关日志system- 系统事件和心跳控制models- 模型提供商管理memory- 记忆向量搜索nodes- 管理配对的节点devices- 设备管理node- 独立节点主机管理approvals- 管理执行批准sandbox- 沙箱管理tui- 终端 UIbrowser- 浏览器控制cron- 计划任务管理dns- DNS 设置docs- 搜索文档hooks- Hook 管理webhooks- Webhook 管理pairing- 批准配对请求plugins- 插件管理channels- 管理聊天通道security- 安全审计skills- 技能管理voicecall- 语音通话（插件）
全局选项
--dev：在~/.openclaw-dev下隔离状态并转移默认端口--profile <name>：在~/.openclaw-<name>下隔离状态--no-color：禁用 ANSI 颜色--update：速记命令，相当于openclaw update（仅限源码安装）-V、--version、-v：打印版本并退出
输出样式
- ANSI 颜色和进度指示器仅在 TTY 会话中渲染
- OSC-8 超链接在支持的终端中渲染为可点击链接，否则回退为纯文本 URL
--json（以及支持处的--plain）禁用样式以获得干净的输出--no-color禁用 ANSI 样式；也尊重NO_COLOR=1- 长时间运行的命令显示进度指示器（OSC 9;4，当支持时）
颜色调色板
OpenClaw 使用"龙虾"调色板进行 CLI 输出：
| 颜色 | 值 | 用途 |
|---|---|---|
accent | #FF5A2D | 标题、标签、主要高亮 |
accentBright | #FF7A3D | 命令名称、强调 |
accentDim | #D14A22 | 次要高亮文本 |
info | #FF8A5B | 信息值 |
success | #2FBF71 | 成功状态 |
warn | #FFB020 | 警告、回退、注意事项 |
error | #E23D2D | 错误、失败 |
muted | #8B7F77 | 弱化、元数据 |
调色板源码：src/terminal/palette.ts（又称"龙虾接缝"）
命令树
openclaw [--dev] [--profile <name>] <command>
setup
onboard
configure
config
get
set
unset
doctor
security
audit
reset
uninstall
update
channels
list
status
logs
add
remove
login
logout
skills
list
info
check
plugins
list
info
install
enable
disable
doctor
memory
status
index
search
message
agent
agents
list
add
delete
acp
status
health
sessions
gateway
call
health
status
probe
discover
install
uninstall
start
stop
restart
run
logs
system
event
heartbeat last|enable|disable
presence
models
list
status
set
set-image
aliases list|add|remove
fallbacks list|add|remove|clear
image-fallbacks list|add|remove|clear
scan
auth add|setup-token|paste-token
auth order get|set|clear
sandbox
list
recreate
explain
cron
status
list
add
edit
rm
enable
disable
runs
run
nodes
devices
node
run
status
install
uninstall
start
stop
restart
approvals
get
set
allowlist add|remove
browser
status
start
stop
reset-profile
tabs
open
focus
close
profiles
create-profile
delete-profile
screenshot
snapshot
navigate
resize
click
type
press
hover
drag
select
upload
fill
dialog
wait
evaluate
console
pdf
hooks
list
info
check
enable
disable
install
update
webhooks
gmail setup|run
pairing
list
approve
docs
dns
setup
tui注意：插件可以添加额外的顶层命令（例如 openclaw voicecall）。
安全
openclaw security audit- 审核配置和本地状态中的常见安全问题openclaw security audit --deep- 最佳效果需要网关实时探测openclaw security audit --fix- 收紧安全默认值并修改状态/配置的权限
插件
管理扩展及其配置：
openclaw plugins list- 发现插件（使用--json获取机器可读输出）openclaw plugins info <id>- 显示插件详情openclaw plugins install <path|.tgz|npm-spec>- 安装插件（或将插件路径添加到plugins.load.paths）openclaw plugins enable <id>/disable <id>- 切换plugins.entries.<id>.enabledopenclaw plugins doctor- 报告插件加载错误
大多数插件更改需要重启网关。
记忆
对 MEMORY.md 和 memory/*.md 进行向量搜索：
openclaw memory status- 显示索引统计openclaw memory index- 重新索引记忆文件openclaw memory search "<query>"- 对记忆进行语义搜索
聊天斜杠命令
聊天消息支持 /... 命令（文本和原生）。详见斜杠命令。
关键命令：
/status- 快速诊断/config- 持久化配置更改/debug- 运行时配置覆盖（仅内存，非磁盘；需要commands.debug: true）