4.2 安装飞书插件

npm install -g @overlink/openclaw-feishu

4.3 配置飞书应用权限

开通必要权限：

1. 在飞书开发者后台，进入应用详情页
2. 点击左侧菜单"权限管理"
3. 开通以下核心权限：
   • im(message:send_as_bot)：发送消息
   • im(message:receive_v1)：接收消息
   • contact(user:base:readonly)：获取用户基础信息
   • im(message:group_at_msg:readonly)：接收群聊@消息
   • im(message:pins:write_only)：管理消息置顶

添加机器人能力：

1. 在应用详情页左侧菜单，选择"添加应用能力"
2. 添加"机器人"能力

4.4 配置飞书回调事件

启用长连接模式：

1. 在飞书开发者后台，进入"事件与回调"页面
2. 在"订阅方式"中选择"使用长连接接收事件"（WebSocket模式）

添加消息接收事件：

1. 在"事件配置"中点击"添加事件"
2. 搜索并添加 "im.messagereceive_v1" 事件
3. 保存配置

4.5 配置OpenClaw飞书插件

通过命令行配置： openclaw config set channels.feishu.appId "你的App ID" openclaw config set channels.feishu.appSecret "你的App Secret" openclaw config set channels.feishu.enabled true

或者通过Web控制台配置：

1. 登录OpenClaw Web控制台
2. 导航到"渠道"（Channels）页面
3. 找到飞书（Feishu）配置项
4. 填入App ID和App Secret
5. 点击"保存"并重启网关服务

4.6 重启OpenClaw服务使配置生效

openclaw gateway restart

五、将飞书机器人添加到群聊

5.1 添加机器人到群聊

1. 在飞书客户端，打开目标群聊
2. 点击右上角的"..."图标，选择"设置"
3. 进入"群机器人"页面
4. 点击"添加机器人"，搜索并选择您创建的应用机器人
5. 点击"添加"完成添加

注意：机器人只能被添加到同一企业下的群聊，外部群无法添加

5.2 首次消息配对授权

1. 在群聊中@飞书机器人，发送消息（如"你是谁"）

2. 机器人会回复一个配对码和飞书Open ID

3. 在OpenClaw终端中执行授权命令（替换为实际收到的配对码）： openclaw pairing approve feishu

4. 授权成功后，再次在飞书中发送消息，即可与OpenClaw AI助手正常交互

六、验证与故障排查

6.1 服务状态验证

检查OpenClaw网关和飞书渠道状态： openclaw status # 应看到网关运行状态 openclaw channels status # 应看到飞书渠道已连接

6.2 飞书消息交互测试

1. 在飞书中@机器人发送消息，如"你好"
2. 如果AI助手正常回复，则配置成功
3. 如果AI助手未回复，检查以下问题：

6.3 常见问题排查

问题1：飞书机器人无法接收消息

解决方案：

1. 检查飞书应用权限是否开通
2. 确认事件订阅是否包含"im.messagereceive_v1"
3. 检查订阅方式是否为"长连接"
4. 在飞书开发者后台重新发布应用版本
5. 检查OpenClaw网关是否正常运行

问题2：消息延迟严重

解决方案：

1. 确保飞书应用使用的是"长连接"而非"事件推送"模式
2. 检查网络连接是否稳定
3. 确认飞书应用已正确发布到线上

问题3：OpenClaw服务崩溃

解决方案：

1. 检查系统内存使用情况（树莓派5需至少4GB可用内存）

2. 查看服务日志定位问题： openclaw logs --follow # 实时查看日志

3. 执行诊断命令检查配置： openclaw doctor # 自动诊断常见问题

4. 如有必要，重启网关服务： openclaw gateway restart --force # 强制重启网关

七、高级配置与优化

7.1 启用内存优化

为树莓派5配置swap交换空间（防止内存不足崩溃）： sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile 添加到/etc/fstab实现开机自动挂载 echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

7.2 启用技能（Skills）

安装常用技能： openclaw skills install shell-execution # 终端命令执行 openclaw skills install file-system # 文件系统操作 openclaw skills install web-search # 网页搜索

启用技能： openclaw skills enable shell-execution openclaw skills enable file-system openclaw skills enable web-search

7.3 配置安全访问

设置网关访问密码： openclaw config set gateway.auth.token "你的安全Token"

限制访问IP范围：

1. 在防火墙中限制对18789端口的访问
2. 仅允许您本地网络的IP访问

八、总结与使用建议

部署成果：通过本教程，您已成功在树莓派5上部署了一个本地化运行的OpenClaw汉化版AI助手，并通过飞书机器人实现了与AI助手的交互。

使用建议：

1. 定期更新：关注OpenClaw和飞书开发者平台的更新，及时升级
2. 模型选择：根据使用场景选择合适的AI模型，如需要中文处理能力，百度Qianfan或阿里Qwen是不错的选择
3. 安全配置：避免在OpenClaw中绑定生产级敏感账号，建议使用受限的API Key或临时Token
4. 技能管理：按需安装和管理技能，不要安装来源不明的第三方技能
5. 定期备份：定期备份OpenClaw的配置文件和数据，避免配置丢失

通过这个部署，您可以在不依赖云服务的情况下，拥有一个专属的AI助手，通过飞书进行交互，实现办公自动化、信息查询、文件处理等多种功能。树莓派的低功耗特性使其能够7x24小时持续运行，为您的工作和生活带来便利。

祝您的OpenClaw+飞书部署之旅顺利！