📋 OpenClaw CLI 命令大全

🔧 核心命令

openclaw setup              # 初始化配置和工作空间
openclaw onboard            # 交互式入门引导
openclaw configure          # 交互式配置向导
openclaw config             # 非交互式配置助手
openclaw completion         # Shell 自动补全设置
openclaw doctor             # 健康检查 + 快速修复
openclaw dashboard          # 打开控制面板
openclaw backup             # 备份/恢复操作
openclaw reset              # 重置本地配置/状态
openclaw uninstall          # 卸载网关服务和数据
openclaw update             # 更新 OpenClaw 安装
openclaw docs               # 搜索文档
openclaw tui                # 打开终端界面

📡 网关管理

openclaw gateway                    # 前台运行网关
openclaw gateway run                # 运行网关（别名）
openclaw gateway status             # 检查网关服务状态
openclaw gateway health             # RPC 健康检查
openclaw gateway probe              # 探测所有可达网关
openclaw gateway discover           # 通过 Bonjour 发现网关
openclaw gateway install            # 安装为系统服务
openclaw gateway uninstall          # 移除系统服务
openclaw gateway start              # 启动网关服务
openclaw gateway stop               # 停止网关服务
openclaw gateway restart            # 重启网关服务
openclaw gateway call <method>      # 底层 RPC 调用

💬 消息与渠道

openclaw message send               # 发送消息
openclaw message broadcast          # 广播到多个目标
openclaw message poll               # 创建投票
openclaw message react              # 添加/移除表情回应
openclaw message reactions          # 列出消息的表情回应
openclaw message read               # 读取渠道消息
openclaw message edit               # 编辑消息
openclaw message delete             # 删除消息
openclaw message pin                # 置顶消息
openclaw message unpin              # 取消置顶
openclaw message pins               # 列出置顶消息
openclaw message thread create      # 创建主题帖
openclaw message thread list        # 列出主题帖
openclaw message thread reply       # 回复主题帖
openclaw message emoji list         # 列出表情
openclaw message emoji upload       # 上传表情
openclaw message sticker send       # 发送贴纸
openclaw message sticker upload     # 上传贴纸
openclaw message role info          # 获取角色信息 (Discord)
openclaw message role add           # 给用户添加角色
openclaw message role remove        # 移除用户角色
openclaw message channel info       # 获取渠道信息
openclaw message channel list       # 列出渠道
openclaw message member info        # 获取成员信息
openclaw message voice status       # 获取语音状态 (Discord)
openclaw message event list         # 列出活动 (Discord)
openclaw message event create       # 创建活动 (Discord)
openclaw message timeout            # 禁言用户 (Discord)
openclaw message kick               # 踢出用户 (Discord)
openclaw message ban                # 封禁用户 (Discord)
openclaw message search             # 搜索消息 (Discord)
openclaw message permissions        # 获取权限 (Discord)

openclaw channels list              # 列出已配置的渠道
openclaw channels status            # 检查渠道健康状态
openclaw channels logs              # 查看渠道日志
openclaw channels add               # 添加渠道账号
openclaw channels remove            # 移除渠道账号
openclaw channels login             # 交互式登录 (WhatsApp)
openclaw channels logout            # 登出渠道

🤖 Agent 管理

openclaw agent                      # 运行一次 agent 回合
openclaw agents list                # 列出已配置的 agent
openclaw agents add                 # 添加新 agent
openclaw agents delete              # 删除 agent
openclaw agents bindings            # 列出路由绑定
openclaw agents bind                # 添加路由绑定
openclaw agents unbind              # 移除路由绑定
openclaw acp                        # 运行 ACP 桥接（IDE 连接）

📊 状态与监控

openclaw status                     # 显示会话健康状态
openclaw health                     # 获取网关健康状态
openclaw sessions                   # 列出对话会话
openclaw logs                       # 追踪网关日志
openclaw system event               #  enqueue 系统事件
openclaw system heartbeat           # 心跳控制
openclaw system presence            # 列出在线状态

🧠 模型与认证

openclaw models                     # models status 的别名
openclaw models list                # 列出可用模型
openclaw models status              # 显示模型/认证状态
openclaw models set                 # 设置默认模型
openclaw models set-image           # 设置默认图像模型
openclaw models aliases             # 管理模型别名
openclaw models fallbacks           # 管理模型降级
openclaw models image-fallbacks     # 管理图像降级
openclaw models scan                # 扫描可用模型
openclaw models auth add            # 交互式添加认证
openclaw models auth setup-token    # 设置令牌认证
openclaw models auth paste-token    # 手动粘贴令牌
openclaw models auth order          # 管理认证配置顺序

🔌 插件与技能

openclaw plugins list               # 列出已安装插件
openclaw plugins inspect            # 检查插件详情
openclaw plugins install            # 安装插件
openclaw plugins uninstall          # 卸载插件
openclaw plugins enable             # 启用插件
openclaw plugins disable            # 禁用插件
openclaw plugins update             # 更新插件
openclaw plugins doctor             # 诊断插件错误
openclaw plugins marketplace list   # 列出市场插件

openclaw skills list                # 列出可用技能
openclaw skills info                # 显示技能详情
openclaw skills check               # 检查技能就绪状态
openclaw skills search              # 搜索 ClawHub 技能
openclaw skills install             # 从 ClawHub 安装技能
openclaw skills update              # 更新追踪的技能

🗄️ 配置与密钥

openclaw config get                 # 获取配置值
openclaw config set                 # 设置配置值
openclaw config unset               # 移除配置值
openclaw config file                # 打印配置文件路径
openclaw config validate            # 验证配置架构

openclaw secrets reload             # 重新加载密钥快照
openclaw secrets audit              # 审计明文残留
openclaw secrets configure          # 交互式密钥设置
openclaw secrets apply              # 应用密钥计划

🗂️ 记忆与目录

openclaw memory status              # 显示索引统计
openclaw memory index               # 重新索引记忆文件
openclaw memory search              # 语义搜索记忆
openclaw directory                  # 管理目录缓存

📱 节点与设备

openclaw nodes status               # 节点连接状态
openclaw nodes describe             # 描述节点
openclaw nodes list                 # 列出已配对节点
openclaw nodes pending              # 列出待处理请求
openclaw nodes approve              # 批准节点请求
openclaw nodes reject               # 拒绝节点请求
openclaw nodes rename               # 重命名节点
openclaw nodes invoke               # 在节点上调用命令
openclaw nodes run                  # 在节点上运行命令
openclaw nodes notify               # 发送通知 (macOS)

openclaw nodes camera list          # 列出摄像头
openclaw nodes camera snap          # 拍照
openclaw nodes camera clip          # 录制视频片段

openclaw nodes canvas snapshot      # 捕获画布
openclaw nodes canvas present       # 展示画布
openclaw nodes canvas hide          # 隐藏画布
openclaw nodes canvas navigate      # 导航画布
openclaw nodes canvas eval          # 在画布上执行 JS
openclaw nodes canvas a2ui push     # 推送 A2UI
openclaw nodes canvas a2ui reset    # 重置 A2UI

openclaw nodes screen record        # 录屏
openclaw nodes location get         # 获取位置

openclaw devices list               # 列出设备配对
openclaw devices approve            # 批准设备请求
openclaw devices reject             # 拒绝设备请求
openclaw devices remove             # 移除设备
openclaw devices clear              # 清除所有设备
openclaw devices rotate             # 轮换设备令牌
openclaw devices revoke             # 撤销设备令牌

🌐 浏览器控制

openclaw browser status             # 浏览器状态
openclaw browser start              # 启动浏览器
openclaw browser stop               # 停止浏览器
openclaw browser reset-profile      # 重置浏览器配置
openclaw browser tabs               # 列出标签页
openclaw browser open               # 打开 URL
openclaw browser focus              # 聚焦标签页
openclaw browser close              # 关闭标签页
openclaw browser profiles           # 列出配置
openclaw browser create-profile     # 创建配置
openclaw browser delete-profile     # 删除配置
openclaw browser screenshot         # 截图
openclaw browser snapshot           # 获取页面快照
openclaw browser navigate           # 导航到 URL
openclaw browser resize             # 调整窗口大小
openclaw browser click              # 点击元素
openclaw browser type               # 输入文本
openclaw browser press              # 按键
openclaw browser hover              # 悬停元素
openclaw browser drag               # 拖拽元素
openclaw browser select             # 选择选项
openclaw browser upload             # 上传文件
openclaw browser fill               # 填写表单
openclaw browser dialog             # 处理对话框
openclaw browser wait               # 等待条件
openclaw browser evaluate           # 执行 JavaScript
openclaw browser console            # 查看控制台日志
openclaw browser pdf                # 保存为 PDF

⏰ 定时任务

openclaw cron status                #  cron 调度器状态
openclaw cron list                  # 列出任务
openclaw cron add                   # 创建任务
openclaw cron edit                  # 编辑任务
openclaw cron rm                    # 删除任务
openclaw cron enable                # 启用任务
openclaw cron disable               # 禁用任务
openclaw cron runs                  # 获取运行历史
openclaw cron run                   # 立即触发任务

🔐 安全与审批

openclaw security audit             # 安全审计
openclaw approvals get              # 获取审批设置
openclaw approvals set              # 设置审批设置
openclaw approvals allowlist        # 管理白名单
openclaw sandbox list               # 列出沙盒
openclaw sandbox recreate           # 重建沙盒
openclaw sandbox explain            # 解释沙盒策略

🔗 配对与二维码

openclaw pairing list               # 列出配对请求
openclaw pairing approve            # 批准配对
openclaw qr                         # 显示二维码
openclaw clawbot qr                 # 旧版二维码命令

🎣 钩子与 Webhook

openclaw hooks list                 # 列出钩子
openclaw hooks info                 # 显示钩子详情
openclaw hooks check                # 检查钩子
openclaw hooks enable               # 启用钩子
openclaw hooks disable              # 禁用钩子
openclaw hooks install              # 安装钩子
openclaw hooks update               # 更新钩子

openclaw webhooks gmail setup       # 设置 Gmail webhook
openclaw webhooks gmail run         # 运行 Gmail webhook

🌍 DNS 与网络

openclaw dns setup                  # 设置发现 DNS

🛠️ 守护进程 (旧版)

openclaw daemon status              # 旧版守护进程状态
openclaw daemon install             # 旧版守护进程安装
openclaw daemon uninstall           # 旧版守护进程卸载
openclaw daemon start               # 旧版守护进程启动
openclaw daemon stop                # 旧版守护进程停止
openclaw daemon restart             # 旧版守护进程重启

📞 语音 (插件)

openclaw voicecall status           # 语音通话状态 (如已安装)

🎯 全局标志

--dev                    # 隔离状态到 ~/.openclaw-dev
--profile <name>         # 隔离状态到 ~/.openclaw-<name>
--no-color               # 禁用 ANSI 颜色
--update                 # openclaw update 的简写
-V, --version, -v        # 打印版本并退出
--json                   # 机器可读的 JSON 输出
--dry-run                # 预览而不应用更改
--verbose                # 详细输出
--timeout <ms>           # 命令超时时间