1 概述
特别感谢文章作者:王工,辛苦制作的教程,非常适合新人及树莓派爱好者学习使用!本教程主要介绍在树莓派5上部署OpenClaw(龙虾)的背景和适用范围。
1.1 背景
为了让用户能够顺利在树莓派5上运行大模型集成工具,本指南提供了一套标准化的部署流程。涵盖了从第三方API获取、飞书应用配置,到本地系统环境搭建(树莓派5)、节点接入以及最终在客户端配对验证的全过程。
1.2 适用范围
本应用主要适用于树莓派5,依赖于Node.js环境运行。
2 应用指导
介绍获取MiniMax API凭证、配置飞书开放平台和在树莓派上安装并配置OpenClaw的具体操作步骤。
2.1 获取MiniMax API Key
操作步骤:
1.进入MiniMax官网注册并登录:
platform.minimaxi.com/login?redirect=%2Fuser-center%2Fbasic-information。
2.点击“创建新的API Key”,并复制保存好点击后生成的密钥。
注意: 请注意不要与他人共享您的API密钥,或将其暴露在浏览器或其他客户端代码中。MiniMax会送15元代金券,可以直接用于token消费。
2.2 配置飞书开放平台
2.2.1 获取飞书应用凭证
在飞书开放平台建立企业自建应用,作为交互前端。
操作步骤:
1.进入飞书开放平台的开发者平台:open.feishu.cn/app?lang=zh-CN。
2.点击“创建企业自建应用”。
3.按照页面提示,自行填写应用名称、应用描述和应用图标等信息后进行创建。
2.2.2 飞书权限管理
为新建的应用开通对应的通讯录和消息权限。
操作步骤:
1.在侧边栏里面找到“权限管理”一项,然后点击进入。
2.点击“批量导入/导出权限”,将对应的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"]}}
2.2.3 机器人配置
操作步骤:
1.在侧边栏里面找到“机器人”一项并点击进入。
2.点击修改图标,设置机器人名称,然后点击保存即可。
2.3 系统环境与依赖下载
在树莓派上准备必要的网络与Node.js环境。
操作步骤:
1.若有代理需先挂代理,如在终端执行:export http_proxy=http://192.168.8.8:20171 以及 export https_proxy=http://192.168.8.8:20171,请根据您的代理进行替换操作。
2.进入Node.js官网 nodejs.org/en/download 准备下载。
3.分别选择Linux、nvm、npm,一步一步来执行安装命令。
2.4 安装并配置OpenClaw
环境配置完成后,拉取并安装主程序。
操作步骤:
1.进入OpenClaw中文社区官网: clawd.org.cn/#install。
2.选择国内镜像,进行一键安装。
3.在终端根据引导完成OpenClaw的初始化对接。
4.当系统询问存在风险是否继续时,选择 yes。
5.安装引导模式选择“快速开始”。
6.模型选择“MiniMax”。
7.认证方式选择“MiniMax API key”,并直接输入在MiniMax官网生成的API key。
8.MiniMax模型选择“MiniMax M2.5”。
9.提供商筛选模型选择“minimax”。
10.默认模型选择“保持当前”。
11.选择通道时,选择“飞书(Lark开放平台)”一项。
12.安装飞书插件时,选择“飞书官方插件”。
13.打开飞书开放平台首页,找到右上角开发者后台,进入“凭证与基础信息”页面获取 App ID 和 App Secret,将这两项直接复制输入到终端的对应位置。
14.Which Feishu domain,选择“Feishu(feishu.cn)”。
15.Group chat policy - which groups can interact with the bot, 选择“Allowlist only groups listed in groups config (default)”。
16.Group sender allowlist which users can trigger the bot in allowed groups? (user open_ids),直接按Enter键。
17.提示“现在配置技能”时选择 yes。
18.技能安装的首选节点管理器选择 npm。
19.启用钩子选择“暂时跳过”。
20.您想如何孵化您的机器人,选择“在TUI中孵化”。
2.5 飞书后续配置
2.5.1 飞书事件与回调
在飞书开放平台的侧边栏里面找到“事件与回调”一项并点击进入。
操作步骤:
1.选择“使用长连接接收事件”,然后保存。
2.在下方的已添加事件中点击“添加事件”,搜索 im.message.receive_v1 一项,然后点击添加即可。
2.5.2 创建版本
配置完毕后进行发布。
操作步骤:
1.划到页面顶部,找到创建版本提示。
2.根据自己的情况填写内容。
3.点击保存,确认发布即可。
2.5.3 飞书应用内配置与配对
完成开放平台发布后,需要在飞书客户端内进行最终的配对验证。
操作步骤:
1.打开应用: 打开飞书客户端(以桌面版为例),在左侧边栏选择“消息”。在消息列表中找到“开发者小助手”,打开聊天框,查看应用审批通过的消息,点击“打开应用”。
2.获取配对指令: 进入刚刚创建的机器人(如OpenClaw)聊天界面,发送任意一条消息(例如:“你好”)。机器人会回复一条提示配置的消息(提示“访问未配置”及包含配对码)。
3.执行配对: 复制机器人回复的最后一行审批命令(格式如:openclaw-cn pairing approve feishu [配对码])。
4.完成部署: 打开一个新的终端,将该命令粘贴到该终端内并执行。等待命令运行结束,再在机器人(如OpenClaw)聊天界面发送一条消息,此时机器人会正常回复。
3 Raspberry Pi5 + ED-Pi5Case-O
ED-Pi5Case-O 是上海晶珩(EDATEC)专为树莓派 5 量身打造的高品质铝合金被动散热外壳,可实现高效静音散热,充分保障树莓派 5 设备全天候稳定运行,是 OpenClaw 本地部署的理想硬件搭档。
1.极致静音,高效散热
ED-Pi5Case-O 采用了顶盖与底盖双面被动散热设计。通过导热硅胶垫结合铝制机身,无需风扇等移动部件即可实现高效散热,CPU 温度最高可降低 15℃,彻底告别噪音与风扇积灰烦恼,降低功耗的同时保障设备全天候稳定运行。
2.信号满格,无界拓展
精心设计的开放式架构,确保树莓派 5 强大的 Wi-Fi 与蓝牙无线连接信号不受干扰。同时,树莓派 5 的所有接口均完全暴露,插拔线缆或扩展设备极其方便。
3.CNC 工艺,坚固质感
外壳采用高质量铝合金 CNC 切割与表面氧化工艺制造,不仅坚固耐用,更为您的桌面或工业现场增添了一抹专业、简洁的科技美感。
关于上海晶珩
致力于为 Raspberry Pi 提供兼顾极致美学与工业可靠性的专业配件与解决方案。
本期推荐组合:
Raspberry Pi 5:强劲的边缘计算核心,满足您对智能硬件的一切想象。
ED-Pi5Case-O:专为树莓派 5 量身打造的高品质铝合金被动散热外壳,提供黑色与银色双色可选。
即刻升级您的本地 AI 硬件装备: 欢迎访问 www.edatec.cn 或联系我们获取更多产品详情 。
如果你想了解更多关于 OpenClaw 的文章,可以查看下面内容:
解锁超强组合!树莓派5 + OpenClaw(ClawdBot)能产生哪些玩法?
用 OpenClaw 将树莓派变身人工智能代理!
树莓派 CM0 NANO + OpenClaw + 飞书:打造我的7x24小时 AI 秘书!
在树莓派CM0上部署 Clawdbot 真的有那么神奇吗?
2026年 OpenClaw 最佳硬件配置方案!
抛开 OpenClaw 炒作:谈谈我那套基于树莓派7×24小时自托管的AI代理团队!
比 OpenClaw 快 400 倍、省 99% 内存!在树莓派CM0上部署 ZeroClaw !
启动时间不到1秒!比OpenClaw省99%内存!在树莓派CM0上部署 PicoClaw!
只知道龙虾?盘点那些可在树莓派等设备上运行的 OpenClaw 替代方案!
实用设置指南!如何在树莓派上运行OpenClaw?
我尝试在树莓派5上实现 OpenClaw 自主学习!
我用 Openclaw 将树莓派4变成 AI 智能体!
官方网站:https://edatec.cn/zh/cm0
淘宝店铺:https://edatec.taobao.com/
330