命令参考

这里列出了所有 openclaw 命令及其作用说明。带有 * 的命令有子命令，运行 openclaw <command> --help 查看详细帮助。

全局选项

选项	说明
--dev	开发模式：状态隔离在 ~/.openclaw-dev，默认网关端口 19001
-h, --help	显示帮助信息
--log-level <level>	覆盖全局日志级别（silent|fatal|error|warn|info|debug|trace）
--no-color	禁用 ANSI 颜色输出
--profile <name>	使用命名配置文件，状态隔离在 ~/.openclaw-<name>
-V, --version	输出版本号

命令列表

命令	说明
acp *	Agent Control Protocol 工具，用于外部控制代理
agent	通过 Gateway 运行一次 Agent 会话
agents *	管理隔离的 Agent（工作空间、认证、路由）
approvals *	管理执行批准（网关或节点主机）
backup *	创建和验证 OpenClaw 状态的本地备份归档
browser *	管理 OpenClaw 专用浏览器（Chrome/Chromium）
channels *	管理已连接的聊天通道（Telegram、Discord 等）
clawbot *	遗留的 clawbot 命令别名
completion	生成 Shell 自动补全脚本
config *	非交互式配置助手（get/set/unset/file/validate），默认启动设置向导
configure	交互式设置向导，用于凭证、通道、网关和默认 Agent 配置
cron *	通过 Gateway 调度器管理定时任务
daemon *	Gateway 服务（遗留别名，使用 gateway 代替）
dashboard	使用当前令牌打开控制面板 UI
devices *	设备配对和令牌管理
directory *	查找支持通道的联系人和群组 ID
dns *	DNS 助手，用于广域网发现（Tailscale + CoreDNS）
docs	搜索在线 OpenClaw 文档
doctor	健康检查，快速修复网关和通道问题
gateway *	运行、检查和查询 WebSocket 网关
health	从运行中的网关获取健康状态
help	显示命令帮助
hooks *	管理内部 Agent 钩子
logs	通过 RPC 跟踪网关日志
memory *	搜索和重建索引记忆文件
message *	发送、读取和管理消息
models *	发现、扫描和配置模型
node *	运行和管理无头节点主机服务
nodes *	管理网关拥有的节点配对和节点命令
onboard	交互式导览向导，用于网关、工作空间和技能
pairing *	安全的双向配对（批准入站请求）
plugins *	管理 OpenClaw 插件和扩展
qr	生成 iOS 配对二维码/设置码
reset	重置本地配置/状态（保留 CLI 安装）
sandbox *	管理沙盒容器实现 Agent 隔离
secrets *	密钥运行时重新加载控制
security *	安全工具和本地配置审计
sessions *	列出存储的对话会话
setup	初始化本地配置和 Agent 工作空间
skills *	列出和检查可用技能
status	显示通道健康和最近会话接收者
system *	系统事件、心跳和在线状态
tui	打开连接到网关的终端 UI
uninstall	卸载网关服务和本地数据（保留 CLI）
update *	更新 OpenClaw 并检查更新通道状态
webhooks *	Webhook 助手和集成

使用示例

# 查看 models 命令的详细帮助
openclaw models --help

# 登录个人 WhatsApp Web 并显示二维码和连接日志
openclaw channels login --verbose

# 通过网络会话发送消息并打印 JSON 结果
openclaw message send --target +15555550123 --message "Hi" --json

# 在本地运行 WebSocket 网关
openclaw gateway --port 18789

# 运行开发模式网关（隔离状态/配置）
openclaw --dev gateway

# 强制启动网关：杀死占用默认端口的进程
openclaw gateway --force

更多文档

完整的最新文档请参考：https://docs.openclaw.ai/cli