LOADING

加载过慢请开启缓存 浏览器默认开启

搭建"氤"——树莓派 AI 助手全流程记录

搭建”氤”——树莓派 AI 助手全流程记录

硬件清单

  • 主机:Raspberry Pi 5,Debian 13 (Trixie) + KDE Plasma 6 (X11)
  • 存储:三星 MZALQ128HBHQ NVMe 128GB(外置,加散热片)
  • UPS:Waveshare UPS HAT (E),4S 锂电

一、系统初始化

基础系统安装后配置了以下内容:

  • 中文输入法:fcitx5
  • 系统设置:永不锁屏休眠
  • VNC:用于远程桌面

第一步:一键下载与安装 OpenClaw

在树莓派终端输入官方的一键安装命令。由于树莓派 5 性能强劲,跑这个编排层非常轻松:

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动检测你的 RPi5 系统架构(Linux ARM64)并下载对应的编译版本。安装完成后,它会引导你进入一个交互式配置向导(Onboarding Wizard)。在向导中,系统会询问你是否要以守护进程运行。强烈建议选择 **--install-daemon**(或者选 Yes),这样 OpenClaw 就会被注册为 systemd 系统服务,以后树莓派开机它就自动在后台保活。

第二步:为 OpenClaw 配置“大脑”(大模型后端)

OpenClaw 本身是一个执行框架(会帮你敲命令、写文件、调工具),它需要接入一个大语言模型(LLM)来做思考和决策。作为全栈方向的同学,你可以根据自己的习惯二选一:

选项 A:对接云端 API(最推荐,省资源)

如果你手头有 DeepSeek、Claude (Anthropic) 或 OpenAI 的 API Key,在刚刚的向导里直接选对应的 Provider 并填入 Key 即可。

选项 B:完全本地化运行(基于 Ollama)

如果你想把开源进行到底,让树莓派完全独立运行,可以直接在终端里给树莓派装个本地大模型引擎:

  1. 安装 Ollama

    curl -fsSL https://ollama.com/install.sh | bash
    
  2. 拉取适合 RPi5 跑的轻量模型(推荐 3B 左右的模型,既能跑动又有基本的逻辑):

    Bash

    ollama run llama3.2:3b
    
  3. 在 OpenClaw 的配置里,将大模型地址指向本地的 localhost 地址。

这里我直接接入DeepSeek了,大赞美,便宜好用上下文大,DS蜜汁v4 Pro,既实惠还管饱。然后视图模型找好哥们Hanfy借的,这里感谢一下,有定制Rom或者刷机需求可以找他 :Hanfy https://www.coolapk.com/u/22142068

第三步:安全防线

部署完后有一点非常重要:OpenClaw 默认会拥有执行 Shell 命令的权限。请务必检查并确保 OpenClaw 的外部网关(如对接 Telegram / Discord 机器人或 Web 控制面板)配置了严格的账号白名单(ID Whitelist)**,防止别人通过公网接口对你的 Agent 进行提示词注入攻击。

二、网络打通

公网访问链路设计如下:

用户 → 域名→ 阿里云ECS (nginx反代)→ SSH反向隧道 → 树莓派 OpenClaw Gateway→ frp隧道 → Minecraft/MCSM/Web

  • SSH 反向隧道:autossh 守护,注册为 systemd 用户服务 openclaw-tunnel.service
  • frpc:systemd 系统服务,连接阿里云 frps
  • Gateway:OpenClaw Gateway,openclaw-gateway.service

三、优化升级

树莓派先更新。更新后风扇策略我也做了一点调整:

原: 40°C → 45°C → 50°C → 60°C
新: 35°C → 40°C → 45°C → 55°C

夏天嘛 > Q <

NVMe 优化方面:vm.swappiness=10vm.vfs_cache_pressure=50,脏页写回间隔拉长,减少 SSD 写入频率。

不然真的烫手

然后装一些skill,自己调教一下,总的来说还是蛮好玩的><

这里给出我装的skills:

📦 github — GitHub 管理
📦 himalaya — 邮件客户端
📦 humanizer — 文本润色/去AI味
📦 notion — Notion API
📦 powerpoint-pptx — PPT 制作
📦 qq-mail-sender — QQ 邮件发送
📦 self-improving-agent — 自我学习记录
📦 skill-creator — 创建新 skill
📦 superdesign — 前端设计指南
📦 video-frames — 视频帧提取

四、开源

UPS HAT 的 KDE plasma 集成方案已发布到 GitHub:BlueEve04/Waveshare_UPS_Hat_E-Battery-KDE_Plasma 也是我让这个Claw小氤自己写的,蛮好玩的,包含内核模块源码、Python 守护进程、systemd 服务、一键安装/卸载脚本,开箱即用,装完之后就不用用Waveshare自己那个挺丑的KDE还用不了的电池py脚本了ww

五、开销

弄了好多东西其实也就花了30左右估算下来如果我这个样子轻量使用大概一周50以内(稳定了应该还会更少)