1. 对话框常用指令（聊天界面）

这部分是你在对话输入框里直接敲的（通常以 / 开头）。它们的核心价值是：切任务、控上下文、救场。

1.1 /new：开启全新对话（最常用）

  • 用途：重置历史，开始新任务。
  • 适合场景：
    • 你要从「写代码」切到「写文案」
    • 当前对话太长、模型开始跑偏
  • 建议：当你发现模型开始反复或误解时，/new 往往比继续解释更省时间。

1.2 /model 与 /models：切模型 / 切提供商

  • /model：查看或切换当前提供商下的模型
  • /models：切换不同提供商的模型（当你接入了多个提供商时很有用）

常见用法思路：

  • 写作：偏好更稳定的长文本输出模型
  • 写代码：偏好推理/代码能力强的模型
  • 成本控制：从高价模型切到更便宜的模型做「初稿」
注意：不同安装/配置下，这两条命令的交互可能略有差异，但核心概念就是「当前模型」与「可选模型列表」。

1.3 /compact：压缩上下文（长对话省 token）

  • 用途：把历史对话压成摘要，保留关键信息，释放上下文窗口
  • 适合场景：
    • 对话已经很长，但你还想继续同一个任务
    • 你需要模型记住结论，但不需要每一句原文

经验法则：

  • 对话超过你体感的「开始卡顿/变慢/开始忘前文」时，就可以 /compact 一次。

1.4 /reset：同一 session 里重新开始

  • 用途：在同一个 session 内重启上下文（效果类似“重新开局”）
  • 适合场景：
    • 你不想新建对话，但想清空当前上下文状态
    • 你怀疑当前对话状态被某些错误指令/错误设定污染了
你原文里写了「/reset 在同一个 session 重新开始上下文」，建议保留这个定义。

1.5 /reasoning 与 /thinking：控制思考展示与强度（需要模型支持）

  • /reasoning：开启/关闭显示思考过程（或推理说明）
  • /thinking：调整思考程度（需要模型支持）

使用建议：

  • 写作/总结：一般不需要很高 thinking
  • 复杂问题排查：可以提高 thinking
  • 如果你只是要结果，不要过程：关闭 /reasoning 更清爽
不同模型对「思考强度」的支持不一致；遇到无效属于正常现象。

1.6 /stop：救命用的（中断输出）

  • 用途：立刻停止当前模型输出
  • 适合场景：
    • 模型开始胡编乱造
    • 输出方向完全错误
    • 输出太长、你只需要前几行

2. CLI 常用指令（命令行）

太常见的（比如 --help 之类）这里不写，我只整理「新手最容易卡住」的：配置、模型、fallback。

2.1 openclaw onboard：启动配置向导（第一次必跑）

openclaw onboard
  • 用途：交互式配置，通常包括：
    • 模型提供商（OpenAI/Anthropic/…）
    • API Key
    • 默认模型等
  • 适合场景：第一次安装后「不知道从哪开始」就先跑它。

2.2 openclaw config：手动编辑配置项

openclaw config
  • Workspace：工作区相关（项目/目录/默认行为）
  • Model：模型选择、默认模型、参数
  • Web tools：联网/网页工具相关开关
  • Gateway：网关/代理/转发相关
  • Daemon：后台服务（如果你的部署形态需要）
  • Channels：渠道/输出通道（例如不同前端或接口）
  • Skills：技能（工具调用、内置能力）
  • Health check：健康检查（连通性/依赖项）
建议：如果你团队多人共用配置或要排查问题，openclaw config 往往比重新 onboard 更精确。

2.3 openclaw models：查看可用模型与提供商

openclaw models
  • 用途：列出当前可用的提供商与模型
  • 适合场景：
    • 你不确定模型名怎么写
    • 你刚加了一个提供商，想验证是否生效

2.4 设置默认模型：openclaw models set ...

openclaw models set openai/gpt-4o
  • 用途：设置默认模型（之后不必每次手动切）
  • 适合场景：
    • 你想把常用模型固定为默认
    • 你在成本/速度/能力之间找到最适配的一款

2.5 添加备用模型（fallback）：主模型挂了自动切

openclaw models fallbacks add anthropic/claude-3-sonnet
  • 用途：当主模型报错、限流或连接不上时自动切换
  • 适合场景：
    • 你在做长任务（写长文、跑分析），不想中途因为网络/限流断掉
    • 你需要更高可用性（尤其是工作流自动化）

建议策略：

  • 主模型：你最常用、最熟悉的
  • 备用模型：选「稳定」或「不同提供商」的，避免同一家一起挂

2.6 改坏的配置还原回来

openclaw doctor --fix

用途：openclaw 该配置之后，重启后不再回应