树莓派部署 OpenClaw完整清晰步骤整理

本文详细介绍了在树莓派上部署OpenClaw的完整流程。主要包括：1）树莓派基础环境配置；2）OpenClaw本体安装及初始化引导；3）KimiK2.5大模型对接；4）飞书插件配置及权限设置；5）OpenClaw与飞书应用对接。部署过程涉及Node.js环境搭建、国内镜像源配置、API密钥管理、飞书应用权限配置等关键步骤。文章还提供了安全注意事项，建议仅在内网使用，并定期进行安全审计。通过这套方案

m0_60781580

4789人浏览 · 2026-02-28 08:10:58

m0_60781580 · 2026-02-28 08:10:58 发布

树莓派部署 OpenClaw

本次部署基于树莓派系统，包含OpenClaw 本体部署和飞书插件配置两大核心环节，同时集成 Kimi K2.5 大模型对接，步骤如下：

一、前期准备

完成树莓派系统烧录，创建系统用户名和密码并完成基础初始化；
开启树莓派 SSH 功能：首选项 > 控制中心，找到 SSH 选项并启用；
在本地电脑通过 SSH 工具连接到树莓派，进入树莓派终端命令行。

二、OpenClaw 本体安装（按顺序执行命令）

在 SSH 连接的树莓派终端中，逐行执行以下命令，无需修改，全程等待执行完成即可：

# 配置Node.js 22.x源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js
sudo apt install -y nodejs
# 配置npm国内镜像（npmmirror）
npm config set registry https://registry.npmmirror.com
# 下载OpenClaw安装脚本
curl -o openclaw_install.sh -fsSL https://openclaw.ai/install.sh
# 备份hosts文件
sudo cp /etc/hosts /etc/hosts.bak
# 清理hosts中GitHub520相关内容（避免冲突）
sudo sh -c 'sed -i "/# GitHub520 Host Start/Q" /etc/hosts
# 替换安装脚本中的GitHub下载地址为国内镜像（ghfast.top）
sed -i 's|https://github.com/[^" ]*/releases/download|https://ghfast.top/&|g' openclaw_install.sh
# 执行OpenClaw安装脚本
bash openclaw_install.sh

耐心等待安装完成，无报错即进入下一步引导配置。

三、OpenClaw 初始化引导配置（交互式操作）

安装完成后自动进入引导流程，按以下步骤逐一步骤选择 / 输入，按键操作均为方向键 + 回车键，选中为空格键：

1. 安全协议确认

界面提示安全风险，按左方向键选择Yes，按回车键确认；

2. 部署模式选择

进入Onboarding mode，直接按回车键选择默认的QuickStart；

3. 大模型对接配置（Kimi K2.5）

Model/auth provider：按下方向键选择Moonshot AI (Kimi K2.5)，回车键确认；
Moonshot AI (Kimi K2.5) auth method：按下方向键选择Kimi Code API key (subscription)（必须选此选项，避免 Token 消耗过高），回车键确认；
Enter Kimi Coding API key：前往Kimi Code 平台开通 Kimi Code Plan，创建并复制 API Key，粘贴至终端，回车键确认（API Key 获取：https://platform.moonshot.cn/console/account）；
Default model：直接按回车键，保留默认kimi-coding/k2p5；

4. 渠道暂时跳过

Select channel (QuickStart)：按上方向键选择Skip for now，回车键确认（内置飞书插件不完善，后续单独配置社区版）；

5. 技能依赖安装

Configure skills now? (recommended)：直接按回车键选择Yes；
Install missing skill dependencies：按下方向键依次选中clawhub和mcporter（空格键选中，选中后有标记），回车键确认；
Preferred node manager for skill installs：直接按回车键选择默认npm；

6. 无关配置跳过

从Set GOOGLE_PLACES_API_KEY for goplaces?开始，全程按回车键选择No，直至进入钩子配置；

7. 钩子功能启用

Enable hooks?：按下方向键依次选中boot-md和session-memory（空格键选中），回车键确认；

8. 机器人启动模式

How do you want to hatch your bot?：直接按回车键选择Hatch in TUI。

四、机器人首次人设配置（第一轮对话）

进入 TUI 交互界面，为 OpenClaw 配置专属人设，不可跳过 / 糊弄，需依次告知：

机器人的专属名字；
你的名字（机器人对您的称呼）；
你的个人简介（让机器人了解你）；
机器人的人设定位（如 “高效办公助理”“技术开发助手” 等）。配置完成后，输入命令/quit退出 TUI 界面，完成本体初始化。

五、本体部署收尾（环境变量生效）

在终端执行以下命令，使环境变量变更生效，并验证安装成功：

# 环境变量生效
source ~/.bashrc
# 验证OpenClaw命令可用（查看帮助文档）
openclaw --help

终端输出 OpenClaw 命令帮助信息，即代表本体部署完成。

六、飞书插件配置（社区版，适配国内使用）

1. 安装 / 升级飞书社区插件

在树莓派终端执行以下命令：

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
# 升级插件至最新版本（可选，确保兼容性）
openclaw plugins update feishu

2. 飞书开放平台创建自建应用

登录飞书开放平台开发者后台（https://open.feishu.cn/），点击创建应用 > 企业自建应用，填写应用名称 / 描述，完成创建；
进入应用详情页，记录后续需用的App ID和App Secret（在「凭证与基础信息」中获取，妥善保存，切勿泄露）。

3. 飞书应用权限批量导入

进入应用后台「开发配置」>「权限管理」，点击批量导入 / 导出权限按钮；
复制以下 JSON 权限配置，粘贴至导入窗口，点击下一步 > 确认新增权限 > 申请开通：

json

{
    "scopes": {
        "tenant": [
        "bitable:app",
        "bitable:app:readonly",
        "contact:contact.base:readonly",
        "contact:user.base:readonly",
        "docx:document",
        "docx:document.block:convert",
        "docx:document:readonly",
        "drive:drive",
        "drive:drive:readonly",
        "im:chat:readonly",
        "im:message",
        "im:message.group_at_msg:readonly",
        "im:message.group_msg",
        "im:message.p2p_msg:readonly",
        "im:message.reactions:read",
        "im:message:readonly",
        "im:message.recall",
        "im:message.send_as_bot",
        "im:message.update",
        "im:resource",
        "wiki:wiki",
        "wiki:wiki:readonly"
        ],
        "user": []
    }
}

4. 飞书应用事件订阅配置

进入应用后台「事件与回调」>「事件配置」；
点击添加事件订阅，勾选以下 4 个必选事件（飞书机器人核心功能）：
- im.message.receive_v1：接收消息（必需）
- im.message.message_read_v1：消息已读回执
- im.chat.member.bot.added_v1：机器人进群
- im.chat.member.bot.deleted_v1：机器人被移出群
勾选完成后保存，确保所有事件状态为「已开通」。

5. 发布飞书应用版本

进入应用后台「版本管理与发布」，点击创建版本，填写版本号（如 1.0.0），提交发布；

个人测试企业：审核自动通过；
正式企业：需管理员在飞书后台审核通过。

七、OpenClaw 对接飞书应用（关键配置）

1. 配置飞书 App ID/Secret

在树莓派终端执行以下命令，将占位符替换为飞书开放平台获取的真实值：

# 配置飞书App ID
openclaw config set channels.feishu.appId "cli_xxxxx"
# 配置飞书App Secret
openclaw config set channels.feishu.appSecret "your_app_secret"
# 启用飞书插件
openclaw config set channels.feishu.enabled true