飞书 × OpenClaw 接入指南：不用服务器，用长连接把机器人跑起来

优质文章学习记录

— 12 min read

你想在飞书里用上一个能稳定对话、能发图/收文件、还能按规则在群里工作的 AI 机器人，最怕两件事：步骤多、出错后不知道查哪里。这个项目存在的意义，就是把“飞书接 OpenClaw”这件事，整理成一套对非技术也友好的配置入口，并把官方文档没覆盖到的坑集中写成排查清单。

先说清楚它的角色：OpenClaw 现在已经内置官方飞书插件 @openclaw/feishu，功能更完整、维护也更及时。这是好事，说明飞书 + AI 的接入已经走通。这个仓库并不是要替代官方插件，而是继续为大家提供：

  • 新用户：从零开始的新手教程（15–20 分钟）
  • 老用户：从旧版（独立桥接或旧 npm 插件）迁移到官方插件的保姆级路线
  • 常见问题答疑 & 排查清单（最常见的坑优先）
  • 进阶场景：独立桥接模式依然可用（需要隔离/定制时再用）

另外，仓库也推荐了一个新项目 OpenCrew：把 OpenClaw 变成“多 Agent 团队”，用多个 Agent 分工，Slack 频道=岗位，经验自动沉淀，可逆操作无需你确认（原文给了 GitHub 链接）。

一、老用户迁移到官方插件（两种方式任选，效果一样）

适用人群：你以前用过本项目的独立桥接或 npm 插件，现在要迁到 OpenClaw 内置的官方飞书插件。

迁移前你需要知道的事（按原文）

  • 你之前创建的飞书应用（机器人）可以继续用，不需要重建
  • App ID / App Secret 不变
  • 聊天记录不受影响（记录在飞书端）
  • 迁移时机器人会短暂离线（几分钟）

方式一：通过 OpenClaw 升级（推荐，最省事）

前提：你的 OpenClaw 版本 ≥ 2026.2，升级后官方飞书插件已内置。

1）升级 OpenClaw
升级完成会自动重启网关。

2）添加飞书渠道
选择 Feishu → 填 App ID → 填 App Secret。

App Secret 可能还在你旧环境里（原文提示位置）：

  • ~/.clawdbot/secrets/feishu_app_secret（可 cat 查看）
  • 如果找不到：去飞书开放平台 https://open.feishu.cn/app → 你的应用 → 凭证与基础信息 复制

3）补全飞书应用权限（支持图片/文件/流式等）
去飞书开放平台：你的应用 → 权限管理 → 批量导入，粘贴下面 JSON（原文内容不变）：

{"scopes":{"tenant":["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","cardkit:card:write","contact:user.employee_id:readonly","corehr:file:download","docs:document.content:read","event:ip_list","im:chat","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.group_msg","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource","sheets:spreadsheet","wiki:wiki:readonly"],"user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}

导入后：创建新版本 → 发布（让新权限生效）。原文也强调：已有权限会自动跳过，不重复添加。

4）清理旧插件/桥接（避免冲突）

# 移除旧的 npm 插件（如果装过） openclaw plugins remove feishu-openclaw 2>/dev/null # 停掉旧的桥接服务（如果用过独立桥接） launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null # 重启网关 openclaw gateway restart

然后去做“验证”（见后文）。

方式二：不整体升级，手动安装插件 + 配置

适用：你不想升级 OpenClaw，只想把飞书接进来。

1）准备 App ID / App Secret
App Secret 同样可能在：

  • ~/.clawdbot/secrets/feishu_app_secret

找不到就去飞书开放平台应用的“凭证与基础信息”。

2）补权限
同方式一（批量导入 + 创建新版本 + 发布）。

3）安装并配置

# 安装官方飞书插件 openclaw plugins install @openclaw/feishu # 添加飞书渠道（交互式引导） openclaw channels add# → 选择 Feishu# → 粘贴 App ID# → 粘贴 App Secret# 移除旧的 npm 插件（如果装过） openclaw plugins remove feishu-openclaw 2>/dev/null # 停掉旧的桥接服务（如果用过独立桥接） launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null # 重启网关 openclaw gateway restart

迁移/配置后验证（原文口径）

# 查看日志，确认飞书连接成功 openclaw logs --follow

日志里看到类似 feishu ws connected 或 feishu provider ready，说明连上了。去飞书里给机器人发消息，能正常回复即完成。

如果机器人回复了配对码（一次性安全操作），按原文执行：

openclaw pairing approve feishu <配对码>

迁移后清理（可选）

稳定运行几天后可清理旧文件（原文示例）：

# 删除旧的 launchd 配置（桥接用户）rm -f ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

二、新手从零：配置飞书 AI 机器人（15–20 分钟）

适用人群：第一次用 OpenClaw + 飞书。前提：OpenClaw 已安装并正常运行（原文示例：openclaw gateway status 能看到状态）。

第一步：创建飞书应用（机器人）

  • 打开飞书开放平台 https://open.feishu.cn/app
  • 创建“企业自建应用”，填名称/描述/图标

第二步：启用机器人能力

你的应用 → 应用能力 > 机器人 → 开启 → 命名机器人

第三步：配置权限（批量导入）

你的应用 → 权限管理 → 批量导入 → 粘贴权限 JSON（与上文完全相同）

这里按原文就是“一键导入需要的权限”。

第四步：配置事件订阅（原文强调：必须长连接）

原文警告：这一步必须在 OpenClaw 网关启动后再做，否则保存会失败。你可以先做后面的 OpenClaw 配置，再回来做这一步。
  • 你的应用 → 事件与回调 > 事件配置
  • 请求方式：选择 使用长连接接收事件
  • 添加事件：im.message.receive_v1（接收消息）

第五步：记下凭证

你的应用 → 凭证与基础信息：

  • App ID（cli_xxxxx）
  • App Secret（原文提醒：不要分享）

第六步：发布应用

你的应用 → 版本管理与发布 → 创建版本 → 提交 → 发布/上线（原文说明通常几秒到几分钟）

第七步：在 OpenClaw 中配置飞书

# 1. 安装飞书插件 openclaw plugins install @openclaw/feishu # 2. 添加飞书渠道（交互式，跟着提示走） openclaw channels add# 选择 Feishu → 粘贴 App ID → 粘贴 App Secret# 3. 重启网关 openclaw gateway restart # 4. 查看日志，确认连接成功 openclaw logs --follow

第八步：发消息测试（配对码按原文处理）

飞书里给机器人发“你好”。如果出现配对码：

openclaw pairing approve feishu <配对码>

批准后即可正常对话。

如果你之前跳过了“事件订阅”，现在网关已启动，回去把第四步补上，保存后再 openclaw gateway restart（这是原文提示的流程）。

第九步（可选）：开机自启

原文这里只给了标题说明：让机器人电脑重启后自动上线（具体可结合 OpenClaw 命令 openclaw gateway install，该命令在“常用命令速查”中出现）。

三、常见问题 & 排查清单（按原文最常见坑优先）

1）没有消息发送框？（最常见）

原文结论：事件订阅没有配置。权限批量导入不会自动配置事件订阅。

  • 飞书开放平台 → 你的应用 → 事件与回调
  • 添加事件：im.message.receive_v1
  • 订阅方式：使用长连接接收事件
  • 版本管理 → 创建新版本 → 发布上线

原文提醒：配置事件订阅前，确保 OpenClaw/Clawdbot Gateway 已启动，否则长连接验证会失败。

2）机器人完全没反应（收不到消息）

按原文顺序检查：

  1. 网关在运行吗？不在就 openclaw gateway restart
  2. 飞书应用发布了吗？（版本管理里要有已发布版本）
  3. 事件订阅配置了吗？
    • 是否选择“使用长连接接收事件”（不是 Webhook）
    • 是否添加 im.message.receive_v1
  4. 权限够吗？原文给的最低示例：
    • im:message
    • im:message.p2p_msg:readonly
    • im:message:send_as_bot
  5. 看日志：发消息观察日志是否有反应

3）时断时续（有时回复、有时没反应）

原文给的常见原因与处理：

  • 网络波动（VPN/代理环境尤其容易）：可能频繁断连
  • 网关是否反复重启（原文示例命令）：
openclaw logs |grep -i "restart\\|reconnect\\|disconnect"
  • DNS/代理问题：原文建议确保 open.feishu.cn 走直连（不走代理）

4）发图片/发文件，AI 看不到

按原文：

  1. 检查权限：必须有 im:resource
  2. 补权限后要 创建新版本 → 发布
  3. 重启网关：openclaw gateway restart

5）AI 说生成了图片，但飞书没收到

按原文：

  1. im:resource 权限（用于上传图片到飞书）
  2. 看日志 upload 相关错误

6）群聊中机器人不回复

按原文：

  1. 默认需要 @机器人
  2. 确认机器人已被加到群
  3. 检查 groupPolicy（见进阶配置）

7）回复特别慢

按原文解释：主要由模型响应速度决定；可开启流式输出（默认已开启）；超过 30 秒看日志是否模型调用出错。

8）配对码是什么？怎么用？

按原文：首次出于安全，机器人发配对码，管理员批准一次即可：

openclaw pairing approve feishu <配对码>

9）Lark（国际版）用户怎么配？

按原文，在配置里指定域名：

{"channels":{"feishu":{"domain":"lark"}}}

四、进阶配置参考（配置文件、群组策略、流式、多 Agent）

配置文件位置（原文）

  • ~/.openclaw/openclaw.json

基础配置示例（原文结构）

{"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","accounts":{"main":{"appId":"cli_xxxxxxxxx","appSecret":"你的AppSecret","botName":"我的AI助手"}}}}}

群组配置（原文三种典型）

默认：所有群允许，但必须 @。

指定群无需 @：

{"channels":{"feishu":{"groups":{"oc_你的群组ID":{"requireMention":false}}}}}

只允许特定用户在群里使用（allowlist）：

{"channels":{"feishu":{"groupPolicy":"allowlist","groupAllowFrom":["ou_用户1","ou_用户2"]}}}

原文获取群组/用户 ID 的方式：给机器人发消息后看 openclaw logs --follow。

流式输出（原文默认开启）

{"channels":{"feishu":{"streaming":true,"blockStreaming":true}}}

如要关闭：设 streaming: false。

多 Agent 路由（原文 bindings 示例）

{"bindings":[{"agentId":"main","match":{"channel":"feishu","peer":{"kind":"dm","id":"ou_用户A"}}},{"agentId":"另一个agent","match":{"channel":"feishu","peer":{"kind":"group","id":"oc_某群组"}}}]}

访问控制策略（原文表述）

  • "pairing"：默认，新用户配对码，管理员批准后可对话
  • "allowlist"：仅白名单用户可对话
  • "open"：所有人可对话
  • "disabled"：禁止私聊

常用命令速查（原文）

  • openclaw gateway status：查看网关状态
  • openclaw gateway restart：重启网关
  • openclaw gateway install：安装为开机自启服务
  • openclaw logs --follow：实时日志
  • openclaw pairing list feishu：查看待授权配对
  • openclaw pairing approve feishu <CODE>：批准配对
  • openclaw plugins list：已安装插件列表

五、独立桥接模式（进阶用户才需要）

原文定位：适用于你需要进程隔离（桥接崩溃不影响网关）或有特殊定制需求。大多数用户用官方插件即可。

插件 vs 桥接（按原文对比逻辑复述）

  • 官方插件：openclaw plugins install，和网关同进程，维护随 OpenClaw 更新，适合日常
  • 独立桥接：git clone + npm install，独立进程，互不影响，但需自行维护，适合生产/隔离部署

快速启动（原文命令）

# 克隆项目git clone https://github.com/AlexAnys/feishu-openclaw.git cd feishu-openclaw # 安装依赖npminstall# 配置凭证mkdir -p ~/.clawdbot/secrets echo"你的AppSecret"> ~/.clawdbot/secrets/feishu_app_secret chmod600 ~/.clawdbot/secrets/feishu_app_secret # 启动FEISHU_APP_ID=cli_xxxxxxxxx node bridge.mjs

开机自启（launchd）（原文命令）

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

日志位置（原文）

  • ~/.clawdbot/logs/feishu-bridge.out.log（正常输出）
  • ~/.clawdbot/logs/feishu-bridge.err.log（错误日志）

调试模式（原文）

echo"FEISHU_BRIDGE_DEBUG=1"> .env tail -n 200 ~/.clawdbot/logs/feishu-bridge.err.log

工作原理（原文表达复述）

飞书用户 ↔ 飞书云端 ↔（你的电脑上桥接脚本）↔ OpenClaw 网关
桥接通过飞书 WebSocket 长连接接收消息：不需要公网 IP、不需要域名、不需要内网穿透。

六、快问快答

  • 需要服务器吗？ 不需要。飞书用 WebSocket 长连接，你的电脑直接连飞书云端，不需要公网 IP。
  • 电脑关机了怎么办？ 机器人离线；开机后会自动重连（若配了开机自启）。要 24/7 在线可以用常开设备或云服务器。
  • 飞书免费版能用吗？ 可以。自建应用与机器人功能对所有飞书版本开放。
  • 能同时接其它渠道吗？ 可以。OpenClaw 支持多渠道，互不影响。
  • 用了官方插件后，这个项目还有用吗？ 有：继续提供配置教程、迁移指南、排查与答疑。

如果你接下来想把这篇发到 GitHub README / 公众号 / 飞书文档，我可以在不改动事实与步骤的前提下，给你做两种“同源不同表达”的版本：

  • 极简版（一页纸）：只保留命令、飞书侧必须点的两处、以及“没输入框/不回复/图片不可用”的最短排查
  • 面向小白版：每一步都配“你为什么要点这个/不点会出现什么症状”，但仍严格不超出原文内容

你希望用哪一种发布场景？（GitHub README 更适合极简版；公众号更适合小白解释版。）

Read more

HarmonyOS 5.0物联网开发实战：基于星闪（NearLink）技术的智能家居边缘计算网关

HarmonyOS 5.0物联网开发实战：基于星闪（NearLink）技术的智能家居边缘计算网关

文章目录 * 每日一句正能量 * 前言 * 一、物联网通信技术演进与星闪机遇 * 1.1 传统智能家居痛点 * 1.2 星闪（NearLink）技术架构 * 二、系统架构设计 * 2.1 核心模块划分 * 三、核心代码实现 * 3.1 星闪（NearLink）接入管理 * 3.2 边缘AI推理引擎 * 3.3 智能场景引擎 * 四、网关主界面实现 * 五、总结与物联网价值 每日一句正能量 自律是反人性的，所以，刚开始的几秒，势必会挣扎，打退堂鼓，但只要克服了，之后的神清气爽，会让你感谢自己最初那几秒的坚持。 前言 摘要： 本文基于HarmonyOS 5.0.0版本，

2026年RAG技术路线图：基于DeepSeek与Neo4j知识图谱构建企业智能体系

RAG的演进：为何图检索增强生成（GraphRAG）将主导2026年 检索增强生成（RAG）自问世以来经历了深刻变革，2026年标志着其向图检索增强生成（GraphRAG）范式的关键性转变。这一演进源于传统平面向量型RAG在满足企业级复杂推理和可靠决策支持需求方面日益凸显的局限性。 这一转型的核心驱动力是从平面向量相似性向复杂关系推理的跨越。传统RAG依赖向量嵌入来衡量查询与文档片段的语义相似性，但这种方法无法捕捉企业决策至关重要的实体、概念与事件间的复杂关联。相比之下，GraphRAG将信息构建为包含节点（实体）和边（关系）的知识图谱，使模型能够遍历并推理这些关联——解锁了平面向量RAG无法实现的多跳推理和上下文关系理解能力。 GraphRAG还解决了传统RAG的两大长期痛点：上下文窗口限制和“中间信息丢失”问题。随着企业查询日益复杂，需要更大的上下文窗口来整合相关信息，但即便是最先进的大语言模型（LLM）也存在有限的上下文容量。GraphRAG通过将结构化知识存储在外部图数据库中解决了这一问题，允许模型按需检索最相关的节点和关系，而非将大量文本塞入上下文窗口。此外，“中间信息
仿生新势力：Openclaw开源仿生爪，如何革新机器人抓取？

仿生新势力：Openclaw开源仿生爪，如何革新机器人抓取？

仿生新势力：Openclaw开源仿生爪，如何革新机器人抓取？ 引言 在仓储、农业乃至家庭服务中，机器人如何像猫一样灵巧、自适应地抓取千变万化的物体？这曾是行业难题。如今，一个名为 Openclaw 的开源仿生机械爪项目，正以其独特的被动适应性设计和亲民的成本，在机器人末端执行器领域掀起波澜。本文将深入解析Openclaw的仿生奥秘、实现原理、应用场景及未来布局，带你全面了解这款来自开源社区的“仿生新势力”。 一、 核心揭秘：从猫爪到机械爪的实现原理 本节将拆解Openclaw如何将生物灵感转化为工程现实。 1. 仿生学设计理念 Openclaw的核心灵感源于猫科动物爪部。当猫抓取物体时，其爪趾会自然地包裹贴合物体表面，这种能力主要依赖于其肌腱和骨骼的被动结构，而非大脑的实时精密控制。Openclaw借鉴了这一思想，核心是被动适应性机制。它无需依赖复杂的传感器反馈和实时力控算法，仅凭精巧的机械结构即可根据物体形状自动调整接触点和抓取力，从而极大地简化了控制系统。 配图建议：猫爪与Openclaw的对比图，或Openclaw抓取不同形状物体的动态示意图。 2. 欠驱动与
物业ERP管理系统技术架构解析：2026年如何用快鹭低代码与AI破解行业痛点

物业ERP管理系统技术架构解析：2026年如何用快鹭低代码与AI破解行业痛点

凌晨调试代码时，收到物业经理朋友的紧急求助：其公司管理系统再次崩溃，Excel手工导出的收费报表错误百出，而业主投诉工单已堆积超过200条。这或许是超过60% 物业企业面临的典型技术困境。 在当前物业管理行业平均利润率仅5% 的背景下，传统技术架构已难以支撑企业发展需求。行业数据显示，超六成物业企业仍存在人工对账难、系统扩展性差等问题。本文从技术选型角度，解析2026年物业ERP系统的架构设计与实现方案。 一、行业技术痛点分析 数据孤岛问题成为物业系统最大架构挑战。传统物业系统中，收费、报修、巡检等模块往往独立部署，数据分散在不同系统和文件中，缺乏有效整合机制。据调研，基于传统架构的系统处理一张报修单平均需要48小时以上，而现代微服务架构可将此过程缩短至4小时以内。 系统扩展性不足制约业务创新。当物业企业尝试拓展社区团购、定制服务等新业务时，单体架构的系统往往需要进行大量二次开发。超过50%的数字化项目因架构僵化而无法快速响应业务变化。 技术债累积导致维护成本飙升。许多早期系统基于传统技术栈开发，缺乏完善的文档和模块化设计，新团队成员往往需要较长时间才能理解系统架构。