🧭 指令概览
OpenClaw 的指令分成两层：一层是在终端里运行的 CLI 命令，负责安装、配置、服务管理和插件接入；另一层是在 TUI 或聊天会话里输入的 斜杠命令，负责切换会话状态、切模型、看状态和重置上下文。
openclaw --help、openclaw <command> --help 以及已安装中文文档整理。未来版本如果新增或重命名命令，请以实际帮助输出为准。
终端层命令
常见命令包括 onboard、dashboard、config、gateway、models、plugins、channels 和 doctor。
会话层斜杠指令
常见会话命令包括 /status、/model、/think、/verbose、/new、/reset 和 /abort。
服务与诊断
当网关不通、模型不生效、插件不工作时，优先使用 openclaw gateway status、openclaw status --all、openclaw doctor 做判断。
模型、技能、插件、渠道
models 管模型，skills 看技能，plugins 管扩展，channels 管机器人和聊天入口。这四块基本覆盖“功能接上去”的工作。
openclaw gateway restart，会话级改动通常不需要重启。
🚀 新手四个命令
如果你第一次接触 OpenClaw，不用先背完整命令树。先掌握下面四个命令，已经足够完成安装后大部分操作。
openclaw onboard
首次向导。用来配置网关、工作区、模型认证与技能。安装后的第一步优先运行它。
openclaw dashboard
打开控制台 Web UI。适合图形界面使用者，也适合检查当前配置是否已生效。
openclaw tui
打开终端交互界面。适合键盘流工作，支持直接发送消息和输入斜杠命令。
openclaw gateway status
查看服务状态并探测 RPC 是否可用。配置改完不生效时，先查它。
openclaw gateway restart。
🛠️ CLI 命令地图
下面这一部分聚焦安装后最常用的一组命令。它们覆盖了从初始化到排错的完整链路。
| 命令 | 作用 | 适合什么时候用 | 常见示例 |
|---|---|---|---|
openclaw onboard |
交互式首次向导，设置网关、工作区、技能和认证。 | 刚装完，或者想用向导重走一遍配置时。 | openclaw onboard --install-daemon |
openclaw dashboard |
打开控制台 Web UI，并使用当前 token 登录。 | 你想在网页里聊天、看配置、看会话状态时。 | openclaw dashboard --no-open |
openclaw tui |
打开终端 UI，支持会话输入和斜杠命令。 | 日常高频使用、演示或纯终端环境。 | openclaw tui |
openclaw config |
非交互配置助手，支持 file/get/set/unset/validate。 |
你想脚本化地查看或修改配置。 | openclaw config validate |
openclaw models |
模型发现、扫描、默认模型设置和状态查看。 | 切默认模型、看当前模型配置是否正确。 | openclaw models set volcengine-plan/doubao-seed-code |
openclaw gateway |
网关服务的启动、状态、重启、探测与调用。 | 服务异常、配置修改后、检查 RPC 时。 | openclaw gateway status |
openclaw status |
查看渠道健康、最近会话对象和使用量。 | 机器人收不到消息、想做全局读诊断时。 | openclaw status --all |
openclaw doctor |
执行健康检查并提供修复动作。 | 不知道问题在哪，先统一跑一次体检。 | openclaw doctor --repair |
openclaw plugins |
安装、启停、更新和排查插件。 | 接 QQ / 飞书等扩展入口，或插件不工作时。 | openclaw plugins install @sliverp/qqbot@latest |
openclaw channels |
添加、登录、列出和查看聊天渠道状态。 | 给机器人绑定 Telegram、Discord、Feishu 等渠道。 | openclaw channels add --channel qqbot --token "AppID:AppSecret" |
openclaw skills |
查看可用技能、检查依赖、查看详情。 | 确认某个 Skill 是否装好、缺不缺运行环境。 | openclaw skills check |
openclaw docs |
搜索在线文档。 | 忘了参数、忘了某个概念时。 | openclaw docs models |
按工作阶段理解命令
1. 首次安装与启动
用 onboard 完成初始化；用 dashboard 或 tui 进入交互；如果需要图形浏览器但暂时不想自动打开，可加 --no-open。
2. 配置查看与修改
config file 先确认你改的是哪份配置；config get 读值；config set 改值；最后用 validate 避免写坏。
3. 模型管理
全局默认模型用 models set；会话内临时切换用 TUI 的 /model。这两个层级不要混淆。
4. 网关与健康检查
gateway status 看服务和 RPC，status --all 做全局只读诊断，doctor --repair 才是带修复动作的体检。
5. 插件与渠道
插件是“能力模块”，渠道是“消息入口”。通常先装插件，再配渠道，最后重启网关。
6. 技能与文档
Skill 负责让 Agent 多一类能力。先看清单，再查详情和依赖。忘记某个用法时，直接用 openclaw docs 搜索。
更多一级命令速览
除了上面这组高频命令，当前版本的一级命令里还常见这些方向：代理与会话、审批、安全、浏览器、备份、自动化与更新。
⌨️ TUI 斜杠指令
TUI 是 OpenClaw 的高频工作界面。你可以在里面直接聊天，也可以输入斜杠命令修改当前会话的模型、思考级别、输出细节与生命周期。
常用快捷键
斜杠命令分组
核心命令
查看帮助、状态、切换 agent、切会话、切模型，都在这一组里。
会话控制
调整思考深度、调试输出、推理可见性、用量显示以及是否投递回复。
会话生命周期
重置上下文、中止当前运行、打开设置、退出当前 TUI。
模型切换的正确方式
官方中文文档明确区分了全局默认模型和当前会话模型。CLI 的 openclaw models set 改的是默认值；TUI 的 /model 改的是当前会话。
agents.defaults.models，那它会成为 /model 的可选白名单。出现 “Model is not allowed” 时，不是命令坏了，而是当前模型不在白名单里。
🧪 典型使用流程
下面这些流程可以直接照着做，适合作为培训、课堂演示或新成员入门时的标准动作。
流程 1：安装完成后的第一次进入
先确认配置完成，再从 Web UI 或 TUI 任意选一个入口开始工作。
流程 2：修改默认模型
这是全局配置改动，所以最后要重启网关。适合给整台机器统一默认模型。
流程 3：只在当前会话切模型
这类切换不影响其他会话，也不要求重启服务。适合临时切换到更快或更强的模型。
流程 4：接入 QQ 机器人
先装插件，再添加渠道，最后重启服务。这个流程和当前安装页里的说明保持一致。
流程 5：用命令修一次配置
如果不想手改 JSON 文件，优先走 config 命令链，风险更小，也便于复现。
流程 6：查为什么“看起来没反应”
先看服务是否活着，再看全局状态，最后再做自动修复。不要一上来就重装。
⚙️ 配置修改技巧
修改配置时，先搞清楚自己动的是“文件层”“默认层”还是“会话层”。这三层混在一起，是初学者最容易出问题的地方。
先确认配置文件位置
不同 profile 会指向不同配置目录。先用命令确认，再决定是否手动编辑。
修改后先验证
config validate 可以避免 JSON5、路径和字段写坏后直接重启服务。
默认模型和会话模型分开看
默认模型用 models set；当前会话模型用 /model。不要把一次会话切换误以为已经全局生效。
openclaw config get 看现值，再 openclaw config set 写新值，随后 openclaw config validate，最后再 openclaw gateway restart。
🩺 排错清单
遇到问题时，优先区分是“服务没起来”“渠道没接好”“模型没配置对”还是“只是当前会话状态不对”。下面这张清单能快速定位。
| 现象 | 先执行什么 | 重点看什么 |
|---|---|---|
| 配置改了但没生效 | openclaw config validateopenclaw gateway restart |
配置是否有效，网关是否已重启。 |
| TUI 里一直连不上 | openclaw gateway status --require-rpc |
服务是否正在运行，RPC probe 是否通过。 |
| 机器人收不到或发不出消息 | openclaw channels listopenclaw channels status --probe |
渠道账号是否存在，探测是否通过。 |
| 插件安装后没有效果 | openclaw plugins listopenclaw plugins doctor |
插件是否已发现、是否有加载问题。 |
| 模型切换报 not allowed | /model listopenclaw config get agents.defaults.models |
当前模型是否在白名单里。 |
| 不知道问题在哪 | openclaw status --allopenclaw doctor --repair |
先拿全局只读诊断，再决定是否自动修复。 |
reset 会重置本地配置和状态，uninstall 会卸载网关服务并清除本地数据。它们不是常规排错命令，不要把“重装”当成第一反应。
📌 常见误区
把 dashboard 当成“启动服务”
dashboard 是打开控制台入口，不等于修复或重装服务。服务状态还是要看 openclaw gateway status。
把 /model 当成全局设置
/model 只影响当前会话；要改默认模型，用 openclaw models set。
只会看 status，不会看 gateway status
openclaw status 偏向渠道健康与近期会话，openclaw gateway status 才是服务层状态与 RPC 探测。
手改配置后忘了验证
改完配置就重启，出问题时很难知道是写坏了还是服务没起来。先跑 openclaw config validate 能省很多时间。