下面我按「命令体系」和「学习路线」两块帮你梳理，并顺带把你当前遇到的问题（配对循环、重复插件警告）一起放进上下文里。

一、先搞清楚：OpenClaw 有哪几类“命令”？

OpenClaw 的指令主要分三大类：

  1. CLI 终端命令：在终端里敲，比如 openclaw gateway start、openclaw pairing approve 等。
  2. 聊天斜杠命令：在飞书 / Telegram / WhatsApp 等聊天窗口里发，比如 /new、/status、/model 等。
  3. Web / 控制面 UI：打开浏览器 http://127.0.0.1:18789/，用图形界面配置模型、渠道、Agent 等。
    你之前在终端用的就是 CLI；你在飞书里发 /help 或 /commands 看到的是聊天命令。

二、整体架构一图看懂

下面这张图把关键组件和常用命令串起来，你以后遇到问题可以先看“落在哪个区域”。

终端 CLI 命令

消息

RPC 调用

调用工具

调用模型

管理

你: 飞书 / Telegram / Web

Gateway 网关

Agent Runtime

Tools: 浏览器 / 执行命令 / Skills 插件

Model Provider: Claude / Kimi / OpenAI

openclaw gateway

openclaw pairing

openclaw channels

openclaw config

openclaw doctor

三、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 天）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

七、总结常见使用指令

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


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

新手摸透这几个命令，就能解决90%的日常使用问题！
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区