⏱️ 预计 5 分钟
🟢 入门
📋 前置：配置深入
🎯 学完这一课，你将能够：
- ✓ 掌握日常最常用的 OpenClaw 命令
- ✓ 知道遇到问题时该用什么命令排查
- ✓ 学会查看日志和状态
学习目标
把日常最常用的 OpenClaw 命令整理成一份速查表，随时翻阅，遇到问题时知道该按哪个”按钮”。
概念解释
CLI 命令就像小龙虾的”遥控器按钮”。你不需要记住遥控器上所有按钮的功能——大多数人日常只用音量、换台和开关机。OpenClaw 的命令也是一样，记住最常用的几个就够了。遇到问题时，回来查这份速查表，按对应的按钮就行。
动手做
下面按用途分类，列出你最常用的命令。建议收藏这个页面，忘了命令随时回来查。
基础命令
| 命令 | 作用 | 什么时候用 |
|---|---|---|
openclaw --version | 查看版本号 | 确认安装是否成功、排查兼容性问题时 |
openclaw doctor | 全面诊断 | 装好后跑一次，确认一切正常；遇到问题时也先跑它 |
openclaw dashboard | 打开浏览器控制台 | 想打开聊天界面时用 |
Gateway（网关）管理
Gateway 是小龙虾的”前台”，所有消息都要经过它转发。
| 命令 | 作用 | 什么时候用 |
|---|---|---|
openclaw gateway status | 查看网关状态 | 确认网关是否在运行 |
openclaw gateway --port 18789 | 前台启动网关 | 调试时用，能看到实时日志输出 |
openclaw health | 健康检查 | 快速检查系统是否正常 |
小贴士： 正常使用时网关会自动后台运行，一般不需要手动启动。只有调试或排查问题时才需要手动操作。
模型管理
| 命令 | 作用 |
|---|---|
openclaw models list | 列出所有可用模型 |
openclaw models status | 查看当前模型状态 |
openclaw models set deepseek/deepseek-chat | 切换到指定模型 |
openclaw models auth add | 添加新的 API Key |
小贴士： 切换模型后，新的对话会使用新模型。如果切换后没有生效，试试重启网关。
渠道管理
渠道是小龙虾跟你”聊天”的不同入口，比如网页、Telegram、Discord 等。
| 命令 | 作用 |
|---|---|
openclaw channels list | 列出所有渠道 |
openclaw channels status | 查看各渠道连接状态 |
添加渠道： 目前添加新渠道最可靠的方式是手动编辑配置文件（详见第 8 课和第 11 课），或者运行
openclaw configure --section channels使用交互式向导。
Skills 管理
| 命令 | 作用 |
|---|---|
openclaw skills list | 列出已安装的 Skills |
openclaw skills search "搜索关键词" | 搜索可用的 Skills |
openclaw skills install <名称> | 安装新 Skill |
openclaw skills update --all | 更新所有 Skills |
openclaw skills check | 检查 Skill 是否就绪 |
配置管理
| 命令 | 作用 |
|---|---|
openclaw configure | 交互式配置向导 |
openclaw config get <路径> | 查看某个配置值 |
openclaw config set <路径> <值> | 修改某个配置值 |
openclaw config validate | 验证配置是否正确 |
小贴士： 如果不确定配置路径是什么，先运行
openclaw configure，交互式向导会引导你一步步设置。
排错命令（遇到问题时用）
这一组命令是”急救箱”，出了问题先跑这几个。
| 命令 | 作用 |
|---|---|
openclaw logs --follow | 实时查看日志（按 Ctrl+C 退出） |
openclaw doctor | 全面诊断，告诉你哪里有问题 |
openclaw health | 快速健康检查 |
openclaw status | 查看系统总状态 |
排错的标准流程：
- 先跑
openclaw doctor——它会告诉你大部分问题出在哪 - 如果 doctor 没有明确提示，用
openclaw logs --follow看实时日志 - 日志太长看不懂？把报错信息复制给小龙虾，让它帮你分析
聊天中的快捷命令
在浏览器聊天界面或各渠道（如 Telegram）里，你可以直接输入这些命令：
| 命令 | 作用 |
|---|---|
/model | 查看/切换当前模型 |
/new | 开始新对话（清空上下文） |
/reset | 重置当前会话 |
/status | 查看当前状态 |
/compact | 压缩对话历史（对话太长时用，避免超出上下文限制） |
小贴士： 这些命令是在聊天窗口里输入的，不是在终端里。终端里要输入完整的
openclaw ...命令。
检查你的成果
完成这一课后，你应该能够：
- 运行
openclaw doctor看到全部通过（或知道哪里有问题） - 能用
openclaw logs --follow看到实时日志 - 收藏了这个页面，以后忘了命令就来查
- 知道排错时先跑
openclaw doctor，再看openclaw logs
挑战任务
运行 openclaw models list，看看你的 OpenClaw 支持哪些模型。然后试着用 openclaw models set 切换到一个你没用过的模型，开始一段新对话，感受不同模型的回答风格差异。