OpenClaw飞书配置教程：一站式设置与优化指南

OpenClaw 飞书配置指南（避免重复警告）

配置OpenClaw的飞书通道时，一个常见的坑就是那个恼人的重复插件警告。不少朋友照着一些教程做完，就卡在了这一步。今天咱们就来把这个问题掰开揉碎讲清楚，帮你一劳永逸地搞定它。

错误配置方式（会导致警告）

你是不是也见过下面这套“标准流程”？很多地方都这么教：

# 1. npm 安装飞书插件
npm install -g @openclaw/feishu

# 2. 在 openclaw.json 中配置 channels
{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}

操作完一看，结果却让人头疼：控制台赫然出现一行警告：

Config warnings: plugin feishu: duplicate plugin id detected

问题出在哪儿呢？道理其实很简单。

当你执行 npm install 时，插件会被安装到本地的 extensions/feishu 目录。而与此同时，你在 channels.feishu 里的配置，又会触发OpenClaw自动去加载这个通道对应的插件。两套机制同时生效，插件就被加载了两次，重复警告自然就出现了。

---

正确配置方式

方法一：只配置 channels（推荐）

最省心、也最推荐的做法，就是完全信任OpenClaw的自动管理能力。你只需要直接编辑 openclaw.json 文件，在 channels 部分配置好飞书就行：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a92cea6597395cb3",
      "appSecret": "pHjlcMEFc0Avu8ucoXBYxfUKo1UrLx8c",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  }
}

看，就这么简单。既不需要手动执行 npm install，也不需要额外添加任何 plugins 配置段。OpenClaw在启动时，会根据 channels 的配置，自动从npm仓库下载并加载所需的飞书插件。

---

方法二：手动安装 + 禁用 channels 自动加载（不推荐）

当然，如果你有特殊需求，非得手动安装插件，也不是不行。只是步骤会麻烦一些：

首先，执行手动安装：

npm install -g @openclaw/feishu

然后，在 openclaw.json 中，需要明确指定插件来源，并确保 channels 配置不会触发二次加载：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  },
  "plugins": {
    "entries": {},
    "installs": {
      "feishu": {
        "source": "npm",
        "spec": "@openclaw/feishu"
      }
    }
  }
}

这种方法绕了个弯，一般场景下不建议使用。

---

修复已有问题的步骤

如果你已经踩坑，出现了重复警告，别慌，按照下面几步操作，很快就能修复。

步骤 1：删除本地插件目录

首先，清理掉之前手动安装的插件文件。在Windows PowerShell中执行：

Remove-Item -Path "$env:USERPROFILE\.openclaw\extensions\feishu" -Recurse -Force

或者，你也可以手动找到并删除这个文件夹：C:\Users\[你的用户名]\.openclaw\extensions\feishu。

步骤 2：清理配置文件

接着，打开你的 openclaw.json 文件，把 plugins 这个配置段整个删掉，或者至少清空它，确保配置文件是干净的：

{
  // ... 其他你的配置 ...
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  },
  // 删除以下整个 plugins 段，或者保留一个空对象
  "plugins": {}
}

步骤 3：重启 Gateway

让修改生效的最直接方式就是重启服务：

openclaw gateway restart

步骤 4：验证

最后，检查一下是否修复成功：

openclaw skills list

如果一切顺利，你应该能看到飞书技能正常加载，而且之前烦人的 Config warnings 已经消失了。

---

飞书机器人配置要点

解决了插件加载问题，咱们再快速过一遍飞书应用本身的配置关键点，确保整个链路畅通。

1. 创建飞书应用

访问 飞书开放平台，创建一个“企业自建应用”。创建后，记得在应用功能的“机器人”板块，点击“启用”。这里生成的 App ID 和 App Secret 就是上面配置里要用到的关键凭证。

2. 配置权限

为了让机器人能正常工作，需要在“权限管理”页面申请以下核心权限：

• im:chat:readonly - 读取群组信息
• im:message:send - 发送消息
• im:message.group_msg - 接收群消息
• im:message.p2p_msg - 接收私聊消息
• docx:document:readonly - 读取文档
• docx:document:write - 写入文档
• drive:drive:readonly - 读取云空间
• wiki:wiki_space:readonly - 读取知识库

3. 订阅事件

在“事件订阅”页面，需要订阅“消息事件”和“群组事件”。

回调地址填写：ws://localhost:18789（这是使用WebSocket连接模式时的地址）。

4. 发布应用

所有配置检查无误后，在“版本管理与发布”页面创建一个版本并发布。发布后，你就可以把机器人添加到需要的群组或开始私聊测试了。

---

总结

配置方式	操作	结果
错误	npm install + channels 配置	重复警告
正确	仅 channels 配置	正常工作

记住一个核心原则就够了：只配置 channels.feishu，不要手动 npm install，也不要画蛇添足地去配置 plugins 段。 把插件的加载和管理工作，放心地交给 OpenClaw 自动完成，这才是最优雅、最不容易出错的做法。

---

文档创建时间：2026-03-04

适用 OpenClaw 版本：2026.3.2