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 配置会自动加载插件
• 两者同时存在，导致插件被加载两次

---

✅ 正确配置方式

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

直接修改 openclaw.json，只保留 channels 配置：

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

不需要 npm install，也不需要 plugins 配置段。

OpenClaw 会自动从 npm 下载并加载飞书插件。

---

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

如果你一定要手动 npm install：

npm install -g @openclaw/feishu

然后配置 openclaw.json：

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

---

🔧 修复已有问题的步骤

如果你已经出现重复警告，按以下步骤修复：

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

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. 创建飞书应用

• 访问 https://open.feishu.cn/app
• 创建企业自建应用
• 启用机器人功能
• 记录 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