Feishu Official Plugin Switch

3 分钟从社区版升级到官方版，开启流式输出、用户身份、50+ 官方工具

Install

openclaw skills install feishu-official-plugin-switch

飞书官方插件一键转换 🦞

3 分钟搞定！从 OpenClaw 社区版升级到飞书官方版，开启流式输出、用户身份、50+ 官方工具

✨ 功能特性

1. 一键自动转换

自动检查 OpenClaw 版本（≥2026.2.26 Linux/MacOS，≥2026.3.2 Windows）
自动安装官方插件（@larksuite/openclaw-lark-tools）
自动配置流式输出（打字机效果）
自动切换插件（禁用社区版，启用官方版）
自动重启 OpenClaw Gateway
自动验证配置生效

2. 智能诊断

版本检测
插件状态检查
配置验证
问题自动修复建议

3. 详细状态报告

每个步骤的执行结果
成功/失败状态清晰展示
问题诊断建议

4. 安全提示

转换前风险提示
权限配置指引
数据隐私保护建议

5. 新功能介绍

电子表格读写
表情识别
多账号支持
话题群独立上下文

🚀 使用方式

启动转换

在飞书中对机器人说以下任意一句话：

「切换到官方飞书插件」
「安装官方插件」
「开启流式输出」
「switch to official plugin」

自动执行流程

await main(ctx, { action: 'start_switch' });

检查版本

await main(ctx, { action: 'check_version' });

安装官方插件

await main(ctx, { action: 'install_plugin' });

配置流式输出

await main(ctx, { 
  action: 'configure_streaming',
  options: {
    streaming: true,
    footer_status: true,
    footer_elapsed: true
  }
});

切换插件

await main(ctx, {
  action: 'switch_plugin',
  disable: 'feishu',
  enable: 'feishu-openclaw-plugin'
});

重启 OpenClaw

await main(ctx, { action: 'restart_openclaw' });

验证配置

await main(ctx, { action: 'verify_config' });

📋 转换流程

版本检查 - 检查 OpenClaw 版本是否满足要求
插件安装 - 安装官方插件 (@larksuite/openclaw-lark-tools)
流式配置 - 开启流式输出、状态显示、耗时显示
插件切换 - 禁用社区版，启用官方版
重启服务 - 重启 OpenClaw Gateway
验证配置 - 检查插件状态和流式配置
完成报告 - 展示转换结果和新功能介绍

⚠️ 版本要求

OpenClaw: ≥ 2026.2.26 (Linux/MacOS) / ≥ 2026.3.2 (Windows)
官方插件: ≥ 2026.3.15
Node.js: ≥ 18.0.0

🔐 权限配置

确保飞书机器人已申请以下核心权限：

应用身份权限：

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "cardkit:card:write",
      "cardkit:card:read"
    ]
  }
}

用户身份权限（批量授权时用）：

{
  "scopes": {
    "user": [
      "base:record:*",
      "docs:document:*",
      "calendar:calendar.event:*",
      "task:task:*",
      "im:message",
      "drive:file:*"
    ]
  }
}

🎉 转换后的新能力

能力	社区版	官方版
身份	机器人	用户身份 ✅
文档权限	只读	读写 ✅
消息历史	❌	完整读取 ✅
流式输出	❌	打字机效果 ✅
表情识别	❌	支持 ✅
电子表格	❌	读写支持 ✅
工具数量	基础	50+ ✅
多账号	❌	支持 ✅
话题群	❌	独立上下文 ✅

📊 诊断命令

转换完成后，在飞书中发送以下命令验证：

/feishu start - 确认安装成功
/feishu doctor - 检查配置
/feishu auth - 批量授权

命令行诊断：

npx @larksuite/openclaw-lark-tools doctor
npx @larksuite/openclaw-lark-tools doctor --fix
npx @larksuite/openclaw-lark-tools info

🐛 常见问题

Q1: 插件安装失败？

# 使用 sudo
sudo npx -y @larksuite/openclaw-lark-tools install

# 使用国内镜像
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

Q2: 流式没效果？

# 检查插件状态
openclaw plugins list | grep feishu

# 期望：feishu-openclaw-plugin loaded, feishu disabled

Q3: Coze 上安装失败？

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
npx -y @larksuite/openclaw-lark-tools install

Q4: 需要 OAuth 授权吗？

可以跳过！ 安装后不授权也能用基础功能（流式输出、对话），只是无法读取消息历史和以你的身份操作。

📚 完整文档

查看 GitHub README

🔗 相关链接

版本： 3.0.0
最后更新： 2026-03-18
作者： rfdiosuao
许可证： MIT