手把手教程：用Python将十年前的树莓派1B+接入飞书机器人

最近网上掀起了一股“龙虾”热，到处都在讨论安装、部署各种Claw项目。我关注得比较早，春节期间就注意到了。

最开始看到新闻，说是因为“养龙虾”，把二手的Mac mini都炒涨价了。我当时感觉事不关己，因为手头没有Mac mini，也不想为此专门购买，就没太在意。

后来，各种变体的“龙虾”层出不穷，什么NanoClaw、ZeroClaw、GoClaw、CoPaw、LobsterAI、Kimi Claw等等。我盯上了ZeroClaw，因为它是用Rust语言编写的，据说占用内存只有10MB左右。这下我动心了，翻出了十几年前买的树莓派1B+，准备试一下！

结果折腾了一天，虽然装上了，但得到的只是一个基础聊天机器人。不知是权限问题，还是我的树莓派1B+配置实在太低，我让它创建个脚本，死活不行。它只能聊天，没什么实际技能…

过了几天没忍住，又在电脑的虚拟机上尝试了一次，这次成功了。创建文件、写脚本、接入飞书，统统没问题。但看着空空如也的技能列表，我忽然意识到，没有生态支持，它终究只是个聊天机器人，实用性不大。

于是，我转而研究起飞书机器人。它开放的平台和清晰的文档吸引了我，最关键的是，可以轻松接入像树莓派这样的嵌入式设备。结合一些 Python 脚本，完全能实现用手机控制各种硬件。说干就干，我真的把这块吃灰近十年的树莓派1B+成功接入了飞书。

以下是具体的实现步骤：

第一步：注册并进入飞书开放平台

首先，访问飞书开放平台并注册/登录账号：
https://open.feishu.cn/?lang=zh-CN

第二步：找到官方教程

在平台内，导航至：开发文档 -> 开发教程 -> 开发一个自动回复机器人。

第三步：跟随“三分钟快速开发”向导

这里有非常详尽的“手把手”教程。核心流程如下图所示，你需要依次完成“创建应用”、“创建版本并发布”、“运行代码”、“体验和试用”四个步骤。

在这个过程中，你会在飞书后台创建一个机器人应用，相关权限（如读取用户消息）会自动配置好。发布版本后，在你的飞书手机端就能看到这个机器人了。

建议先在Windows或Mac电脑上测试一遍，感受效果。在“运行代码”步骤，我选择了Python环境。根据教程下载源码，复制对应的启动指令（Windows或Mac/Linux）到终端运行即可。

PC端程序启动后，效果如下（终端里显示了接收到的消息事件）：

程序首次启动可能需要一两分钟，耐心等待即可。

第四步：将代码上传至树莓派

在电脑上测试成功后，就可以移植到树莓派了。我使用MobaXterm通过SSH连接树莓派，它自带SFTP功能，上传文件很方便。
注意：只需要上传从官方下载的代码包中的 lark-samples-main\echo_bot\python 这个文件夹。

第五步：在树莓派上安装依赖并运行

将文件夹上传到树莓派后，通过SSH进入该目录。你需要使用Linux/Mac的启动指令，在飞书教程页面重新获取。

直接运行 ./bootstrap.sh 脚本可能会遇到如下错误：

这个错误是由于Debian 12（树莓派OS基于此）引入了PEP 668外部环境管理保护机制。解决方法是为项目创建独立的Python虚拟环境：

# 在项目目录下创建虚拟环境
python3 -m venv venv
# 激活虚拟环境
source venv/bin/activate
# 安装飞书开放平台SDK
pip install lark-oapi

安装过程如下图所示：

依赖安装完成后，在激活的虚拟环境中，再次运行从飞书平台获取的启动指令（该指令已设置好了必要的环境变量）。服务启动后，就可以与你的机器人对话了。

树莓派服务端日志：

手机飞书客户端对话效果：

至此，这块闲置了近十年的树莓派1B+板子，成功“再就业”，变成了一个能接收和回复消息的飞书机器人。其核心原理就是通过飞书开放平台的服务端SDK，在 嵌入式设备 上建立一个常驻服务，处理 接收和回复消息 的请求。

后续完全可以结合更多的Python脚本，让它不仅能回声回复，还能执行查询设备状态、控制GPIO引脚等任务，实现简单的自动化代理功能。

“龙虾”虽好，但现阶段玩透它还需要一定的资源和精力。不妨先从这种更直接、文档齐全的官方接入方案开始，亲手让旧设备焕发新生，成就感也是满满的。如果你对树莓派、Python自动化或云栈社区上的其他物联网项目感兴趣，不妨动手试试，整个过程本身就是一次很棒的学习体验。