树莓派 4B 8GB 部署 Hermes Agent：开源 AI 智能体，带持久记忆的个人助手

在上一篇教程中，我们介绍了如何在树莓派上部署 OpenClaw。今天带来另一个同样优秀的开源 AI 智能体框架——Hermes Agent，由 Nous Research 开发。

Hermes Agent 的核心特色是持久记忆系统和自进化技能体系。它像你的私人助理一样，能记住你的偏好、之前的对话、常用的工作流，并且随着使用越来越了解你。Hermes 支持 20+ 种 LLM 提供商（OpenRouter、Anthropic、OpenAI、DeepSeek 等），可以在终端、桌面应用、Web 面板甚至 Telegram/Discord 等消息平台上使用。

🌿 Hermes Agent 的独特之处：自带 FTS5 全文搜索的记忆引擎，跨会话持久记忆；Skills 技能系统会自动维护和优化；支持 20+ 消息平台作为 Gateway 网关运行。

一、硬件和软件准备

物品 规格要求 备注
树莓派 4B 4GB / 8GB 本文使用 8GB 版本
MicroSD 卡 16GB 以上 建议 32GB+，或 USB SSD 更佳
操作系统 Raspberry Pi OS (64-bit) 必须 64 位！
Python 3.11+ Raspberry Pi OS 自带
网络 以太网或 WiFi 需访问 GitHub 和 API 服务
💡 与 OpenClaw 的区别：Hermes 安装基于 Python（通过 uv 管理），而 OpenClaw 基于 Node.js。两者可以在同一台 Pi 上共存，但请注意资源消耗。
1

安装 Raspberry Pi OS（如果还没装）

下载 Raspberry Pi Imager，选择：

  • Raspberry Pi OS (64-bit) —— Full（带桌面）或 Lite（无桌面）均可
  • 建议提前在 Imager 的高级设置中启用 SSH、设置主机名和密码

烧录完成后插入 Pi，通电开机。

2

连接并更新系统

有桌面 → 直接打开终端（Ctrl+Alt+T）。
无桌面 → 用 SSH 连接：

$ ssh pi@hermes-pi.local

更新系统：

$ sudo apt update && sudo apt upgrade -y $ sudo apt install -y git curl build-essential python3-pip $ sudo timedatectl set-timezone Asia/Shanghai
3

安装 uv（Python 包管理器）

Hermes 使用 uv 来管理 Python 环境和依赖。先安装 uv：

$ curl -LsSf https://astral.sh/uv/install.sh | sh

重新加载 shell 配置使 uv 命令生效：

$ source ~/.bashrc $ uv –version uv x.y.z
4

安装 Hermes Agent

使用官方一键安装脚本（推荐，会自动处理 venv 和启动脚本）：

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后，验证是否成功：

$ hermes –version
💡 安装说明：安装脚本会自动在当前目录下创建一个 venv 虚拟环境，安装 Hermes 以及所有依赖。整个过程大约需要 2-5 分钟，取决于你的网络和树莓派的处理速度。
5

运行设置向导

初次使用需要配置模型提供商和 API Key：

$ hermes setup

或者直接用模型选择器快速配置：

$ hermes model

支持的提供商包括（选择你最常用的一个）：

提供商 环境变量 推荐模型
OpenRouter OPENROUTER_API_KEY 多种模型可选
Anthropic ANTHROPIC_API_KEY claude-sonnet-4
OpenAI OPENAI_API_KEY gpt-5.4-mini
DeepSeek DEEPSEEK_API_KEY deepseek-chat
Google Gemini GOOGLE_API_KEY gemini-2.5-flash

你也可以手动编辑配置文件来设置 API Key：

$ hermes config env-path /home/pi/.hermes/.env

然后用 nano 编辑这个文件，添加你的 API Key：

$ nano ~/.hermes/.env # 添加以下内容（根据你的提供商选择一项）： OPENAI_API_KEY=sk-your-key-here # 或 ANTHROPIC_API_KEY=sk-ant-your-key-here # 或 DEEPSEEK_API_KEY=sk-your-deepseek-key

完成后保存（Ctrl+X → Y → Enter）。

6

开启持久记忆（Hermes 的核心特色）

Hermes 最强大的功能之一就是它的跨会话持久记忆。开启方式：

$ hermes memory setup

这个命令会启用内置的 FTS5 记忆引擎，对话中的关键信息会自动保存，并在未来的会话中召回。

验证记忆是否正常工作：

$ hermes chat -q “记忆：我的名字是小明，我喜欢编程和树莓派” $ hermes chat -q “我叫什么名字？” 你的名字是小明。😊
🌿 记忆是如何工作的？ Hermes 的记忆分为两层：
1️⃣ memory 工具 —— 主动保存的持久事实（用户偏好、关键信息）
2️⃣ session_search —— FTS5 全文搜索历史对话，靠 SQLite 索引直接检索，不消耗 Token
7

启动交互会话

现在你可以直接在终端中与 Hermes 对话了：

$ hermes

这会启动交互式聊天界面。尝试一些命令：

  • /help —— 查看所有可用的斜杠命令
  • /model claude-sonnet-4 —— 切换模型
  • /new —— 开始新会话
  • /quit —— 退出

单次查询模式（适合脚本和自动化）：

$ hermes chat -q “树莓派 4B 的最高频率是多少？”
8

安装为 Gateway 服务（24 小时后台运行）

如果你想让 Hermes 像 OpenClaw 一样作为持久守护进程运行，可以启用 Gateway 模式：

$ hermes gateway install

然后启动服务：

$ hermes gateway start

检查状态：

$ hermes gateway status
⚠️ 重要：Gateway 模式启动后，Hermes 可以连接 Telegram、Discord、Slack 等 20+ 消息平台。具体配置需运行 hermes gateway setup 并按提示操作。如果你不需要消息平台集成，直接使用终端交互模式即可。
9

安装 Skills（技能系统）

Skills 是 Hermes 的一大亮点——它们是可复用的工作流模板，让 Agent 学会特定任务：

$ hermes skills browse # 浏览可用的技能 $ hermes skills install <skill-id> # 安装某个技能 $ hermes skills list # 列出已安装的技能

在对话中加载技能：

> /skill python-dev
💡 Skills 会自动进化：Hermes 的 Curator（策展人）会跟踪每个技能的使用频率，自动归档长期不用的技能，保持你的技能库干净整洁。
10

性能优化

树莓派上运行 Hermes 的优化建议：

启用编译缓存

$ cat >> ~/.bashrc <<'EOF' # Hermes 编译缓存 export HERMES_COMPILE_CACHE=/var/tmp/hermes-compile-cache mkdir -p /var/tmp/hermes-compile-cache EOF $ source ~/.bashrc

使用便宜的辅助模型

Hermes 的一些非核心任务（压缩上下文、视觉分析等）可以使用便宜的辅助模型，降低 Token 成本：

$ hermes config set auxiliary.vision.provider deepseek $ hermes config set auxiliary.vision.model deepseek-chat

禁用不需要的工具集

减少上下文中的工具数量也能节省 Token：

$ hermes tools disable image_gen $ hermes tools disable video

无头 Pi 降低 GPU 内存（仅限 Lite 版）

$ echo ‘gpu_mem=16’ | sudo tee -a /boot/config.txt $ sudo systemctl disable bluetooth
⚠️ 如果你用的是带桌面的 Full 版系统，不要执行上面的 GPU 内存命令。
11

验证健康状态

$ hermes doctor # 检查依赖和配置是否完整 $ hermes status –all # 查看所有组件状态 $ hermes config check # 检查配置是否有遗漏

常见问题

问题 解决方法
安装脚本超时 Pi 网络较慢时，可以先用 pip install hermes-agent（通过 PyPI 安装）
启动后提示 “No model configured” 运行 hermes model 选择模型，或检查 ~/.hermes/.env 中的 API Key
记忆功能不生效 运行 hermes memory setup 初始化记忆引擎
响应速度慢 树莓派本身算力有限，但模型推理在云端，响应速度取决于网络。建议使用以太网连接
Token 消耗太快 使用便宜的辅助模型、禁用不必要的工具集、适当降低上下文长度
Gateway 服务无法自启 运行 sudo loginctl enable-linger "$(whoami)" 启用用户驻留

数据与备份

Hermes 的所有数据存储在 ~/.hermes/ 目录下：

  • state.db —— SQLite 会话数据库（含 FTS5 全文索引）
  • config.yaml —— 主配置文件
  • .env —— API Key 等环境变量
  • skills/ —— 已安装的技能
  • logs/ —— 运行日志
  • sessions/ —— 会话记录

备份整个目录即可完整迁移：

$ tar czf hermes-backup-$(date +%Y%m%d).tar.gz ~/.hermes

额外福利：启动桌面 GUI

如果你用的是 Full 版（带桌面），还可以启动 Hermes 的原生桌面应用：

$ hermes desktop

或者 Web 管理面板：

$ hermes dashboard

这些都会在 Pi 的桌面环境中打开图形界面，使用体验更友好。

🎉 你的 Hermes Agent 已就绪！

现在你的树莓派 4B 上运行着一个带有持久记忆的 AI 智能体。
它记得你是谁、你做过什么、你喜欢什么——就像一位真正了解你的私人助手。

想深入了解？访问官方资源：
📖 官方文档 · 🐙 GitHub · 🧠 记忆系统详解

💡 两篇教程对比总结：
OpenClaw ↔ Hermes Agent，怎么选？

对比维度 OpenClaw Hermes Agent
运行环境 Node.js Python (uv)
核心强项 消息渠道接入（Telegram 等原生优化） 持久记忆 + 技能系统 + 自进化
部署为服务 ✅ 原生 systemd 支持 ✅ hermes gateway install
支持模型数 50+ 模型提供商 20+ 模型提供商
Pi 官方文档 ✅ 有专门的 Pi 部署文档 ⚠️ 通用 Linux 部署
上手难度 ⭐⭐ 简单（一行命令安装） ⭐⭐ 简单（一行命令安装）

最好的方式？两个都装上，让 OpenClaw 处理消息渠道，Hermes 处理记忆——这需要下一篇教程来讲解如何集成 😉

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注