飞书官方插件一键转换 🦞
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 授权吗？
可以跳过！ 安装后不授权也能用基础功能（流式输出、对话），只是无法读取消息历史和以你的身份操作。
📚 完整文档
🔗 相关链接
版本： 3.0.0
最后更新： 2026-03-18
作者： rfdiosuao
许可证： MIT