【OpenClaw】命令学习指南备忘

作者：CSDN博客

---

三、CLI 命令速查（按使用阶段分）

3.1 安装 / 初始化阶段

场景	命令	说明
查看帮助	openclaw --help	查看所有子命令
查看版本	openclaw --version	版本信息
首次安装后配置	openclaw setup 或 openclaw onboard	交互式引导配置模型、渠道等
打开控制面板	openclaw dashboard	浏览器打开本地 UI

---

3.2 配置管理（重点）

这些命令是你会反复用到的“核心”。

场景	命令	说明
查看完整配置	openclaw config get	输出整个 openclaw.json
查看某一项	openclaw config get models.default	查看默认模型
设置配置项	openclaw config set models.default mistral:mixtral-8x7b	修改配置（直接改 JSON 也可以）
打开配置向导	openclaw configure	交互式配置，比直接改 JSON 更安全
配置文件位置	~/.openclaw/openclaw.json	主配置；凭证在 ~/.openclaw/credentials/

小建议：熟悉之后可以直接用 openclaw config get/set 或编辑 JSON，比频繁改 UI 高效。

---

3.3 Gateway（网关）控制

Gateway 是整个 OpenClaw 的“总机”，所有消息和工具调用都经过它。

场景	命令	说明
启动网关	openclaw gateway start	默认 127.0.0.1:18789
前台运行（调试）	openclaw gateway	日志直接在终端看
停止网关	openclaw gateway stop
重启网关	openclaw gateway restart	改配置后要用这个生效
查看状态	openclaw gateway status	查看是否在线、端口等
健康检查	openclaw health --json	适合自动化探测
系统服务管理	systemctl start/stop/restart/status openclaw-gateway	Linux/WSL 下用 systemd 管理

你之前遇到的“配置改了不生效”，就是没有重启 Gateway。

---

3.4 渠道（Channels）——飞书等 IM 接入

场景	命令	说明
添加渠道（飞书等）	openclaw channels add	交互式选择 Feishu / Telegram / WhatsApp 等
查看所有渠道	openclaw channels list
查看渠道状态	openclaw channels status
测试渠道连接	openclaw channels test --channel feishu
登录渠道	openclaw channels login --channel feishu	一般通过向导 onboard 或 channels add 就够了
你之前用 openclaw channels add 选 Feishu，就是在做这一步。

---

3.5 Pairing（配对 / 授权）

这是你最近踩坑最多的部分：第一次 DM 机器人时，必须配对批准。

场景	命令	说明
查看配对请求列表	openclaw pairing list feishu	看谁在申请连接
批准配对	openclaw pairing approve feishu <CODE>	就是你跑的那条
查看配对状态	openclaw pairing status feishu

正确流程：飞书里给机器人发消息 → 得到配对码 → 终端执行 openclaw pairing approve feishu <CODE>。

---

3.6 模型（Models）

场景	命令	说明
查看模型列表	openclaw models list
设置默认模型	openclaw models set-default mistral:mixtral-8x7b
测试模型	openclaw models test --model mistral:mixtral-8x7b --prompt "Hello"

---

3.7 插件 / Skills（扩展能力）

场景	命令	说明
安装插件	openclaw plugins install @openclaw/feishu
启用/禁用插件	openclaw plugins enable/disable <id>
查看技能列表	openclaw skills list
安装技能	openclaw skills install weather

你遇到的“duplicate plugin id detected”就是因为 本地 extensions/feishu 和内置插件冲突，后面我会说怎么处理。

---

3.8 诊断 & 排障（强烈建议你常用）

场景	命令	说明
一键体检 + 修复	openclaw doctor	修复过时配置、状态迁移、健康检查
深度体检	openclaw doctor --deep
自动修复	openclaw doctor --repair
查看状态总览	openclaw status --deep
实时日志	openclaw logs --follow
安全审计	openclaw security audit	检查常见安全风险

你现在遇到问题，可以先跑：openclaw doctor + openclaw status --deep。

---

3.9 会话 & 节点（进阶一点）

场景	命令	说明
查看所有会话	openclaw sessions
查看特定会话历史	openclaw sessions history <session-key>
重置会话	openclaw sessions reset <session-key>
查看配对的节点	openclaw nodes list	以后做“智能家居/远程主机”会用到

---

四、聊天斜杠命令（在飞书 / Telegram 里用）

这些是你在聊天窗口里发给机器人的命令，所有渠道通用：

命令	作用	典型用法
/help 或 /commands	查看所有可用斜杠命令	忘记有哪些命令时用
/new	新开一个会话，释放上下文	切换任务、降低 Token 成本
/status	查看当前会话状态、Token 使用量、成本	对话变慢或想看费用时用
/model	切换模型	/model haiku 省钱，/model opus 复杂任务
/compact	压缩历史上下文，总结旧对话	不想 /new 但又想省钱时用
/usage	查看详细用量和成本统计	/usage full、/usage cost
/context	查看上下文细节（Token 分布）	优化系统提示词、Bootstrap 文件
/exec	控制命令执行策略（沙箱/白名单等）	安全相关
/approve	批准某个动作	工具请求权限时用

---

五、推荐学习大纲（从“能跑”到“能调”）

下面给你一个按阶段划分的学习路线，你可以照着一步步练。
阶段 0：先跑通最小闭环（0 ~ 1 天）

目标：在飞书里让机器人回复你。

安装：按官方脚本或文档安装 OpenClaw。

• 运行向导：
  
  openclaw onboard 或 openclaw setup。选择模型（Claude / Kimi / 其他）。选择 Feishu 渠道，按提示粘贴 App ID / App Secret。
  
  
  
• 启动网关：
  
  openclaw gateway 或 openclaw gateway start。
  
  
  
• 第一次配对：
  
  飞书里给机器人发消息。终端执行 openclaw pairing approve feishu <CODE>。
  
  
  
• 验证：
  
  发 /status、/new、/model list 等命令，确认斜杠命令能用。
  
  
  

---

阶段 1：熟悉配置 & Gateway（1 ~ 3 天）

目标：知道配置在哪、怎么改、怎么重启生效。
重点练习：

• 配置文件：
  
  用 openclaw config get 看结构。用 openclaw configure 或直接编辑 ~/.openclaw/openclaw.json。
  
  
  
• Gateway 控制：
  
  openclaw gateway status。openclaw gateway restart。openclaw logs --follow。
  
  
  
• 诊断命令：
  
  openclaw health --json。openclaw status --deep。openclaw doctor。
  
  
  

---

阶段 2：模型、渠道 & 权限（3 ~ 7 天）

目标：知道怎么换模型、加新渠道、控制谁能用你的机器人。
重点：

• 模型管理：
  
  openclaw models list。openclaw models set-default。在聊天里用 /model 切换模型体验差异。
  
  
  
• 渠道管理：
  
  openclaw channels add 加第二个渠道（比如 Telegram / WhatsApp）。openclaw channels test 测试连接。
  
  
  
• 访问控制（你现在的核心）：
  
  理解 dmPolicy: "pairing"、allowFrom、trusted_senders。学会 openclaw pairing list / approve / status。
  
  
  

---

阶段 3：工具、Skills、插件（7 ~ 14 天）

目标：让机器人能“做事”（跑命令、访问文件、调用外部工具）。
重点：

• 理解 Tools / Skills / Plugins 的区别：
  
  Tools：内置能力（browser、exec、web 等）。Skills：社区提供的技能包。Plugins：更底层的扩展，比如飞书插件。
  
  
  
• 安装和管理：
  
  openclaw skills list / search / install。openclaw plugins install。
  
  
  
• 安全策略：
  
  在配置里设置 tools.exec.security、tools.profile。用 /exec 命令调整执行策略。
  
  
  

---

阶段 4：排障 + 安全（长期）

目标：遇到问题能自己定位，并理解安全边界。
重点：

• 诊断组合拳：
  
  openclaw doctor。openclaw status --deep。openclaw logs --follow。
  
  
  
• 安全审计：
  
  openclaw security audit。理解“个人助理信任模型”：谁有权限改 ~/.openclaw，谁就是可信操作者。
  
  
  
• 配置版本化：
  
  用 Git 管理 ~/.openclaw/openclaw.json 的变更，方便回滚。
  
  
  

---

六、结合你当前的问题，怎么“落地”？

你目前遇到的是两类典型问题：

• 配对循环：每次飞书发消息都要求新配对。
  
  原因：配置里没有持久化你的飞书 ID（trusted_senders 或对应渠道的 allowFrom）。解决：在 auth 或 channels.feishu 里把你的 ou_xxx 写入信任列表，然后重启 Gateway。
  
  
  
• 重复插件警告：duplicate plugin id detected。
  
  原因：本地 extensions/feishu 和内置 feishu 插件 ID 冲突。
  
  • 建议：
    
    删除本地 ~/.openclaw/extensions/feishu 目录。只依赖内置插件或官方插件安装命令。
    
    
    
  
  

---

如果你愿意，我可以基于你现在的 openclaw.json 内容，帮你：

标出“安全基线”的最小配置示例；给一个“从当前状态”到“稳定可用”的具体修改清单。

七、总结常见使用指令

OpenClaw（大龙虾）安装后必用核心命令，新手直接抄，全是干货！

1. openclaw onboard：彻底重置全量配置，安装配置出错、想换模型或聊天渠道，输入后可重新走完整初始化流程
2. openclaw config：轻量改单项配置，不用全量重置，换模型、对接飞书/微信等渠道，输入后进菜单单独调整即可
3. openclaw status：故障排查第一步，网页打不开、发消息没反应就输它，看Gateway项，显示unreachable就是网关没运行，看不懂的报错直接复制给AI解读
4. openclaw gateway：核心服务运行命令，两种用法：前台调试直接输，实时看日志，关终端服务就停，仅适合临时调错；日常推荐后台常驻，先输openclaw gateway install（仅需跑一次），再输openclaw gateway start，关终端不影响服务运行。配套命令：openclaw gateway stop彻底关服务；openclaw gateway restart，改配置、换API Key/模型后必须执行，重启才加载新配置
5. openclaw dashboard：一键打开控制面板，不用记带token的复杂地址，输入后自动获取有效地址，直接唤起浏览器打开
6. openclaw logs --follow：核心排错命令，AI不回复、报401等错误必用，实时滚动看日志，红字就是错误，能快速定位API Key无效、认证失败问题，注意部分模型的API调用Key和订阅Key是分开的，别填错
7. openclaw update：一键更新软件，项目更新频率高，定期执行自动升最新版、修bug补漏洞，更完自动重启服务
9. 新手摸透这几个命令，就能解决90%的日常使用问题！

复制代码

原文地址：https://blog.csdn.net/2404_88943810/article/details/158599864