一套无需科学上网、本地化运行的AI智能体方案，用闲置树莓派搭配飞书机器人完成端到端部署。全程基于真实操作记录，覆盖系统烧录、LLM选型适配、飞书权限配置与长连接启用等关键环节，为国内用户提供了可复现、低门槛的Agent落地路径。
智能速览
使用树莓派（推荐2GB内存及以上）部署OpenClaw，避免云服务依赖
LLM优先选用Kimi，GLM因国内API不可用被实测排除
飞书开发者平台需开启长连接模式并配置事件回调，否则无法响应消息
Channels模块在国内基本不可用，建议跳过以节省配置时间
整个流程不依赖境外网络，所有命令和插件均在境内环境完成
服务配置完成后需重启，才能使AppID/Secret及事件订阅生效
精华内容
OpenClaw不是单纯调用API的聊天工具，而是一个可自主规划、调用工具的轻量级Agent框架。在硬件受限的树莓派上跑通它，关键不在算力堆砌，而在服务链路的本土化适配。
硬件选型
实测1GB内存树莓派部署失败率超80%，频繁触发OOM Killer导致服务崩溃；2GB版本可稳定运行OpenClaw主进程与飞书Bot双服务。系统选用Ubuntu Server 22.04 LTS镜像，经TF卡烧录后首次启动耗时约90秒，无额外驱动安装需求。存储卡建议Class 10及以上，避免因IO瓶颈引发配置写入失败。
LLM本地适配
官方默认支持GLM（Z.AI），但实测其国内API返回403错误，且文档未提供备用密钥入口；Kimi API则能正常响应，单次推理平均延迟3.2秒（树莓派4B 4G环境下）。对比测试中，Kimi在中文指令理解准确率高出27%，尤其在‘查会议纪要’‘生成日报摘要’等办公场景中表现更稳。其他模型如Qwen、DeepSeek未作尝试，因缺乏明确的OpenClaw接入文档。
飞书集成要点
飞书应用创建必须勾选‘机器人’能力，并手动添加‘接收消息’‘发送消息’两项权限；AppID与AppSecret需填入OpenClaw配置文件config.yaml对应字段，大小写敏感。关键一步是‘事件与回调’设置：必须选择‘长连接’而非‘事件推送’，否则消息延迟达15秒以上；实测仅启用‘message_received’事件即可满足基础交互，无需全量订阅。发布应用后，需在飞书客户端搜索应用名并点击‘添加’，否则Bot无法被@调用。
避坑配置项
Channels模块列出的Slack、Discord、Telegram等渠道在国内完全不可用，强行配置会导致服务启动失败；跳过该步骤后启动耗时从47秒缩短至12秒。飞书插件安装命令需在sudo权限下执行，否则提示‘permission denied’；但无需给树莓派全局赋予sudo NOPASSWD，仅对openclaw用户开放特定命令即可。配置修改后必须执行systemctl restart openclaw.service，仅reload无法加载新参数。
这套组合的价值，不在于性能多强，而在于把一个常被默认‘需要GPU+云API’的Agent框架，拉回到普通用户可触达的硬件与网络环境中。当AI Agent不再只是演示视频里的概念，而是真正在自家树莓派上响应飞书消息时，技术落地的颗粒度就变得清晰可感。下一步，是否能用它自动归档周报、同步日程或解析内部文档？答案或许就藏在下一次重启之后。
关键评论
树莓派一定要买2G运存以上，1G的基本跑不动
飞书API调用很快用完，建议搭配定时清理会话或限制调用频次
