Feishu Plugin Conflict Fix

---

name: feishu-plugin-conflict-fix description: | 飞书插件工具冲突修复工具。解决 feishu_chat 命名冲突、TTS 语音配置、多 Bot 工具隔离等问题。

当以下情况时使用此 Skill： (1) feishu_chat 工具命名冲突 (2) 飞书发送信息附带 MP3 语音 (3) 需要多 Bot 工具隔离配置 (4) openclaw-lark vs 内置飞书技能冲突 (5) 用户提到"飞书冲突"、"工具冲突"、"TTS 语音"

---

🔧 飞书插件冲突修复指南

版本信息

版本: v1.0.0

作者: 郑宇航

适用场景: 飞书插件冲突排查与修复

---

🚨 常见问题快速索引

| 问题 | 解决方案 | 难度 | |------|----------|------| | feishu_chat 工具冲突 | 方案 1 | ⭐⭐ | | 发送信息附带 MP3 | 方案 2 | ⭐ | | 多 Bot 工具混乱 | 方案 3 | ⭐⭐⭐ |

---

💡 核心解决方案

方案 1: 工具命名冲突

症状: feishu_chat 工具命名冲突 (openclaw-lark vs 内置飞书技能)

原因分析:

官方插件 @larksuite/openclaw-lark 提供 feishu_chat

内置飞书技能也提供 feishu_chat

工具名冲突导致调用错误

解决步骤:

# 1. 查看已加载的插件
openclaw plugins list
2. 查看工具列表
openclaw tools list | grep feishu
3. 禁用冲突插件
方案 A: 禁用内置飞书技能
openclaw config set plugins.entries.feishu.enabled false
方案 B: 禁用官方插件
openclaw config set plugins.entries.feishu-openclaw-plugin.enabled false
4. 重启 OpenClaw
openclaw gateway restart
5. 验证工具
openclaw tools list | grep feishu_chat

使用工具: feishu_calendar_event, feishu_im_user_message, feishu_search_user

推荐配置:

{
  "plugins": {
    "entries": {
      "feishu": { "enabled": false },
      "feishu-openclaw-plugin": { "enabled": true }
    }
  }
}

期望输出:

✅ 已禁用内置 feishu 插件
✅ 官方插件 feishu-openclaw-plugin 已启用
✅ 工具冲突已解决

---

方案 2: TTS 语音配置

症状: 飞书发送信息后附带 MP3 语音文件

原因: TTS (Text-to-Speech) 功能默认开启

关闭 TTS:

# 1. 查看当前 TTS 配置
openclaw config get channels.feishu.tts
2. 关闭 TTS
openclaw config set channels.feishu.tts.enabled false
3. 重启 OpenClaw
openclaw gateway restart

配置选项:

{
  "channels": {
    "feishu": {
      "tts": {
        "enabled": false,
        "provider": "azure",
        "voice": "zh-CN-XiaoxiaoNeural",
        "auto_play": false
      }
    }
  }
}

使用工具: tts, feishu_im_user_message

---

方案 3: 多 Bot 隔离

症状: 多个 Bot 工具混乱，无法区分

解决方案: 配置工具前缀隔离

步骤:

# 1. 为不同 Bot 配置不同前缀
openclaw config set agents.bot1.tool_prefix "bot1_"
openclaw config set agents.bot2.tool_prefix "bot2_"
2. 配置工具可见性
openclaw config set agents.bot1.tools "feishu_*,calendar_*"
openclaw config set agents.bot2.tools "database_*,web_*"
3. 重启 Bot
openclaw agents restart bot1
openclaw agents restart bot2

配置示例:

{
  "agents": {
    "bot1": {
      "tool_prefix": "bot1_",
      "tools": ["feishu_*", "calendar_*"],
      "model": "qwen3.5-plus"
    },
    "bot2": {
      "tool_prefix": "bot2_",
      "tools": ["database_*", "web_*"],
      "model": "qwen3.5-plus"
    }
  }
}

使用工具: subagents, sessions_spawn

---

🛠️ 诊断工具

1. 插件健康检查

openclaw plugins doctor

检查项目:

插件加载状态

工具注册情况

配置完整性

2. 工具冲突检测

# 列出所有 feishu 相关工具
openclaw tools list --pattern "feishu_*"
查看工具来源
openclaw tools info feishu_chat

3. 配置验证

# 验证配置文件
openclaw config validate
查看配置差异
openclaw config diff

---

📋 插件对比

内置 feishu 插件

| 特性 | 说明 | |------|------| | 工具数量 | 50+ | | 身份 | 机器人身份 | | 文档权限 | 只读 | | 消息历史 | ❌ 无法读取 | | 流式输出 | ❌ 不支持 |

官方 feishu-openclaw-plugin

| 特性 | 说明 | |------|------| | 工具数量 | 50+ | | 身份 | 用户身份 ✅ | | 文档权限 | 读写 ✅ | | 消息历史 | ✅ 完整读取 | | 流式输出 | ✅ 打字机效果 |

推荐: 使用官方插件 feishu-openclaw-plugin

---

🔧 一键修复脚本

脚本 1: 禁用内置插件

#!/bin/bash
fix-feishu-conflict.sh
echo "🔧 修复飞书插件冲突..."
1. 禁用内置插件
openclaw config set plugins.entries.feishu.enabled false
2. 启用官方插件
openclaw config set plugins.entries.feishu-openclaw-plugin.enabled true
3. 关闭 TTS
openclaw config set channels.feishu.tts.enabled false
4. 重启
openclaw gateway restart
echo "✅ 修复完成！"

脚本 2: 重置飞书配置

#!/bin/bash
reset-feishu-config.sh
echo "🔄 重置飞书配置..."
备份
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
删除飞书相关配置
jq 'del(.plugins.entries.feishu) | del(.channels.feishu)' \
  ~/.openclaw/openclaw.json > ~/.openclaw/openclaw.json.tmp
mv ~/.openclaw/openclaw.json.tmp ~/.openclaw/openclaw.json
重启
openclaw gateway restart
echo "✅ 重置完成！"

---

📝 配置模板

推荐配置 (仅官方插件)

{
  "plugins": {
    "entries": {
      "feishu": { "enabled": false },
      "feishu-openclaw-plugin": {
        "enabled": true,
        "config": {
          "streaming": true,
          "footer": {
            "status": true,
            "elapsed": true
          },
          "tts": {
            "enabled": false
          }
        }
      }
    }
  }
}

多 Bot 配置

{
  "agents": {
    "feishu-bot": {
      "tool_prefix": "feishu_",
      "tools": ["feishu_*"],
      "channels": ["feishu"]
    },
    "web-bot": {
      "tool_prefix": "web_",
      "tools": ["web_search", "web_fetch"],
      "channels": ["telegram"]
    }
  }
}

---

🆘 紧急恢复

完全重置飞书配置

# 1. 备份
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
2. 删除配置
rm -rf ~/.openclaw/plugins/feishu*
3. 重新安装官方插件
npx -y @larksuite/openclaw-lark install
4. 初始化配置
openclaw config set plugins.entries.feishu-openclaw-plugin.enabled true
5. 重启
openclaw gateway restart

---

📚 相关资源

官方插件使用指南

流式回复配置

OpenClaw 文档

---

📊 版本历史

v1.0.0 (2026-04-09)

✅ 工具命名冲突解决方案

✅ TTS 语音配置指南

✅ 多 Bot 工具隔离方案

✅ 一键修复脚本

---

最后更新: 2026-04-09 作者: 郑宇航