hermes agent 是轻量开源ai助手，支持持久记忆与多平台接入；需通过一键脚本安装依赖、配置外部模型api（如yibuapi）、验证本地运行，并可选docker或飞书网关部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地快速部署一个具备持久记忆、自主技能沉淀与多平台接入能力的开源 AI 助手，则 Hermes Agent 是当前最轻量且功能完备的选择之一。以下是覆盖主流操作系统的一站式安装与基础配置流程：
一、一键安装 Hermes Agent
安装脚本会自动检测系统环境，完成 Python、Node.js、Git、ripgrep 等全部依赖的安装，并注册全局 hermes 命令。macOS、Linux 及 WSL2 用户可直接执行终端命令；Windows 用户需优先启用并配置 WSL2。
1、macOS 或 Linux 用户：打开终端，粘贴执行以下命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、Windows 用户（推荐 WSL2 方案）：
以管理员身份运行 PowerShell，依次执行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑后，运行 wsl --set-default-version 2，再从 Microsoft Store 安装 Ubuntu 22.04 LTS，启动并完成 Linux 用户初始化。
3、Windows 原生 PowerShell 安装（备选）：
以管理员身份运行 PowerShell，执行：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
二、模型服务对接配置
Hermes 本身不内置大模型，必须通过外部 API 接入才能响应对话。配置错误将导致空响应或启动失败，因此该步骤不可跳过。
1、推荐使用一步 API（yibuapi.com）作为统一接入层：
访问 yibuapi.com 注册账号，进入控制台创建 API Key，复制 sk- 开头的密钥字符串。
2、启动交互式配置：
终端输入 hermes setup，按提示选择 Custom endpoint (OpenAI compatible)，粘贴 Base URL：https://api.yibuapi.com/v1，再粘贴上一步获取的 API Key。
3、若模型未被识别（尤其 Windows 原生安装后），可在 Hermes 运行中输入内置命令：
/model claude-3-5-sonnet-20241022 或 /model gpt-4o 手动指定可用模型名称。
三、验证安装与基础运行
配置完成后，Hermes 将自动初始化 ~/.hermes/ 目录结构，包括 config.yaml、state.db（SQLite 对话数据库）、skills/ 与 memories/ 子目录。所有历史记录与自动生成的技能均落盘持久化，不依赖内存加载。
1、终端直接输入 hermes 启动服务，等待出现欢迎消息及光标提示符即表示运行就绪。
2、首次对话可输入任意自我介绍语句，例如：
你好，我是一名前端工程师，常用 VS Code，偏好 TypeScript。
3、观察 ~/.hermes/state.db 是否已写入数据，确认 SQLite 数据库已激活；检查 ~/.hermes/skills/bundled/ 是否存在预置技能文件，验证技能加载路径正常。
四、Docker 容器化部署（可选方案）
为保障环境隔离与数据可迁移性，可使用官方 Docker 镜像部署。容器内运行的 Hermes 实例将把用户数据挂载至宿主机，实现删镜像不丢记忆。
1、拉取最新镜像：
docker pull nousresearch/hermes-agent:latest
2、运行容器并映射数据卷：
docker run -v ~/.hermes:/opt/data nousresearch/hermes-agent:latest
3、确保宿主机 ~/.hermes 目录权限允许容器内进程读写，否则 state.db 将无法持久化。
五、飞书网关接入配置
为实现跨平台调用，Hermes 提供 Gateway 模块支持飞书、企业微信、钉钉等消息平台。飞书接入需同步完成开放平台应用配置与本地网关绑定。
1、前往飞书开放平台创建企业自建应用，启用机器人功能，在“凭证与基础信息”页记下 App ID 与 App Secret。
2、在终端执行 hermes gateway setup，选择 feishu 渠道，依次填入 App ID、App Secret；Domain 填 feishu，Connection mode 选 websocket，User IDs 留空表示全员可交互。
3、回到飞书开放平台“事件与回调”，启用长连接模式，订阅 im.message.receive_v1 事件，保存生效。
