装完 OpenClaw 不等于会用！

高频命令手册，看这一篇就够了

很多人装完 OpenClaw，只会 openclaw start。一旦出问题两眼一抹黑，不知道该敲什么。

今天就把日常最常用的命令讲清楚，配合真实使用场景，看完就知道平时该敲哪些。

一、先学会”看状态”

这是日常使用频率最高的三个命令，90%的问题先从这里开始排查。

1. openclaw status

看当前运行状态

适用场景：

• 不确定服务有没有启动
• 模型加载成功没有
• 当前会话是否正常

这是你登录后第一个应该跑的命令，输出会告诉你服务是否在线、模型是否就绪。

2. openclaw health

检查运行环境

适用场景：

• 刚装完系统
• 模型无法调用
• 通道连接失败

它会检查依赖是否齐全、环境变量是否正常，比自己一个个对省事得多。

3. openclaw doctor –deep

深度体检

适用场景：

• 端口冲突
• 权限问题
• 依赖异常
• 服务器部署完成后至少跑一次

深度扫描，不放过任何隐患。部署到生产环境前必跑，给自己留个底。

二、服务管理（最常用）

OpenClaw 本质是一个 Gateway 服务，四个字：启、停、重、查。

openclaw gateway start      # 启动openclaw gateway stop       # 停止openclaw gateway restart    # 重启openclaw gateway status     # 状态

常见操作流程：

• 改完配置 → gateway restart
• 服务异常 → 先 gateway status 确认状态
• 端口被占用 → gateway stop 后再排查

生产服务器建议

如果跑在服务器上，推荐安装后台守护进程：

openclaw onboard --install-daemon

开机自动运行，不怕重启，服务更稳定。

三、通道管理（做 Bot 必会）

接入 Telegram、Slack、飞书等平台时，这几个命令必须掌握：

openclaw channels add      # 添加通道openclaw channels login   # 扫码/Token登录openclaw channels list    # 查看已接入通道openclaw channels status --probe   # 检测通道在线状态

标准使用流程：

channels add   → 填写 Token 或扫码channels list  → 看是否成功接入status --probe → 确认通道在线

通道出问题的头号原因：

• Token 失效了
• 权限不够
• 网络不通（服务器访问国外平台）

遇到断连，先跑一遍 status --probe 定位问题。

四、模型相关命令

openclaw models list       # 列出可用模型openclaw models status    # 查看模型状态openclaw models auth setup-token   # 配置 API Key

常见问题处理：

• 模型调用失败？→ 先跑 models status
• 没配置 API Key？→ 用 auth setup-token 引导配置
• 聊天中想换模型？→ 直接敲 /model 模型名

五、日志排查（非常重要）

日志是排查问题的第一手资料，学会看日志就等于学会了一半排障。

openclaw logs           # 查看日志openclaw logs --follow  # 实时跟踪日志输出

推荐日常用法：

openclaw logs --follow

实时看输出，模型超时、插件报错、通道断连，基本都靠这个定位。

排查思路：

1. 先 logs --follow 观察错误输出
2. 根据错误关键词定位问题模块
3. 针对性处理

六、技能与插件管理

openclaw skills list           # 列出已装技能openclaw skills info <name>    # 查看技能详情openclaw plugins list          # 列出插件openclaw plugins install <pkg> # 安装插件openclaw plugins enable <pkg>  # 启用插件

重要提醒：

• 装完插件一定要 enable，否则不会生效
• 出问题时可以先 disable 插件测试
• 不要一次装太多，逐一排查更高效

七、记忆管理

openclaw memory search "关键词"   # 搜索历史记忆openclaw memory index            # 重建索引

用途：

• 查找历史对话中提到的内容
• 记忆出现异常时，index 可以重建索引修复

八、聊天窗口里的隐藏命令

除了 CLI，在聊天窗口里也能直接输入：

/new              # 重开一个会话/stop             # 停止正在生成的长回复/model xxx        # 切换到指定模型

这三个在日常对话中非常高频，尤其是 /new，用来切断混乱的会话上下文非常好用。

总结：真正高频的命令清单

日常 90% 的问题，用这几条就够了：

记住这 8 条，90% 的问题你自己就能解决。

如果你正在用 OpenClaw 做自动化或 Bot，这套命令就是你的日常工具箱。

有问题欢迎留言区交流，更多 OpenClaw 实战技巧持续更新中。