跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

配置飞书 OpenClaw 机器人实现 AI 智能对话与自动化办公

如何在飞书（Feishu）中集成 OpenClaw 机器人，实现 AI 智能对话与自动化办公。主要步骤包括创建飞书自建应用获取凭证，选择插件或独立桥接模式进行安装，配置权限管理与事件订阅，最后进行测试验证与常见问题排查。插件版适合新手快速体验，独立桥接版更适合生产环境部署，支持更稳定的进程隔离及完整的媒体文件收发功能。

CodeArtist发布于 2026/4/6更新于 2026/5/2230 浏览
配置飞书 OpenClaw 机器人实现 AI 智能对话与自动化办公

目标：在飞书（Feishu/Lark）中添加 OpenClaw 机器人，实现 7×24 小时 AI 智能对话与自动化办公。

效果展示

（此处省略图片链接）

方案选择：插件 vs 独立桥接

OpenClaw 提供两种接入飞书的方式，根据你的需求选择：

特性插件版 (openclaw-feishu)独立桥接 (feishu-openclaw)
安装难度⭐ 一键安装，最简单⭐⭐⭐ 需要手动配置
进程隔离与 Gateway 同一进程独立进程，互不影响
稳定性日常使用足够更高，适合生产环境
媒体支持基础图片/文件完整的图片/视频/文件收发
适用场景个人试用、快速体验企业部署、7×24 小时运行

建议：新手先用插件跑通，需要稳定运行时再升级到独立桥接。

创建飞书机器人应用

无论选择哪种方式，都需要先在飞书开放平台创建机器人应用。

2.1 登录飞书开放平台
  1. 访问 飞书开放平台（国内版）或 Lark Open Platform（国际版）
  2. 使用飞书账号登录
2.2 创建自建应用
  1. 点击右上角 '创建自建应用'
  2. 填写应用信息：
    • 应用名称：如 'OpenClaw AI 助手'
    • 应用描述：如 '基于 OpenClaw 的智能 AI 助手'
    • 应用图标：上传自定义图标（可选）
  3. 点击 '创建'
2.3 添加机器人能力
  1. 进入应用详情页 → '添加应用能力'
  2. 选择 '机器人' → 点击 '添加'
  3. 配置机器人信息：
    • 机器人名称：显示在飞书中的名字
    • 机器人描述：功能介绍
    • 机器人头像：在飞书中显示的头像
2.4 获取凭证信息

进入 '凭证与基础信息' 页面，记录以下关键信息：

字段说明
用途
App ID应用唯一标识如 cli_xxxxxxxxxxxx
App Secret应用密钥需保密，用于 API 调用

⚠️ 重要：App Secret 只显示一次，请立即复制保存！

方式一：插件安装（推荐新手）

插件版安装最简单，适合快速体验。

3.1 前提条件
  • 已安装 OpenClaw（Clawdbot）
  • Gateway 服务正常运行
  • Node.js ≥ 18
3.2 一键安装插件
# 使用 npm 安装插件
clawdbot plugins install feishu-openclaw
# 或使用 openclaw 命令
openclaw plugins install feishu-openclaw
3.3 配置插件

编辑 OpenClaw 配置文件（通常位于 ~/.clawdbot/clawdbot.json 或 ~/.openclaw/openclaw.json）：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxx",
      "appSecret": "你的 AppSecret",
      "verificationToken": "你的 VerificationToken",
      "encryptKey": "你的 EncryptKey"
    }
  },
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "baseUrl": "https://vip.apiyi.com/v1"
    }
  }
}
3.4 启动服务
# 重启 Gateway 使配置生效
clawdbot gateway restart
# 或 openclaw restart

方式二：独立桥接安装（生产环境）

独立桥接需要更多配置步骤，但提供更好的稳定性和功能完整性。

4.1 克隆桥接项目
# 克隆仓库
git clone https://github.com/AlexAnys/feishu-openclaw.git
cd feishu-openclaw
# 安装依赖
npm install
4.2 配置安全凭证

将 App Secret 保存到安全位置，避免硬编码在代码中：

# 创建 secrets 目录
mkdir -p ~/.clawdbot/secrets
# 写入 App Secret（替换为你的真实密钥）
echo "你的 AppSecret" > ~/.clawdbot/secrets/feishu_app_secret
# 设置权限，仅自己可读（Linux/macOS）
chmod 600 ~/.clawdbot/secrets/feishu_app_secret
4.3 配置环境变量

创建 .env 文件或直接在启动时传入环境变量：

# .env 文件示例
FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret
CLAWDBOT_CONFIG_PATH=~/.clawdbot/clawdbot.json
CLAWDBOT_AGENT_ID=main
# 调试模式（可选）
FEISHU_BRIDGE_DEBUG=1
4.4 测试运行
# 手动运行测试
node bridge.mjs

看到 Connected to Feishu WebSocket 和 Connected to Clawdbot Gateway 即表示成功连接。

4.5 设置开机自启（推荐）

macOS 系统：

# 生成 launchd 服务配置
node setup-service.mjs
# 加载服务
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist
# 查看状态
launchctl list | grep feishu

Linux 系统（systemd）：

创建服务文件 ~/.config/systemd/user/feishu-bridge.service：

[Unit]
Description=Feishu OpenClaw Bridge
After=network.target

[Service]
Type=simple
WorkingDirectory=/path/to/feishu-openclaw
Environment=FEISHU_APP_ID=cli_xxxxxxxxxxxx
Environment=FEISHU_APP_SECRET_PATH=/home/username/.clawdbot/secrets/feishu_app_secret
ExecStart=/usr/bin/node bridge.mjs
Restart=always
RestartSec=10

[Install]
WantedBy=default.target

启动服务：

systemctl --user daemon-reload
systemctl --user enable feishu-bridge
systemctl --user start feishu-bridge

配置权限与事件订阅

创建应用后，需要配置权限和事件才能使机器人正常工作。

5.1 配置权限管理

进入应用详情 → '权限管理' → '权限配置'，开通以下权限：

消息与群组权限
权限名称权限 Key用途
获取与发送单聊、群组消息im:message基础消息收发
以机器人身份发送消息im:message:send_as_bot避免 403 错误
接收群聊中 @ 机器人的消息im:message.group_at_msg群聊 @ 触发
接收机器人单聊消息im:message.p2p_msg单聊触发
资源权限（用于收发图片/文件）
权限名称权限 Key用途
获取用户上传的资源im:resource下载用户发送的图片/文件
上传图片或文件到 IMim:image发送图片给飞书
用户与通讯录权限
权限名称权限 Key用途
通过手机号或邮箱获取用户 IDcontact:user.id:readonly获取用户信息

💡 提示：每添加一个权限，记得点击 '批量开通' 按钮！

5.2 配置事件订阅

进入 '事件与回调' → '事件配置'：

  1. 加密方式：选择 '长连接'（WebSocket 模式）
    • ✅ 不需要公网 IP
    • ✅ 不需要 HTTPS 证书
    • ✅ 不需要 ngrok 内网穿透
  2. 添加事件：点击 '添加事件'，选择：
    • im.message.receive_v1（接收消息事件）
  3. 保存配置
5.3 发布应用

配置完成后，需要发布应用才能使用：

  1. 进入 '版本管理与发布'
  2. 点击 '创建版本'
  3. 填写版本信息：
    • 版本号：如 1.0.0
    • 更新说明：如 '初始版本'
  4. 点击 '保存并发布'
  5. 等待管理员审批（测试企业可立即使用）
5.4 将机器人添加到聊天

单聊使用：

  • 在飞书搜索框输入机器人名称
  • 点击进入即可开始对话

群聊使用：

  1. 进入群聊 → 点击右上角 '群设置'
  2. 选择 '群机器人' → '添加机器人'
  3. 搜索并选择你的机器人
  4. 点击 '添加'

测试与验证

6.1 发送测试消息

在飞书中给机器人发送消息，观察回复：

测试场景输入示例预期结果
基础对话'你好'AI 正常回复
知识问答'什么是 OpenClaw？'AI 给出解释
群聊 @'@机器人 帮我总结一下'机器人回复
图片识别发送一张图片AI 描述图片内容
6.2 查看日志

插件版日志：

clawdbot logs
# 或 openclaw logs

独立桥接日志：

# macOS
tail -f ~/.clawdbot/logs/feishu-bridge.out.log
tail -f ~/.clawdbot/logs/feishu-bridge.err.log
# Linux
journalctl --user -u feishu-bridge -f
6.3 功能特性验证

独立桥接版支持以下高级功能：

功能测试方法预期结果
图片发送发送本地图片AI 能'看懂'图片
图片生成'生成一张猫的图片'收到 AI 生成的图片
文件发送发送 PDF/WordAI 可读取内容
视频发送发送短视频桥接可接收处理
长文本发送大段文字正常回复不截断
"正在思考"提示问复杂问题超过 2.5 秒显示提示

常见问题排查

问题 1：能发消息，但收不到回复

可能原因及解决：

检查项解决方法
事件订阅方式确认选择了 '长连接'，不是 Webhook
事件订阅列表确认添加了 im.message.receive_v1
应用发布状态检查应用是否已发布（至少测试版）
机器人添加状态确认机器人已添加到群聊/单聊
Gateway 运行状态运行 clawdbot gateway status 检查
问题 2：AI 看不到图片/文件（只显示 key）

解决步骤：

  1. 检查权限：确认开通了 im:resource 权限
  2. 开启调试模式：在 .env 中设置 FEISHU_BRIDGE_DEBUG=1
  3. 查看日志：tail -f ~/.clawdbot/logs/feishu-bridge.err.log
  4. 检查文件路径：确保文件在白名单目录内（默认：~/.clawdbot/media、系统临时目录、/tmp）
问题 3：AI 说生成了图片，但飞书收不到

可能原因：

原因解决方法
图片路径不在白名单将图片保存到 ~/.clawdbot/media
图片文件过大检查文件大小限制
文件不可读检查文件权限
问题 4：推送消息报错 403

原因： 缺少 im:message:send_as_bot 权限

解决： 在权限管理中添加该权限并重新发布应用。

问题 5：群聊中机器人不回复

可能原因：

检查项说明
是否被 @群聊默认只在被 @ 时回复
消息内容检查是否包含疑问词或请求词
隐私模式检查机器人隐私设置

自定义触发规则（独立桥接）：

编辑 bridge.mjs 中的 shouldReplyInGroup 函数：

function shouldReplyInGroup(message) {
  const text = message.content.text?.toLowerCase() || '';
  // 被 @ 时回复
  if (message.mentions?.length > 0) return true;
  // 包含关键词时回复
  const keywords = ['机器人', '助手', 'bot', 'help'];
  if (keywords.some(k => text.includes(k))) return true;
  // 疑问句自动回复
  if (text.endsWith('?') || text.endsWith('？')) return true;
  return false;
}
问题 6：调试技巧

开启详细日志：

# 独立桥接调试模式
FEISHU_BRIDGE_DEBUG=1 node bridge.mjs
# 查看实时日志
tail -n 200 -f ~/.clawdbot/logs/feishu-bridge.err.log

参考链接

资源链接
OpenClaw 飞书插件https://github.com/AlexAnys/openclaw-feishu
feishu-openclaw 桥接https://github.com/AlexAnys/feishu-openclaw
飞书开放平台https://open.feishu.cn/
Lark Open Platformhttps://open.larksuite.com/

目录

  1. 效果展示
  2. 方案选择：插件 vs 独立桥接
  3. 创建飞书机器人应用
  4. 2.1 登录飞书开放平台
  5. 2.2 创建自建应用
  6. 2.3 添加机器人能力
  7. 2.4 获取凭证信息
  8. 方式一：插件安装（推荐新手）
  9. 3.1 前提条件
  10. 3.2 一键安装插件
  11. 使用 npm 安装插件
  12. 或使用 openclaw 命令
  13. 3.3 配置插件
  14. 3.4 启动服务
  15. 重启 Gateway 使配置生效
  16. 或 openclaw restart
  17. 方式二：独立桥接安装（生产环境）
  18. 4.1 克隆桥接项目
  19. 克隆仓库
  20. 安装依赖
  21. 4.2 配置安全凭证
  22. 创建 secrets 目录
  23. 写入 App Secret（替换为你的真实密钥）
  24. 设置权限，仅自己可读（Linux/macOS）
  25. 4.3 配置环境变量
  26. .env 文件示例
  27. 调试模式（可选）
  28. 4.4 测试运行
  29. 手动运行测试
  30. 4.5 设置开机自启（推荐）
  31. 生成 launchd 服务配置
  32. 加载服务
  33. 查看状态
  34. 配置权限与事件订阅
  35. 5.1 配置权限管理
  36. 消息与群组权限
  37. 资源权限（用于收发图片/文件）
  38. 用户与通讯录权限
  39. 5.2 配置事件订阅
  40. 5.3 发布应用
  41. 5.4 将机器人添加到聊天
  42. 测试与验证
  43. 6.1 发送测试消息
  44. 6.2 查看日志
  45. 或 openclaw logs
  46. macOS
  47. Linux
  48. 6.3 功能特性验证
  49. 常见问题排查
  50. 问题 1：能发消息，但收不到回复
  51. 问题 2：AI 看不到图片/文件（只显示 key）
  52. 问题 3：AI 说生成了图片，但飞书收不到
  53. 问题 4：推送消息报错 403
  54. 问题 5：群聊中机器人不回复
  55. 问题 6：调试技巧
  56. 独立桥接调试模式
  57. 查看实时日志
  58. 参考链接
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Gitnuro 跨平台 Git 可视化管理工具使用指南
  • OpenClaw 入门：本地 AI 助手架构、功能与使用场景
  • Python dotenv 库 load_dotenv() 使用指南：环境变量管理与安全实践
  • 大语言模型架构：LLM MoE 与 Switch Transformers
  • LLM 微调实战：使用 Llama-Factory 进行 DPO 训练
  • PyQt5 基础与常用控件入门教程
  • ABB 机器人虚拟示教器基础操作与编程指南
  • 前端函数防抖原理与实战实现
  • 网络安全转行指南：零基础学习路径与职业规划建议
  • OpenClaw：自托管无代码 AI Agent 框架技术剖析
  • AIGC 工具助力 2D 游戏美术全流程
  • OpenClaw 本地部署实战：从零搭建可控 AI Agent 框架
  • 2024 年大模型 LLM 技术学习路线图与核心岗位分析
  • 大模型工具调用演进：从 Function Calling 到 MCP
  • Spring Bean 生命周期详解
  • 系统开发成本为何居高不下：低代码的工程化降本路径
  • 前端开发一天通常能完成多少页面
  • C++ 面向对象编程核心：继承机制深度解析
  • 前端国际化开发指南
  • 2026 年 2 月 AIGC 行业模型发布及前沿资讯

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online