Clawdbot 官方支持飞书，为构建纯国产化 AI 工作流提供了可能。然而，配置过程中存在一些不易察觉的陷阱。这份指南旨在通过详细的步骤和问题排查，帮助用户顺利完成部署，避开常见的配置难题。
智能速览
Clawdbot 现已支持飞书，可实现纯国产化 AI 工作流。
配置过程常见插件依赖问题，需手动删除旧插件。
遇到 ZOD 依赖缺失时，必须通过全局安装命令解决。
配置需在飞书后台和 Clawdbot 中交替进行，涉及多个步骤。
最终绑定需要通过飞书获取配对码，并在 Clawdbot Web UI 中完成。
精华内容
Clawdbot 官方飞书集成为纯国产 AI 铺平了道路，但配置过程并非一帆风顺。以下是一份避开常见陷阱的实战指南，确保部署过程顺畅。
飞书机器人创建
首先，需要在飞书开发者后台创建一个新的机器人应用。填写应用名称、描述并选择图标后，系统会生成 App ID 和 App Secret 两个关键凭证，这些信息在后续配置中必不可少。接着，进入“权限管理”页面，通过批量导入功能，将官方文档提供的权限配置一键导入，并确认新增所有权限。最后，在“机器人”能力页开启该功能，随意输入一句对话后保存，飞书端的准备工作即告完成。
Clawdbot插件安装
在 Clawdbot 端的配置是难点所在。首先运行 `openclaw channels add` 命令启动安装向导，选择飞书作为连接目标。此时常会遇到“插件已存在”的错误提示，需根据命令行给出的路径，手动删除对应的插件文件夹，然后重新运行命令。另一个更棘手的问题是系统提示“缺少 ZOD 依赖”，这是一个已知的 Bug。正确的解决方法是全局安装 ZOD，执行 `npm install -g zod` 命令，而非在当前目录安装。完成依赖安装后，再次运行添加命令即可继续。
填写凭证与重启
插件安装成功后，向导会要求填写之前在飞书后台获取的 App ID 和 App Secret，并选择连接中国区飞书。所有信息填写完毕后，务必在选项中选择“Finished”才能确认添加。后续的 DM 策略等配置可根据默认选项设置。配置完成后，必须执行 `openclaw gateway restart` 命令重启网关，使所有更改生效。这一步是确保前后端通信正常的关键，不可遗漏。
事件回调与绑定
网关重启后，需返回飞书开发者后台进行最终设置。在“事件与回调”配置中，将订阅方式选为“使用长链接接收事件”并保存。随后，添加“接收消息 v1”事件，这是让机器人能够响应消息的必要条件。完成事件添加后，进入“版本管理与发布”，创建并发布一个新版本，让所有配置正式上线。此时，向飞书机器人发送任意消息，会收到一个配对码。将此配对码复制到 Clawdbot 的 Web UI 聊天框中发送，即可完成最后的绑定。
通过本指南，搭建纯国产化 AI 助手的过程将更加顺畅。Clawdbot 与飞书的结合，为国内用户提供了强大的本地化解决方案。不过在享受便利的同时，数据安全与 Token 管理也是不容忽视的重要一环，值得使用者深入思考。
关键评论
有用户关心本地运行时的记忆持久化问题，询问关闭程序后对话记录是否会丢失。
关于安全性，有用户咨询是否存在数据隔离的有效方法。
有网友指出，全文的重点在于最后一句提醒，即“如果你不担心token的话”，暗示了潜在的风险。
