文章目录
目录
- 1. 初始化 / 配置 / 诊断
- 2. Gateway / Daemon / 日志
- 3. 渠道 / 飞书 / 配对
- 4. 消息操作
- 5. Agent / Agents / Sessions
- 6. Memory / Models / System
- 7. Cron / Hooks / Plugins / Skills
- 8. Browser / Nodes / Devices / Node / Sandbox / TUI
- 2. Gateway / Daemon / 日志
- 3. 渠道 / 飞书 / 配对
- 4. 消息操作
- 5. Agent / Agents / Sessions
- 6. Memory / Models / System
- 7. Cron / Hooks / Plugins / Skills
- 8. Browser / Nodes / Devices / Node / Sandbox / TUI
- 9. DNS / Docs / Webhooks / Directory / Security / Update
- 10. 你现在最值得先记住的“飞书工作流命令组”
- 11. 一份最实用的排障顺序
下面我把它整理成更适合查阅的 Markdown 表格版命令参考。
我按这几个字段来列：
- 命令
- 子命令
- 常用参数
- 中文备注
- 例子
- 详细用途
这份表是基于你贴出来的 OpenClaw zsh completion 命令树整理的，所以它适合作为一份 CLI 使用速查表。
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw setup | – | –workspace –wizard –non-interactive | 初始化本地 OpenClaw 目录和默认工作区 | openclaw setup –workspace ~/.openclaw/workspace | 创建 ~/.openclaw/openclaw.json 和默认 workspace，适合第一次手动初始化 |
| openclaw onboard | – | –workspace –flow –mode –gateway-port –install-daemon –skip-channels | 首次引导向导 | openclaw onboard –flow quickstart –mode local | 一站式完成网关、模型、工作区、技能、渠道的初始配置 |
| openclaw configure | – | –section | 分区配置向导 | openclaw configure –section gateway –section channels | 只修改某一部分配置，而不是全量重跑 onboarding |
| openclaw config | get | –json | 读取配置项 | openclaw config get channels.feishu.enabled | 按点路径读取配置值 |
| openclaw config | set | –json | 设置配置项 | openclaw config set channels.feishu.enabled true –json | 修改某个配置字段，通常直接写入 openclaw.json |
| openclaw config | unset | – | 删除配置项 | openclaw config unset channels.feishu.allowFrom | 删除某个字段，让配置回退默认行为 |
| openclaw doctor | – | –repair –fix –force –deep | 健康检查与修复 | openclaw doctor –repair | 检查网关、配置、渠道、服务是否异常，并尝试修复 |
| openclaw dashboard | – | –no-open | 打开控制台 | openclaw dashboard | 打开控制 UI，用浏览器查看运行状态 |
| openclaw reset | – | –scope –yes –dry-run | 重置本地状态 | openclaw reset –scope config+creds+sessions –yes | 清空配置、凭据、会话，适合重新初始化 |
| openclaw uninstall | – | –service –state –workspace –all | 卸载 OpenClaw 本地环境 | openclaw uninstall –all –yes | 删除服务、状态、工作区，但 CLI 本体可能仍保留 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw gateway | run | –port –bind –token –auth –verbose –dev | 前台运行 Gateway | openclaw gateway run –port 18789 –verbose | 启动 WebSocket Gateway，负责 sessions、routing、channels |
| openclaw gateway | status | –json –deep –timeout | 查看网关状态 | openclaw gateway status –json | 查看 Gateway 是否运行、是否可探测 |
| openclaw gateway | install | –port –runtime –token | 安装后台服务 | openclaw gateway install –port 18789 | 把 Gateway 安装成 launchd/systemd/schtasks 服务 |
| openclaw gateway | start | –json | 启动后台服务 | openclaw gateway start | 启动已安装的 Gateway 服务 |
| openclaw gateway | stop | –json | 停止后台服务 | openclaw gateway stop | 停止 Gateway 服务 |
| openclaw gateway | restart | –json | 重启后台服务 | openclaw gateway restart | 修改配置后常用来重启服务 |
| openclaw gateway | call | –params –json | 调用 Gateway RPC | openclaw gateway call some.method –params '{"foo":"bar"}' –json | 直接调用内部 RPC，适合调试 |
| openclaw gateway | health | –json | 获取健康信息 | openclaw gateway health –json | 查看运行健康状态 |
| openclaw gateway | probe | –url –token –json | 探测本地/远程 Gateway | openclaw gateway probe –json | 综合检查网关可达性、探测能力 |
| openclaw gateway | discover | –json | 发现 Gateway | openclaw gateway discover –json | 通过 Bonjour 等方式发现可连接网关 |
| openclaw daemon | status | –json | 查看后台服务状态 | openclaw daemon status | 关注系统服务安装/运行情况 |
| openclaw daemon | install | –port –runtime | 安装后台服务 | openclaw daemon install –port 18789 | 与 gateway install 类似，更偏服务管理 |
| openclaw daemon | start | –json | 启动服务 | openclaw daemon start | 启动后台 Gateway |
| openclaw daemon | stop | –json | 停止服务 | openclaw daemon stop | 停止后台 Gateway |
| openclaw daemon | restart | –json | 重启服务 | openclaw daemon restart | 配置更新后重启 |
| openclaw logs | – | –follow –limit –json –plain | 查看日志 | openclaw logs –follow | 实时查看 Gateway 文件日志，是排障核心命令 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw channels | list | –json | 列出已配置渠道 | openclaw channels list –json | 查看 Telegram、Feishu、Slack 等账号是否已配置 |
| openclaw channels | status | –probe –json | 查看渠道状态 | openclaw channels status –probe –json | 检查凭据、连接状态是否正常 |
| openclaw channels | capabilities | –channel –account –json | 查看渠道能力 | openclaw channels capabilities –channel feishu –json | 查看该渠道支持哪些消息能力 |
| openclaw channels | resolve | –channel –account –kind –json | 名称解析为 ID | openclaw channels resolve –channel feishu –kind user "张三" | 把用户/群名称解析成内部目标 ID |
| openclaw channels | logs | –channel –lines –json | 查看渠道日志 | openclaw channels logs –channel feishu –lines 200 | 专门看某个渠道的日志片段 |
| openclaw channels | add | –channel –account –name –token –bot-token –app-token | 添加或更新渠道 | openclaw channels add –channel feishu –account main | 为某渠道写入账号配置，飞书、Telegram、Slack 都走这里 |
| openclaw channels | remove | –channel –account –delete | 移除渠道 | openclaw channels remove –channel feishu –account main –delete | 停用或删除某个渠道账号 |
| openclaw channels | login | –channel –account | 渠道登录 | openclaw channels login –channel whatsapp | 某些渠道需要登录链接 |
| openclaw channels | logout | –channel –account | 渠道登出 | openclaw channels logout –channel whatsapp | 断开登录会话 |
| openclaw pairing | list | –channel –json | 查看待审批配对 | openclaw pairing list –channel feishu –json | 对 dmPolicy=pairing 的渠道，列出待审批用户 |
| openclaw pairing | approve | –channel –notify | 批准配对 | openclaw pairing approve ABC123 –channel feishu –notify | 批准某个飞书用户，让其后续消息进入正常 Agent 链路 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw message | send | –message/-m –target/-t –channel –account –media –reply-to | 发送消息 | openclaw message send -m "hello" -t user_xxx –channel feishu | 向某个渠道目标发送消息 |
| openclaw message | broadcast | –targets –message –channel | 批量广播 | openclaw message broadcast –channel feishu –targets u1,u2 –message "通知" | 向多个目标一次性发消息 |
| openclaw message | poll | –poll-question –poll-option | 发起投票 | openclaw message poll –channel discord –target 123 –poll-question "吃什么" –poll-option 火锅 –poll-option 烧烤 | 某些渠道支持原生投票 |
| openclaw message | read | –target –channel –limit –before –after | 读最近消息 | openclaw message read –channel feishu –target user_xxx –limit 20 | 拉取目标最近消息记录 |
| openclaw message | edit | –message-id –message | 编辑消息 | openclaw message edit –channel discord –message-id 123 –message "修正版" | 修改已发送消息 |
| openclaw message | delete | –message-id | 删除消息 | openclaw message delete –channel discord –message-id 123 | 删除指定消息 |
| openclaw message | react | –message-id –emoji –remove | 添加/移除反应 | openclaw message react –channel slack –message-id 123 –emoji 👍 | 对消息加 emoji reaction |
| openclaw message | reactions | –message-id –limit | 查看反应 | openclaw message reactions –channel slack –message-id 123 | 列出某条消息的反应详情 |
| openclaw message | pin | –message-id | 置顶消息 | openclaw message pin –channel discord –target chan_xxx –message-id 123 | 把消息置顶 |
| openclaw message | unpin | –message-id | 取消置顶 | openclaw message unpin –channel discord –target chan_xxx –message-id 123 | 取消置顶 |
| openclaw message | pins | –limit | 查看置顶列表 | openclaw message pins –channel discord –target chan_xxx | 列出当前频道置顶 |
| openclaw message | search | –query –channel-id –author-id | 搜索消息 | openclaw message search –channel discord –query "error" | 按关键字检索消息 |
| openclaw message | permissions | –target –channel | 查看权限 | openclaw message permissions –channel discord –target channel:123 | 查看机器人在该目标上的权限 |
| openclaw message | thread create | –thread-name –message | 新建线程 | openclaw message thread create –channel discord –target chan_xxx –thread-name "讨论" | 创建讨论线程 |
| openclaw message | thread list | –channel-id –limit | 列线程 | openclaw message thread list –channel discord –channel-id 123 | 查看频道线程 |
| openclaw message | thread reply | –message –reply-to | 在线程中回复 | openclaw message thread reply –channel discord –target thread_xxx –message "收到" | 往线程里发送消息 |
| openclaw message | emoji list | –guild-id | 列表情 | openclaw message emoji list –channel discord –guild-id 123 | 查看服务器表情 |
| openclaw message | emoji upload | –emoji-name –media | 上传表情 | openclaw message emoji upload –channel discord –guild-id 123 –emoji-name ok –media ./ok.png | 上传自定义表情 |
| openclaw message | sticker send | –sticker-id | 发贴纸 | openclaw message sticker send –channel discord –target chan_xxx –sticker-id 123 | 发送贴纸 |
| openclaw message | sticker upload | –sticker-name –media | 上传贴纸 | openclaw message sticker upload –channel discord –guild-id 123 –sticker-name wow –media ./wow.png | 上传贴纸资源 |
| openclaw message | channel info | –target | 频道信息 | openclaw message channel info –channel discord –target chan_xxx | 查看频道详情 |
| openclaw message | channel list | –guild-id | 列频道 | openclaw message channel list –channel discord –guild-id 123 | 列出服务器频道 |
| openclaw message | member info | –user-id –guild-id | 成员信息 | openclaw message member info –channel discord –guild-id 123 –user-id 456 | 查看成员信息 |
| openclaw message | voice status | –guild-id –user-id | 语音状态 | openclaw message voice status –channel discord –guild-id 123 –user-id 456 | 查看某成员语音状态 |
| openclaw message | event list | –guild-id | 列活动 | openclaw message event list –channel discord –guild-id 123 | 查看计划活动 |
| openclaw message | event create | –event-name –start-time | 建活动 | openclaw message event create –channel discord –guild-id 123 –event-name "周会" –start-time 2026-03-12T10:00:00 | 创建活动事件 |
| openclaw message | timeout | –guild-id –user-id –duration-min | 禁言成员 | openclaw message timeout –channel discord –guild-id 123 –user-id 456 –duration-min 10 | 对成员进行超时禁言 |
| openclaw message | kick | –guild-id –user-id | 移出成员 | openclaw message kick –channel discord –guild-id 123 –user-id 456 | 踢出成员 |
| openclaw message | ban | –guild-id –user-id | 封禁成员 | openclaw message ban –channel discord –guild-id 123 –user-id 456 | 封禁成员 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw agent | – | –message/-m –to/-t –agent –channel –deliver –local –thinking –json | 手动跑一轮 agent | openclaw agent -m "hello" –agent main –channel feishu –deliver | 不依赖外部入站消息，直接触发一个 agent turn |
| openclaw agents | list | –json –bindings | 列出 agent | openclaw agents list –bindings –json | 查看有哪些 agent，以及它们的路由绑定 |
| openclaw agents | add | –workspace –model –agent-dir –bind | 新增 agent | openclaw agents add helper –workspace ~/helper-ws –model openai/gpt-4.1 | 新增隔离 agent，可指定独立 workspace |
| openclaw agents | set-identity | –agent –name –theme –emoji –avatar | 设置 agent 身份 | openclaw agents set-identity –agent main –name "Lobster" –emoji "🦞" | 更新 agent 的名称、形象、主题 |
| openclaw agents | delete | –force –json | 删除 agent | openclaw agents delete helper –force | 删除某个 agent 及其状态 |
| openclaw sessions | – | –json –store –active | 查看会话 | openclaw sessions –json –active 60 | 查看最近活跃 session，研究路由和会话落盘很有用 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw memory | status | –agent –json –deep | 查看记忆索引状态 | openclaw memory status –agent main –json | 看 memory 是否已建立索引 |
| openclaw memory | index | –agent –force | 重建记忆索引 | openclaw memory index –agent main –force | 强制重建记忆库索引 |
| openclaw memory | search | –agent –max-results –min-score –json | 搜索记忆 | openclaw memory search "飞书配置" –agent main –json | 在记忆文件中检索相关内容 |
| openclaw models | list | –all –local –provider –json | 列模型 | openclaw models list –provider openai –json | 查看当前模型目录 |
| openclaw models | status | –json –probe –agent | 查看模型状态 | openclaw models status –probe –json | 检查 provider 认证、默认模型、可用性 |
| openclaw models | set | – | 设置默认模型 | openclaw models set openai/gpt-4.1 | 把默认对话模型切换成指定模型 |
| openclaw models | set-image | – | 设置图片模型 | openclaw models set-image openai/gpt-image-1 | 配置默认图像模型 |
| openclaw models | aliases list | –json | 查看别名 | openclaw models aliases list –json | 查看模型别名表 |
| openclaw models | fallbacks list | –json | 查看回退模型 | openclaw models fallbacks list –json | 查看主模型失败时的回退链 |
| openclaw models | scan | –provider –set-default –json | 扫描候选模型 | openclaw models scan –provider openrouter –set-default –json | 自动发现可用模型并设置默认值 |
| openclaw models | auth add | – | 增加认证 | openclaw models auth add | 交互式添加 provider 认证 |
| openclaw models | auth login | –provider –method | 登录 provider | openclaw models auth login –provider google-gemini-cli | 跑 provider 自带登录流程 |
| openclaw models | auth setup-token | –provider | 初始化 token | openclaw models auth setup-token –provider anthropic | 用 CLI 协助建立 token |
| openclaw models | auth paste-token | –provider –profile-id | 粘贴 token | openclaw models auth paste-token –provider openai | 手动把 token 写入认证配置 |
| openclaw system | event | –text –mode –json | 注入系统事件 | openclaw system event –text "重新加载人格" –mode now | 向主 session 注入一条系统事件 |
| openclaw system | heartbeat last | –json | 查看最后心跳 | openclaw system heartbeat last –json | 查看最近一次心跳事件 |
| openclaw system | heartbeat enable | –json | 开启心跳 | openclaw system heartbeat enable | 打开系统心跳机制 |
| openclaw system | heartbeat disable | –json | 关闭心跳 | openclaw system heartbeat disable | 关闭系统心跳 |
| openclaw system | presence | –json | 查看 presence | openclaw system presence –json | 查看系统 presence 条目 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw cron | status | –json | 查看调度器状态 | openclaw cron status –json | 查看 cron 子系统是否运行 |
| openclaw cron | list | –all –json | 列任务 | openclaw cron list –all –json | 查看当前定时任务 |
| openclaw cron | add | –name –message –every –cron –agent –announce | 添加任务 | openclaw cron add –name morning –every 1d –message "早报" –agent main | 周期性触发 agent 或系统事件 |
| openclaw cron | rm | –json | 删除任务 | openclaw cron rm <job-id> | 删除定时任务 |
| openclaw cron | enable | – | 启用任务 | openclaw cron enable <job-id> | 启用某个已禁用任务 |
| openclaw cron | disable | – | 禁用任务 | openclaw cron disable <job-id> | 暂停某个任务 |
| openclaw cron | runs | –id –limit | 查看运行历史 | openclaw cron runs –id <job-id> –limit 20 | 查看任务执行记录 |
| openclaw cron | run | –due | 立即执行 | openclaw cron run –id <job-id> | 手动调试执行某任务 |
| openclaw cron | edit | –name –message –every –enable | 编辑任务 | openclaw cron edit <job-id> –every 2h –enable | 修改任务计划、消息、目标 |
| openclaw hooks | list | –eligible –json –verbose | 列 hooks | openclaw hooks list –verbose | 查看可用和已安装 hooks |
| openclaw hooks | info | –json | hook 详情 | openclaw hooks info my-hook –json | 查看某个 hook 详细信息 |
| openclaw hooks | check | –json | 检查 hook | openclaw hooks check –json | 看是否满足依赖和启用条件 |
| openclaw hooks | enable | – | 启用 hook | openclaw hooks enable my-hook | 让 hook 进入运行状态 |
| openclaw hooks | disable | – | 禁用 hook | openclaw hooks disable my-hook | 停止 hook 生效 |
| openclaw hooks | install | –link | 安装 hook | openclaw hooks install ./my-hook-pack –link | 安装本地 hook 包 |
| openclaw hooks | update | –all –dry-run | 更新 hooks | openclaw hooks update –all | 更新已安装 hooks |
| openclaw plugins | list | –json –enabled –verbose | 列插件 | openclaw plugins list –enabled | 查看插件目录及启用情况 |
| openclaw plugins | info | –json | 插件详情 | openclaw plugins info feishu –json | 查看某插件元信息 |
| openclaw plugins | enable | – | 启用插件 | openclaw plugins enable feishu | 在配置中启用插件 |
| openclaw plugins | disable | – | 禁用插件 | openclaw plugins disable feishu | 在配置中禁用插件 |
| openclaw plugins | install | –link | 安装插件 | openclaw plugins install ./plugin-dir –link | 安装本地或 npm 插件 |
| openclaw plugins | uninstall | –force –dry-run | 卸载插件 | openclaw plugins uninstall feishu –force | 卸载某插件 |
| openclaw plugins | update | –all –dry-run | 更新插件 | openclaw plugins update –all | 更新已安装插件 |
| openclaw plugins | doctor | – | 检查插件问题 | openclaw plugins doctor | 诊断插件加载异常 |
| openclaw skills | list | –json –eligible –verbose | 列技能 | openclaw skills list –eligible | 查看可用 skills |
| openclaw skills | info | –json | 技能详情 | openclaw skills info browser –json | 查看某个 skill 的元信息 |
| openclaw skills | check | –json | 检查技能 | openclaw skills check –json | 看哪些 skills 缺依赖、哪些可直接用 |
这一组命令非常多，我给你列最常用、最有代表性的。
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw browser | status | –json | 浏览器状态 | openclaw browser status –json | 查看 OpenClaw 专用浏览器是否运行 |
| openclaw browser | start | – | 启动浏览器 | openclaw browser start | 启动专用浏览器环境 |
| openclaw browser | stop | – | 停止浏览器 | openclaw browser stop | 停掉浏览器进程 |
| openclaw browser | tabs | – | 列出标签页 | openclaw browser tabs | 查看当前所有打开页面 |
| openclaw browser | open | – | 打开网址 | openclaw browser open https://example.com | 新开一个标签页 |
| openclaw browser | navigate | –target-id | 跳转页面 | openclaw browser navigate https://openai.com | 当前标签页跳转 |
| openclaw browser | screenshot | –full-page –type | 截图 | openclaw browser screenshot –full-page | 获取当前页面截图 |
| openclaw browser | snapshot | –format –limit | 页面结构快照 | openclaw browser snapshot –format ai | 读取页面结构，适合自动化 |
| openclaw browser | click | –target-id | 点击元素 | openclaw browser click REF_12 | 根据快照 ref 点击页面元素 |
| openclaw browser | type | –submit –slowly | 输入文字 | openclaw browser type REF_8 "hello" –submit | 给输入框填内容 |
| openclaw browser | –target-id | 导出 PDF | openclaw browser pdf | 保存页面为 PDF | |
| openclaw browser | console | –level | 控制台日志 | openclaw browser console –level error | 查看页面 JS 错路径读取配置值 |
| openclaw config | set | –json | 设置配置项 | openclaw config set channels.feishu.enabled true –json | 修改某个配置字段，通常直接写入 openclaw.json |
| openclaw config | unset | – | 删除配置项 | openclaw config unset channels.feishu.allowFrom | 删除某个字段，让配置回退默认行为 |
| openclaw doctor | – | –repair –fix –force –deep | 健康检查与修复 | openclaw doctor –repair | 检查网关、配置、渠道、服务是否异常，并尝试修复 |
| openclaw dashboard | – | –no-open | 打开控制台 | openclaw dashboard | 打开控制 UI，用浏览器查看运行状态 |
| openclaw reset | – | –scope –yes –dry-run | 重置本地状态 | openclaw reset –scope config+creds+sessions –yes | 清空配置、凭据、会话，适合重新初始化 |
| openclaw uninstall | – | –service –state –workspace –all | 卸载 OpenClaw 本地环境 | openclaw uninstall –all –yes | 删除服务、状态、工作区，但 CLI 本体可能仍保留 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw gateway | run | –port –bind –token –auth –verbose –dev | 前台运行 Gateway | openclaw gateway run –port 18789 –verbose | 启动 WebSocket Gateway，负责 sessions、routing、channels |
| openclaw gateway | status | –json –deep –timeout | 查看网关状态 | openclaw gateway status –json | 查看 Gateway 是否运行、是否可探测 |
| openclaw gateway | install | –port –runtime –token | 安装后台服务 | openclaw gateway install –port 18789 | 把 Gateway 安装成 launchd/systemd/schtasks 服务 |
| openclaw gateway | start | –json | 启动后台服务 | openclaw gateway start | 启动已安装的 Gateway 服务 |
| openclaw gateway | stop | –json | 停止后台服务 | openclaw gateway stop | 停止 Gateway 服务 |
| openclaw gateway | restart | –json | 重启后台服务 | openclaw gateway restart | 修改配置后常用来重启服务 |
| openclaw gateway | call | –params –json | 调用 Gateway RPC | openclaw gateway call some.method –params '{"foo":"bar"}' –json | 直接调用内部 RPC，适合调试 |
| openclaw gateway | health | –json | 获取健康信息 | openclaw gateway health –json | 查看运行健康状态 |
| openclaw gateway | probe | –url –token –json | 探测本地/远程 Gateway | openclaw gateway probe –json | 综合检查网关可达性、探测能力 |
| openclaw gateway | discover | –json | 发现 Gateway | openclaw gateway discover –json | 通过 Bonjour 等方式发现可连接网关 |
| openclaw daemon | status | –json | 查看后台服务状态 | openclaw daemon status | 关注系统服务安装/运行情况 |
| openclaw daemon | install | –port –runtime | 安装后台服务 | openclaw daemon install –port 18789 | 与 gateway install 类似，更偏服务管理 |
| openclaw daemon | start | –json | 启动服务 | openclaw daemon start | 启动后台 Gateway |
| openclaw daemon | stop | –json | 停止服务 | openclaw daemon stop | 停止后台 Gateway |
| openclaw daemon | restart | –json | 重启服务 | openclaw daemon restart | 配置更新后重启 |
| openclaw logs | – | –follow –limit –json –plain | 查看日志 | openclaw logs –follow | 实时查看 Gateway 文件日志，是排障核心命令 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw channels | list | –json | 列出已配置渠道 | openclaw channels list –json | 查看 Telegram、Feishu、Slack 等账号是否已配置 |
| openclaw channels | status | –probe –json | 查看渠道状态 | openclaw channels status –probe –json | 检查凭据、连接状态是否正常 |
| openclaw channels | capabilities | –channel –account –json | 查看渠道能力 | openclaw channels capabilities –channel feishu –json | 查看该渠道支持哪些消息能力 |
| openclaw channels | resolve | –channel –account –kind –json | 名称解析为 ID | openclaw channels resolve –channel feishu –kind user "张三" | 把用户/群名称解析成内部目标 ID |
| openclaw channels | logs | –channel –lines –json | 查看渠道日志 | openclaw channels logs –channel feishu –lines 200 | 专门看某个渠道的日志片段 |
| openclaw channels | add | –channel –account –name –token –bot-token –app-token | 添加或更新渠道 | openclaw channels add –channel feishu –account main | 为某渠道写入账号配置，飞书、Telegram、Slack 都走这里 |
| openclaw channels | remove | –channel –account –delete | 移除渠道 | openclaw channels remove –channel feishu –account main –delete | 停用或删除某个渠道账号 |
| openclaw channels | login | –channel –account | 渠道登录 | openclaw channels login –channel whatsapp | 某些渠道需要登录链接 |
| openclaw channels | logout | –channel –account | 渠道登出 | openclaw channels logout –channel whatsapp | 断开登录会话 |
| openclaw pairing | list | –channel –json | 查看待审批配对 | openclaw pairing list –channel feishu –json | 对 dmPolicy=pairing 的渠道，列出待审批用户 |
| openclaw pairing | approve | –channel –notify | 批准配对 | openclaw pairing approve ABC123 –channel feishu –notify | 批准某个飞书用户，让其后续消息进入正常 Agent 链路 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw message | send | –message/-m –target/-t –channel –account –media –reply-to | 发送消息 | openclaw message send -m "hello" -t user_xxx –channel feishu | 向某个渠道目标发送消息 |
| openclaw message | broadcast | –targets –message –channel | 批量广播 | openclaw message broadcast –channel feishu –targets u1,u2 –message "通知" | 向多个目标一次性发消息 |
| openclaw message | poll | –poll-question –poll-option | 发起投票 | openclaw message poll –channel discord –target 123 –poll-question "吃什么" –poll-option 火锅 –poll-option 烧烤 | 某些渠道支持原生投票 |
| openclaw message | read | –target –channel –limit –before –after | 读最近消息 | openclaw message read –channel feishu –target user_xxx –limit 20 | 拉取目标最近消息记录 |
| openclaw message | edit | –message-id –message | 编辑消息 | openclaw message edit –channel discord –message-id 123 –message "修正版" | 修改已发送消息 |
| openclaw message | delete | –message-id | 删除消息 | openclaw message delete –channel discord –message-id 123 | 删除指定消息 |
| openclaw message | react | –message-id –emoji –remove | 添加/移除反应 | openclaw message react –channel slack –message-id 123 –emoji 👍 | 对消息加 emoji reaction |
| openclaw message | reactions | –message-id –limit | 查看反应 | openclaw message reactions –channel slack –message-id 123 | 列出某条消息的反应详情 |
| openclaw message | pin | –message-id | 置顶消息 | openclaw message pin –channel discord –target chan_xxx –message-id 123 | 把消息置顶 |
| openclaw message | unpin | –message-id | 取消置顶 | openclaw message unpin –channel discord –target chan_xxx –message-id 123 | 取消置顶 |
| openclaw message | pins | –limit | 查看置顶列表 | openclaw message pins –channel discord –target chan_xxx | 列出当前频道置顶 |
| openclaw message | search | –query –channel-id –author-id | 搜索消息 | openclaw message search –channel discord –query "error" | 按关键字检索消息 |
| openclaw message | permissions | –target –channel | 查看权限 | openclaw message permissions –channel discord –target channel:123 | 查看机器人在该目标上的权限 |
| openclaw message | thread create | –thread-name –message | 新建线程 | openclaw message thread create –channel discord –target chan_xxx –thread-name "讨论" | 创建讨论线程 |
| openclaw message | thread list | –channel-id –limit | 列线程 | openclaw message thread list –channel discord –channel-id 123 | 查看频道线程 |
| openclaw message | thread reply | –message –reply-to | 在线程中回复 | openclaw message thread reply –channel discord –target thread_xxx –message "收到" | 往线程里发送消息 |
| openclaw message | emoji list | –guild-id | 列表情 | openclaw message emoji list –channel discord –guild-id 123 | 查看服务器表情 |
| openclaw message | emoji upload | –emoji-name –media | 上传表情 | openclaw message emoji upload –channel discord –guild-id 123 –emoji-name ok –media ./ok.png | 上传自定义表情 |
| openclaw message | sticker send | –sticker-id | 发贴纸 | openclaw message sticker send –channel discord –target chan_xxx –sticker-id 123 | 发送贴纸 |
| openclaw message | sticker upload | –sticker-name –media | 上传贴纸 | openclaw message sticker upload –channel discord –guild-id 123 –sticker-name wow –media ./wow.png | 上传贴纸资源 |
| openclaw message | channel info | –target | 频道信息 | openclaw message channel info –channel discord –target chan_xxx | 查看频道详情 |
| openclaw message | channel list | –guild-id | 列频道 | openclaw message channel list –channel discord –guild-id 123 | 列出服务器频道 |
| openclaw message | member info | –user-id –guild-id | 成员信息 | openclaw message member info –channel discord –guild-id 123 –user-id 456 | 查看成员信息 |
| openclaw message | voice status | –guild-id –user-id | 语音状态 | openclaw message voice status –channel discord –guild-id 123 –user-id 456 | 查看某成员语音状态 |
| openclaw message | event list | –guild-id | 列活动 | openclaw message event list –channel discord –guild-id 123 | 查看计划活动 |
| openclaw message | event create | –event-name –start-time | 建活动 | openclaw message event create –channel discord –guild-id 123 –event-name "周会" –start-time 2026-03-12T10:00:00 | 创建活动事件 |
| openclaw message | timeout | –guild-id –user-id –duration-min | 禁言成员 | openclaw message timeout –channel discord –guild-id 123 –user-id 456 –duration-min 10 | 对成员进行超时禁言 |
| openclaw message | kick | –guild-id –user-id | 移出成员 | openclaw message kick –channel discord –guild-id 123 –user-id 456 | 踢出成员 |
| openclaw message | ban | –guild-id –user-id | 封禁成员 | openclaw message ban –channel discord –guild-id 123 –user-id 456 | 封禁成员 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw agent | – | –message/-m –to/-t –agent –channel –deliver –local –thinking –json | 手动跑一轮 agent | openclaw agent -m "hello" –agent main –channel feishu –deliver | 不依赖外部入站消息，直接触发一个 agent turn |
| openclaw agents | list | –json –bindings | 列出 agent | openclaw agents list –bindings –json | 查看有哪些 agent，以及它们的路由绑定 |
| openclaw agents | add | –workspace –model –agent-dir –bind | 新增 agent | openclaw agents add helper –workspace ~/helper-ws –model openai/gpt-4.1 | 新增隔离 agent，可指定独立 workspace |
| openclaw agents | set-identity | –agent –name –theme –emoji –avatar | 设置 agent 身份 | openclaw agents set-identity –agent main –name "Lobster" –emoji "🦞" | 更新 agent 的名称、形象、主题 |
| openclaw agents | delete | –force –json | 删除 agent | openclaw agents delete helper –force | 删除某个 agent 及其状态 |
| openclaw sessions | – | –json –store –active | 查看会话 | openclaw sessions –json –active 60 | 查看最近活跃 session，研究路由和会话落盘很有用 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw memory | status | –agent –json –deep | 查看记忆索引状态 | openclaw memory status –agent main –json | 看 memory 是否已建立索引 |
| openclaw memory | index | –agent –force | 重建记忆索引 | openclaw memory index –agent main –force | 强制重建记忆库索引 |
| openclaw memory | search | –agent –max-results –min-score –json | 搜索记忆 | openclaw memory search "飞书配置" –agent main –json | 在记忆文件中检索相关内容 |
| openclaw models | list | –all –local –provider –json | 列模型 | openclaw models list –provider openai –json | 查看当前模型目录 |
| openclaw models | status | –json –probe –agent | 查看模型状态 | openclaw models status –probe –json | 检查 provider 认证、默认模型、可用性 |
| openclaw models | set | – | 设置默认模型 | openclaw models set openai/gpt-4.1 | 把默认对话模型切换成指定模型 |
| openclaw models | set-image | – | 设置图片模型 | openclaw models set-image openai/gpt-image-1 | 配置默认图像模型 |
| openclaw models | aliases list | –json | 查看别名 | openclaw models aliases list –json | 查看模型别名表 |
| openclaw models | fallbacks list | –json | 查看回退模型 | openclaw models fallbacks list –json | 查看主模型失败时的回退链 |
| openclaw models | scan | –provider –set-default –json | 扫描候选模型 | openclaw models scan –provider openrouter –set-default –json | 自动发现可用模型并设置默认值 |
| openclaw models | auth add | – | 增加认证 | openclaw models auth add | 交互式添加 provider 认证 |
| openclaw models | auth login | –provider –method | 登录 provider | openclaw models auth login –provider google-gemini-cli | 跑 provider 自带登录流程 |
| openclaw models | auth setup-token | –provider | 初始化 token | openclaw models auth setup-token –provider anthropic | 用 CLI 协助建立 token |
| openclaw models | auth paste-token | –provider –profile-id | 粘贴 token | openclaw models auth paste-token –provider openai | 手动把 token 写入认证配置 |
| openclaw system | event | –text –mode –json | 注入系统事件 | openclaw system event –text "重新加载人格" –mode now | 向主 session 注入一条系统事件 |
| openclaw system | heartbeat last | –json | 查看最后心跳 | openclaw system heartbeat last –json | 查看最近一次心跳事件 |
| openclaw system | heartbeat enable | –json | 开启心跳 | openclaw system heartbeat enable | 打开系统心跳机制 |
| openclaw system | heartbeat disable | –json | 关闭心跳 | openclaw system heartbeat disable | 关闭系统心跳 |
| openclaw system | presence | –json | 查看 presence | openclaw system presence –json | 查看系统 presence 条目 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw cron | status | –json | 查看调度器状态 | openclaw cron status –json | 查看 cron 子系统是否运行 |
| openclaw cron | list | –all –json | 列任务 | openclaw cron list –all –json | 查看当前定时任务 |
| openclaw cron | add | –name –message –every –cron –agent –announce | 添加任务 | openclaw cron add –name morning –every 1d –message "早报" –agent main | 周期性触发 agent 或系统事件 |
| openclaw cron | rm | –json | 删除任务 | openclaw cron rm <job-id> | 删除定时任务 |
| openclaw cron | enable | – | 启用任务 | openclaw cron enable <job-id> | 启用某个已禁用任务 |
| openclaw cron | disable | – | 禁用任务 | openclaw cron disable <job-id> | 暂停某个任务 |
| openclaw cron | runs | –id –limit | 查看运行历史 | openclaw cron runs –id <job-id> –limit 20 | 查看任务执行记录 |
| openclaw cron | run | –due | 立即执行 | openclaw cron run –id <job-id> | 手动调试执行某任务 |
| openclaw cron | edit | –name –message –every –enable | 编辑任务 | openclaw cron edit <job-id> –every 2h –enable | 修改任务计划、消息、目标 |
| openclaw hooks | list | –eligible –json –verbose | 列 hooks | openclaw hooks list –verbose | 查看可用和已安装 hooks |
| openclaw hooks | info | –json | hook 详情 | openclaw hooks info my-hook –json | 查看某个 hook 详细信息 |
| openclaw hooks | check | –json | 检查 hook | openclaw hooks check –json | 看是否满足依赖和启用条件 |
| openclaw hooks | enable | – | 启用 hook | openclaw hooks enable my-hook | 让 hook 进入运行状态 |
| openclaw hooks | disable | – | 禁用 hook | openclaw hooks disable my-hook | 停止 hook 生效 |
| openclaw hooks | install | –link | 安装 hook | openclaw hooks install ./my-hook-pack –link | 安装本地 hook 包 |
| openclaw hooks | update | –all –dry-run | 更新 hooks | openclaw hooks update –all | 更新已安装 hooks |
| openclaw plugins | list | –json –enabled –verbose | 列插件 | openclaw plugins list –enabled | 查看插件目录及启用情况 |
| openclaw plugins | info | –json | 插件详情 | openclaw plugins info feishu –json | 查看某插件元信息 |
| openclaw plugins | enable | – | 启用插件 | openclaw plugins enable feishu | 在配置中启用插件 |
| openclaw plugins | disable | – | 禁用插件 | openclaw plugins disable feishu | 在配置中禁用插件 |
| openclaw plugins | install | –link | 安装插件 | openclaw plugins install ./plugin-dir –link | 安装本地或 npm 插件 |
| openclaw plugins | uninstall | –force –dry-run | 卸载插件 | openclaw plugins uninstall feishu –force | 卸载某插件 |
| openclaw plugins | update | –all –dry-run | 更新插件 | openclaw plugins update –all | 更新已安装插件 |
| openclaw plugins | doctor | – | 检查插件问题 | openclaw plugins doctor | 诊断插件加载异常 |
| openclaw skills | list | –json –eligible –verbose | 列技能 | openclaw skills list –eligible | 查看可用 skills |
| openclaw skills | info | –json | 技能详情 | openclaw skills info browser –json | 查看某个 skill 的元信息 |
| openclaw skills | check | –json | 检查技能 | openclaw skills check –json | 看哪些 skills 缺依赖、哪些可直接用 |
这一组命令非常多，我给你列最常用、最有代表性的。
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw browser | status | –json | 浏览器状态 | openclaw browser status –json | 查看 OpenClaw 专用浏览器是否运行 |
| openclaw browser | start | – | 启动浏览器 | openclaw browser start | 启动专用浏览器环境 |
| openclaw browser | stop | – | 停止浏览器 | openclaw browser stop | 停掉浏览器进程 |
| openclaw browser | tabs | – | 列出标签页 | openclaw browser tabs | 查看当前所有打开页面 |
| openclaw browser | open | – | 打开网址 | openclaw browser open https://example.com | 新开一个标签页 |
| openclaw browser | navigate | –target-id | 跳转页面 | openclaw browser navigate https://openai.com | 当前标签页跳转 |
| openclaw browser | screenshot | –full-page –type | 截图 | openclaw browser screenshot –full-page | 获取当前页面截图 |
| openclaw browser | snapshot | –format –limit | 页面结构快照 | openclaw browser snapshot –format ai | 读取页面结构，适合自动化 |
| openclaw browser | click | –target-id | 点击元素 | openclaw browser click REF_12 | 根据快照 ref 点击页面元素 |
| openclaw browser | type | –submit –slowly | 输入文字 | openclaw browser type REF_8 "hello" –submit | 给输入框填内容 |
| openclaw browser | –target-id | 导出 PDF | openclaw browser pdf | 保存页面为 PDF | |
| openclaw browser | console | –level | 控制台日志 | openclaw browser console –level error | 查看页面 JS 错误 |
| openclaw nodes | status | –json | 节点状态 | openclaw nodes status –json | 查看已知节点连接情况 |
| openclaw nodes | pending | –json | 待审批节点 | openclaw nodes pending –json | 查看待配对节点 |
| openclaw nodes | approve | –json | 批准节点 | openclaw nodes approve <node-id> | 批准一个新节点接入 |
| openclaw nodes | run | –node –raw –agent | 在节点上执行命令 | openclaw nodes run –node mac-mini –raw "ls -la" | 在远端节点执行 shell 命令 |
| openclaw nodes | notify | –node –title –body | 本地通知 | openclaw nodes notify –node mac-mini –title "提醒" –body "任务完成" | 给节点机器发本地通知 |
| openclaw nodes | canvas snapshot | –node | 画布快照 | openclaw nodes canvas snapshot –node mac-mini | 获取节点上的 canvas 快照 |
| openclaw nodes | camera snap | –node | 拍照 | openclaw nodes camera snap –node iphone | 调用节点摄像头拍照 |
| openclaw nodes | screen record | –node –duration | 录屏 | openclaw nodes screen record –node mac-mini –duration 10s | 远程录屏 |
| openclaw devices | list | –json | 查看设备 | openclaw devices list –json | 查看待配对和已配对设备 |
| openclaw devices | approve | –json | 批准设备 | openclaw devices approve <device-id> | 允许设备接入 |
| openclaw devices | reject | –json | 拒绝设备 | openclaw devices reject <device-id> | 拒绝设备接入 |
| openclaw devices | rotate | –device –role | 轮换 token | openclaw devices rotate –device ipad –role viewer | 更新设备 token |
| openclaw devices | revoke | –device –role | 撤销 token | openclaw devices revoke –device ipad –role viewer | 撤销设备访问权 |
| openclaw node | run | –host –port | 运行 headless node | openclaw node run –host 127.0.0.1 –port 18789 | 启动 headless node host |
| openclaw node | status | –json | 查看 node 状态 | openclaw node status –json | 查看本机 node host 状态 |
| openclaw sandbox | list | –json –browser | 列沙箱 | openclaw sandbox list –json | 查看 agent/browser 的容器沙箱 |
| openclaw sandbox | recreate | –all –agent –session | 重建沙箱 | openclaw sandbox recreate –all –force | 删除旧容器并重建 |
| openclaw sandbox | explain | –session –agent –json | 解释策略 | openclaw sandbox explain –agent main –json | 看当前 session/agent 生效的沙箱与工具策略 |
| openclaw tui | – | –url –token –session –deliver –message | 打开终端 UI | openclaw tui –session main –message "hello" | 在终端里连接 Gateway 进行对话 |
| 命令 | 子命令 | 常用参数 | 中文备注 | 例子 | 详细用途 |
|---|---|---|---|---|---|
| openclaw dns | setup | –domain –apply | 配置 DNS 发现 | openclaw dns setup –domain openclaw.internal –apply | 配置 CoreDNS / 宽域服务发现 |
| openclaw docs | – | – | 搜索官方文档 | openclaw docs | 直接查 OpenClaw 在线文档 |
| openclaw webhooks | gmail setup | –account –project –topic –hook-url | 配置 Gmail webhook | openclaw webhooks gmail setup –account me@gmail.com –project my-gcp-proj | 配置 Gmail Pub/Sub 与 OpenClaw hook |
| openclaw webhooks | gmail run | –account –topic –hook-url | 运行 Gmail watch | openclaw webhooks gmail run –account me@gmail.com –topic projects/x/topics/y | 启动 Gmail 监听与推送循环 |
| openclaw directory | self | –channel –account –json | 查看当前账号 | openclaw directory self –channel feishu –json | 查询机器人/当前账号自身信息 |
| openclaw directory | peers list | –query –limit | 列联系人 | openclaw directory peers list –channel feishu –query 张 –limit 10 | 搜索联系人/同事 |
| openclaw directory | groups list | –query –limit | 列群组 | openclaw directory groups list –channel feishu –query 产品 | 搜索群组 |
| openclaw directory | groups members | –group-id –limit | 列群成员 | openclaw directory groups members –channel feishu –group-id grp_xxx | 查看群成员 |
| openclaw security | audit | –deep –fix –json | 安全审计 | openclaw security audit –deep –json | 审计配置、权限和常见安全风险 |
| openclaw update | wizard | –timeout | 交互式更新 | openclaw update wizard | 通过向导更新 OpenClaw |
| openclaw update | status | –json –timeout | 查看更新状态 | openclaw update status –json | 查看当前版本与更新通道 |
如果你现在的重点是 研究 OpenClaw + 飞书 的运行链路，建议优先记下面这组：
| 命令 | 子命令 | 例子 | 用途 |
|---|---|---|---|
| openclaw gateway | status | openclaw gateway status | 先确认 Gateway 是否活着 |
| openclaw logs | – | openclaw logs –follow | 实时看飞书消息有没有打进来 |
| openclaw channels | list | openclaw channels list –json | 确认飞书渠道已配置 |
| openclaw channels | status | openclaw channels status –probe –json | 检查飞书连接状态 |
| openclaw pairing | list | openclaw pairing list –channel feishu | 看第一次私聊是否进了 pairing |
| openclaw pairing | approve | openclaw pairing approve ABC123 –channel feishu –notify | 批准用户后才会进入正常会话 |
| openclaw sessions | – | openclaw sessions –json | 看有没有生成 session |
| openclaw agent | – | openclaw agent -m "hello" –agent main –channel feishu –deliver | 手工触发一次 agent 运行 |
| openclaw message | send | openclaw message send -m "测试" -t user_xxx –channel feishu | 直接往飞书发消息，排除 agent 问题 |
| openclaw channels | logs | openclaw channels logs –channel feishu –lines 200 | 看飞书插件日志 |
你可以直接按这个顺序排查：
openclaw gateway status openclaw channels list --json openclaw channels status --probe --json openclaw pairing list --channel feishu openclaw sessions --json openclaw logs --follow
这 6 条命令基本能把：
- 网关是否运行
- 飞书是否接通
- 用户是否卡在 pairing
- 是否落到了 session
- 日志里是否报错
全部串起来。
到此这篇关于OpenClaw CLI 命令速查手册(中文注释+示例版)的文章就介绍到这了,更多相关OpenClaw CLI 命令内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！