OpenClaw 最常用的 20 条命令速查表

别再只会 openclaw onboard 了，这 20 条才是日常真正常用的

很多人装完 OpenClaw 之后，会有一种错觉：

好像已经会了。 能跑起来了。 也能聊天了。

但真到自己开始接飞书、配机器人、调 Agent、装 skill、查日志、做定时任务时，才会发现：

自己会的，其实只有一条命令。

这就像你买了一台功能很强的设备，最后只拿来开关机。 OpenClaw 也是一样。真正决定你能不能把它用成生产力工具的，不是“知道它很强”，而是你手里到底有没有一套常用命令清单。

所以这篇不讲概念，直接给你一份：

OpenClaw 最常用的 20 条命令速查表。

你不用一次全背下来。 但建议你至少先把这篇收藏起来。因为等你开始正式接入飞书、做内容流、做自动化、做多 Agent 协作时，十有八九会回来翻。

一、安装与初始化：先把底座搭起来

1. openclaw onboard

openclaw onboard

这是新手第一条命令。 它的作用不是“随便初始化一下”，而是带你把 OpenClaw 的基础环境跑通，包括 workspace、gateway、channel、skill 等关键配置。

你如果是第一次装，先别急着研究复杂功能。 先把这条跑通，后面的坑会少很多。

2. openclaw onboard--install-daemon

openclaw onboard --install-daemon

如果你不只是想“临时玩一下”，而是想让 OpenClaw 更稳定地常驻运行，这条更实用。

它适合这类场景：

• 想把 OpenClaw 当长期助手用
• 想接飞书、Telegram 之类持续在线的入口
• 不想每次重启后都重新折腾

3. openclaw configure

openclaw configure

这是交互式配置入口。 你后面改模型、改通道、改网关、改 skill，很多时候都会用到它。

它适合“人来改配置”。 也就是说，当你还没把配置结构记熟时，用它最稳。

4. openclaw config file

openclaw config file

这条命令非常朴素，但很有用。

很多人折腾半天，最后连自己改的是哪个配置文件都没搞清楚。 这条就是直接告诉你：当前实际生效的配置文件路径在哪。

适合这些情况：

• 你怀疑自己改错文件了
• 你在多环境之间切换
• 你要手动打开配置文件排查问题

5. openclaw config validate

openclaw config validate

配置有没有写错，不要靠猜。

这条命令就是专门做配置校验的。 尤其适合你在以下时候跑一下：

• 改过配置文件后
• 新加过 channel / account / skill 后
• 启动异常但又看不出问题时

二、配置读写：别盲改，先查再改

6. openclaw configget<path>

openclaw config get channels.feishu

这条是查某个配置项当前值。 它最大的价值，是帮你判断：

你以为改成功了，到底是不是真的改成功了。

比如你配了飞书账号、模型、workspace，结果行为不对，这时候不要直接瞎怀疑，先 get 看看当前实际值。

7. openclaw configset<path><value>

openclaw config set agents.defaults.workspace /home/user/.openclaw/workspace

这是直接设置配置项。 适合熟手，或者你想写成脚本自动化配置的时候。

它的优点是精确。 缺点也很明显：输错路径就会很尴尬。

所以建议搭配上一条一起用：

先 get，再 set。

8. openclaw config unset<path>

openclaw config unset channels.feishu.accounts.default

有些问题不是“要改”，而是“要删掉错误配置”。 比如旧配置残留、重复项冲突、迁移后遗留脏值，这时候 unset 就很有用了。

很多莫名其妙的问题，最后都不是新配置不对，而是旧配置没清掉。

三、系统健康检查：出问题先别慌，先查体征

9. openclaw doctor

openclaw doctor

这是 OpenClaw 里非常建议养成习惯的一条命令。

只要出现下面这些情况，都值得先跑一次：

• 升级过版本
• 配置改完后行为不对
• 通道突然失灵
• 机器人昨天还正常，今天不正常
• 你说不清哪里坏了，但就是觉得不对劲

它本质上像“系统体检”。

10. openclaw logs--follow

openclaw logs --follow

这条一定要熟。

因为很多问题在表面上都长得一样： “机器人没回消息。” 但本质可能完全不同：

• token 失效
• app_id 不匹配
• gateway 没起来
• 配置读错
• 回调地址有问题
• 插件初始化失败

这些问题，不看日志基本靠蒙。

所以别一遇到问题就问“为什么没回复”。 先开日志，看它到底报了什么。

11. openclaw logs--limit200

openclaw logs --limit 200

如果你不是想持续跟踪，而是想快速回看最近发生了什么，这条更方便。

适合：

• 看最近一次报错
• 回溯刚才那次失败调用
• 复制最近日志给别人排查

12. openclaw update

openclaw update

升级 OpenClaw 的常用命令。

但注意，升级不是跑完就结束。 更稳的习惯是：

openclaw update
openclaw doctor

因为很多版本升级之后，真正关键的是：

• 配置有没有迁移好
• 老路径有没有失效
• 服务有没有跟上新版本

四、网关管理：OpenClaw 活没活，看这组就行

13. openclaw gateway status

openclaw gateway status

这条就是问一句：

Gateway 现在到底是不是活着。

当你遇到下面这些情况时，先查它：

• 发消息没反应
• Agent 调用失败
• 插件好像没加载
• cron 没触发
• 通道明明接好了却没响应

很多时候，根源只是 gateway 没正常工作。

14. openclaw gateway restart

openclaw gateway restart

改过配置、装过插件、更新过版本之后，这条经常要用到。

它的意义很简单：

别指望改完配置系统自己瞬间领会。很多改动就是要重启 gateway 才会真正生效。

15. openclaw gateway stop

openclaw gateway stop

这条平时不一定高频，但该用的时候也很明确：

• 你要彻底停掉当前实例
• 你怀疑有残留进程
• 你准备重新拉起一套干净状态

五、日常调用：真正让 OpenClaw 开始干活

16. openclaw agent--message"..."

openclaw agent --message "帮我整理今天的内容选题"

这是非常核心的一条。

它不是简单“发消息”，而是直接触发一次 Agent 执行。 也就是：让 OpenClaw 真正开始做任务。

它特别适合：

• 先在本地测试 Agent 能力
• 不想经过聊天通道，直接调用
• 调试提示词、workflow、交付效果

17. openclaw agent--message"..."--thinking high

openclaw agent --message "帮我写一版公众号提纲"--thinking high

当任务更复杂时，可以提高思考强度。

比如：

• 写作提纲
• 结构化整理
• 方案设计
• 多步骤任务拆解

这时候加上 --thinking high 往往更稳。

18. openclaw message send--target<目标>--message"..."

openclaw message send --target +8613812345678--message "测试消息"

这条偏“消息动作”，不是“任务执行”。

也就是说，它更像：

我要把一条消息发到某个通道/某个目标。

适合：

• 主动发通知
• 验证通道是否打通
• 做消息投递测试

要注意的是，很多旧资料里可能会写成 --to，但你实际使用时，往往要看当前版本支持的参数格式，不要机械照抄旧教程。

六、技能与插件：能力不是天生的，是一点点装出来的

19. openclaw skills list

openclaw skills list

这条用来看当前有哪些 skill。 当你开始装第三方 skill、接工作流、想做更复杂的任务时，这条会越来越常用。

它能帮你快速判断：

• 这个环境里到底装了哪些 skill
• 你以为有的 skill，实际上有没有加载进来
• 当前可用能力边界到哪里

20. openclaw skills check

openclaw skills check

如果 skills list 是看“有什么”， 那 skills check 更像是看“能不能跑”。

这条尤其适合：

• skill 装完没生效
• 依赖可能缺失
• 权限或环境可能没准备好
• 你怀疑是 readiness 问题

很多 skill 失败，不是提示词差，而是环境没准备好。

七、如果你已经进阶了，这几条也会越来越常用

虽然前面那 20 条已经够你日常用了，但如果你开始往“正式生产环境”走，下面这几组命令也会越来越重要。

openclaw agents list

适合多 Agent 管理。 当你开始做 writer、researcher、commander、reviewer 这种角色分工时，这条会有用。

openclaw plugins list

适合检查当前已安装插件。 尤其是你自己扩展过功能之后。

openclaw cron list

适合查看定时任务。 比如日报、周报、早报、定时提醒、定时触发 Agent。

openclaw cron add

适合真正把 OpenClaw 从“响应式助手”变成“主动式助手”。

也就是说，它不再只是你喊一句它动一下， 而是到点自己跑。

八、给新手的建议：不要一口气学完，要先掌握这 8 条

如果你现在觉得 20 条还是有点多，那就先只记这 8 条：

openclaw onboard
openclaw configure
openclaw config validate
openclaw doctor
openclaw gateway status
openclaw gateway restart
openclaw logs --follow
openclaw agent --message "..."

这 8 条已经能覆盖最核心的四件事：

• 搭环境
• 改配置
• 查状态
• 真正调用

先把这 8 条用熟，你已经能超过大多数“只会装，不会养；只会聊，不会调”的使用者了。

九、最后一句：会几条命令，不重要；能不能串成流程，才重要

很多人学 OpenClaw，容易掉进一个误区：

把命令当成知识点来背。

但真正有用的，不是你会背多少命令， 而是你有没有把这些命令串成自己的工作流程。

比如一个最简单的实战路径，其实就是：

• 用 onboard 搭起来
• 用 configure 改配置
• 用 gateway status 看服务
• 用 logs--follow 查异常
• 用 agent--message 测任务
• 用 skills check 查能力
• 再往后用 cron 做自动化

这时候，OpenClaw 才不是一个“你偶尔打开问两句”的 AI 工具。 它才开始变成一个真正能接入你工作流的系统。

而这，才是命令行真正的价值。

参考文献 / 资料来源

[1] OpenClaw Docs. CLI Reference[EB/OL]. https://docs.openclaw.ai/cli, 2026-03-24.