树莓派5部署OpenClaw完全指南：从零搭建AI机器人

概述

本指南旨在提供一个在树莓派5上部署OpenClaw（又称“龙虾”）的标准化流程。此流程涵盖了从获取第三方API密钥、配置飞书应用，到在树莓派5本地搭建系统环境、接入节点以及最终在客户端完成配对验证的全部关键步骤，适合初次接触该项目的用户和树莓派爱好者参考实践。

背景与目的

为了让用户能够顺利地在树莓派5这一小巧但功能强大的硬件上运行集成化的大模型工具，本教程整理了一套详细的操作步骤。它致力于解决在边缘计算设备上部署AI应用时可能遇到的环境配置与平台对接问题。

适用范围说明

本部署方案主要针对树莓派5设备。其运行依赖于Node.js环境，因此请确保您的树莓派系统已具备或可以安装相应的Node.js版本。

详细应用部署指导

以下将分步介绍如何获取MiniMax API凭证、配置飞书开放平台应用，并在树莓派5上安装及配置OpenClaw主程序。

获取MiniMax API密钥

首先，您需要从MiniMax平台获取调用其大模型服务的API密钥。

操作步骤如下：

1. 访问MiniMax官方网站并完成注册与登录。
2. 登录后，在用户中心找到创建API密钥的选项。
3. 点击“创建新的API Key”按钮，系统将生成一串密钥，请立即复制并妥善保存。

重要提示：此API密钥是访问您账户下AI服务的凭证，请勿与他人共享或将其暴露在网页前端代码中，以防被盗用。新注册用户通常可获得一定额度的代金券，可用于直接抵扣API调用产生的费用。

配置飞书开放平台应用

OpenClaw需要通过飞书机器人与用户交互，因此需要在飞书开放平台创建一个企业自建应用。

创建应用并获取凭证

1. 打开飞书开放平台开发者后台。
2. 点击“创建企业自建应用”按钮。
3. 根据页面指引，填写应用名称、描述，上传图标等信息，然后完成创建。

为应用添加必要权限

创建应用后，需要为其开通相应的通讯录与消息收发权限。

1. 在应用管理页面的侧边栏中，找到并进入“权限管理”页面。
2. 选择“批量导入/导出权限”功能。
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”    ]  }}

配置机器人信息

1. 继续在侧边栏找到并进入“机器人”功能页面。
2. 点击修改图标，为机器人设置一个名称，然后保存配置。

准备树莓派系统环境与依赖

在树莓派5上，我们需要确保网络通畅并安装必要的运行环境。

操作步骤：

1. （可选）如果您的网络环境需要通过代理访问外网，请在终端中设置代理环境变量，例如：export http_proxy=http://您的代理IP:端口 和 export https_proxy=http://您的代理IP:端口。请根据实际情况替换IP和端口。
2. 访问Node.js官方网站，准备为树莓派（Linux ARM架构）下载安装包或安装脚本。
3. 推荐使用nvm（Node Version Manager）来管理Node.js版本。请按照官网指引，依次执行安装nvm和Node.js的命令。

安装并配置OpenClaw主程序

当Node.js环境就绪后，即可开始安装OpenClaw。

操作步骤：

1. 访问OpenClaw中文社区官网，查看安装指南。
2. 为了获得更快的下载速度，建议选择国内镜像源进行一键安装。
3. 打开树莓派的终端，根据安装脚本的引导开始初始化OpenClaw。
4. 当安装程序提示存在潜在风险时，输入 yes 继续。
5. 在引导模式选择中，选取“快速开始”以简化配置。
6. 模型供应商选择“MiniMax”。
7. 认证方式选择“MiniMax API key”，并将之前获取的密钥粘贴输入。
8. 具体模型选择“MiniMax M2.5”。
9. 在提供商筛选模型中，确认选择“minimax”。
10. 默认模型选择保持当前选项即可。

11. 选择通信通道时，找到并选择“飞书(Lark开放平台)”。
12. 安装飞书插件时，选择“飞书官方插件”。

13. 此时，需要返回飞书开放平台。在开发者后台首页，进入“凭证与基础信息”页面，获取 App ID 和 App Secret，并将它们分别复制粘贴到终端提示的对应位置。

14. 选择飞书域名区域，通常选择“Feishu(feishu.cn)”。
15. 设置群聊策略，选择“仅允许在群组配置列表中列出的群组（默认）”。
16. 设置群聊发件人白名单时，如需允许所有用户，可直接按Enter键跳过。

17. 当提示是否现在配置技能时，选择 yes。
18. 首选节点包管理器选择 npm。
19. 启用钩子功能可选择“暂时跳过”。

20. 最后，选择如何启动机器人，建议选择“在TUI中孵化”以在终端界面中运行。

完成飞书平台的后续配置

配置事件与回调

为了让飞书机器人能接收消息，需要配置事件订阅。

1. 在飞书开放平台应用管理的侧边栏，进入“事件与回调”页面。
2. 选择“使用长连接接收事件”模式，并保存设置。
3. 在“已添加事件”区域，点击“添加事件”，搜索并添加 im.message.receive_v1（接收消息v1）权限。

创建并发布应用版本

1. 返回应用概览页，找到“创建版本”的提示或按钮。
2. 根据要求填写版本号、更新日志等信息。
3. 点击保存并提交发布申请，等待审核通过（企业自建应用通常为秒级通过）。

在飞书客户端内完成配对

应用发布后，需要在飞书客户端内进行最后的激活与配对。

1. 打开应用：在飞书客户端（以桌面版为例）的消息列表中，找到“开发者小助手”发来的应用审核通过通知，点击“打开应用”。
2. 获取配对码：进入您刚创建的机器人（如OpenClaw）的聊天界面，发送任意消息（例如“你好”）。机器人会回复一条包含配对码的配置提示消息。
3. 执行配对命令：复制机器人回复的最后一行命令（格式类似 openclaw-cn pairing approve feishu [配对码]）。
4. 完成验证：在树莓派上运行OpenClaw的终端中，粘贴并执行上述配对命令。等待命令执行成功后，返回飞书聊天窗口再次发送消息，机器人应当能正常回复，标志着部署成功。

硬件搭配建议：Raspberry Pi 5 + ED-Pi5Case-O

为了保障树莓派5在长时间运行OpenClaw时的稳定与静音，一款优秀的外壳至关重要。ED-Pi5Case-O 是一款专为树莓派5设计的铝合金被动散热外壳，其特点包括：

• 高效静音散热：采用顶盖与底盖双面导热设计，通过导热硅胶垫将CPU等关键热量传导至整个金属机身散发，无需风扇即可实现高效降温，最高可降低CPU温度约15℃，真正做到零噪音运行。
• 全接口暴露与信号优化：开放式结构设计，确保树莓派5的所有接口（包括GPIO、USB、网络等）均可无障碍使用，同时不影响其Wi-Fi与蓝牙信号的传输强度。
• 坚固耐用工艺：采用CNC精密加工与表面阳极氧化处理，不仅坚固可靠，也呈现出简洁专业的视觉质感。

将性能强劲的树莓派5与这款专注于散热与可靠性的ED-Pi5Case-O外壳相结合，能够为OpenClaw这类持续运行的AI应用提供一个理想的本地硬件基础。