跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

Hermes Agent 是 Nous Research 出品的开源 AI Agent，主打「会成长的智能体」——它是目前少数内置学习闭环的 Agent：能从对话中自动生成技能、在使用中持续打磨技能、主动提醒自己沉淀知识，并通过 FTS5 全文索引检索过往会话，跨 session 维护对你的用户画像。Hermes 不依赖本地机器，从 5 美元的 VPS 到 GPU 集群、再到几乎零成本闲置的 Serverless 平台都能跑。 通过对接 API易，您可以获得：

🧠 自学习闭环

Agent 自主创建/打磨技能，长期记忆 + 跨会话检索

📱 全平台网关

Telegram / Discord / Slack / WhatsApp / Signal / Email / CLI

⏰ 定时调度

内置 cron 调度器，可自动跨平台投递日报/巡检结果

☁️ 跑在任何地方

本地 / Docker / SSH / Modal / Daytona / Vercel Sandbox 七种后端
项目信息：Hermes Agent 采用 MIT 许可证开源，项目地址 github.com/NousResearch/hermes-agent，官方文档 hermes-agent.nousresearch.com/docs/。

​
安装

​
Linux / macOS / WSL2 / Termux

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

​
Windows（PowerShell，原生支持仍在 Early Beta）

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
安装器会自动处理 uv、Python 3.11、Node.js、ripgrep、ffmpeg 以及一份便携 Git Bash。 完成后重载 Shell 即可启动： 
source ~/.bashrc    # 或 source ~/.zshrc
hermes              # 进入终端 UI，开始对话

​
接入 API易

Hermes 自带 hermes model 命令，可选 Nous Portal / OpenRouter / OpenAI / 自建端点等。API易 提供 OpenAI 兼容 API，作为「OpenAI 自定义端点」接入即可一次拿到全模型矩阵。

​
方式一：通过 hermes model 交互式配置（推荐）

hermes model        # 进入模型选择向导
向导会依次询问：
步骤输入
Provider选 OpenAI（或 Custom OpenAI endpoint）
API Base URLhttps://api.apiyi.com/v1
API Key你的 API易 密钥（sk-...）
Model填入想用的模型 ID，如 gpt-5.4、claude-sonnet-4-6、deepseek-v3.2、gemini-3.1-pro-preview

​
方式二：通过 hermes config set 直接写入

hermes config set llm.provider openai
hermes config set llm.base_url https://api.apiyi.com/v1
hermes config set llm.api_key sk-你的API易密钥
hermes config set llm.model gpt-5.4
写入后用 hermes 启动一次验证连接。

​
方式三：环境变量（适合 Docker / Serverless 部署）

export OPENAI_API_BASE=https://api.apiyi.com/v1
export OPENAI_API_KEY=sk-你的API易密钥
export HERMES_MODEL=gpt-5.4
hermes
切换模型只需 hermes model 或修改 HERMES_MODEL，无需改任何代码。

​
方式四：Anthropic 原生协议（主用 Claude 强烈推荐）

Hermes 把 Anthropic 作为一等公民 Provider，内部 wire protocol 称为 anthropic_messages，相比走 OpenAI 兼容路径有独家加成：
走 Anthropic 原生协议的额外收益：Hermes 会自动给 native Anthropic、OpenRouter、Nous Portal 这三类 Provider 挂上 cache_control 1 小时缓存断点（系统提示 + 技能内容 + 长上下文前段），跨 session 和 subagent 复用，按低价的 cached-read 费率结算。走 OpenAI 兼容路径时这个优化不会生效。Claude 主力用户建议直接走这条路。
CLI 配置： 
hermes config set llm.provider anthropic
hermes config set llm.base_url https://api.apiyi.com
hermes config set llm.api_key sk-你的API易密钥
hermes config set llm.model claude-sonnet-4-6
环境变量等价写法： 
export ANTHROPIC_BASE_URL=https://api.apiyi.com
export ANTHROPIC_API_KEY=sk-你的API易密钥
export HERMES_MODEL=claude-sonnet-4-6
hermes
base_url 不要带 /v1：必须是 https://api.apiyi.com。Anthropic 协议会自动拼接 /v1/messages，写错会变成 .../v1/v1/messages 触发 404。
Hermes 会根据 URL 自动识别协议（路径含 /anthropic 直接走 anthropic_messages）。若使用 LiteLLM 代理等非标准端点，可手动指定： 
hermes config set llm.api_mode anthropic_messages
额外提示：API易 控制台 api.apiyi.com/token 创建令牌时，分组选 ClaudeCode 可自动享受 95 折，可叠加充值赠送 10%-20%。
为什么选 API易？
  • 一把密钥多家模型：OpenAI / Anthropic / Google / DeepSeek / 智谱 / Kimi 等全模型矩阵
  • 价格优势：相对官方价格通常有 5%-20% 优惠，部分模型支持充值加赠
  • 国内直连：免代理直接访问海外大模型
  • 双协议兼容：OpenAI 和 Anthropic 两套 Wire Protocol 都能接，主用 Claude 走 Anthropic 原生还能吃到 1 小时缓存折扣

​
常用功能速查

终端 UI

完整 TUI：多行编辑、斜杠命令补全、会话历史、流式工具输出

消息网关

hermes gateway setup 后绑定 Bot Token，即可在 IM 平台直接对话

技能系统

程序化记忆 + Skills Hub（agentskills.io），Agent 用得越多越聪明

MCP 集成

接入任意 MCP Server 扩展能力，含社区 Linux 桌面控制 MCP

定时任务

内置 cron 调度，自然语言指令即可创建”每天 9 点发我日报”

子 Agent

可生成隔离的 subagent 并行处理任务，写 Python 脚本通过 RPC 调用

​
从 OpenClaw 迁移

如果你之前使用 OpenClaw，Hermes 内置了一键迁移工具： 
hermes claw migrate              # 交互式完整迁移
hermes claw migrate --dry-run    # 预览将迁移哪些内容
hermes claw migrate --preset user-data   # 仅迁移用户数据，不含密钥
hermes claw migrate --overwrite  # 覆盖冲突
将自动导入 SOUL.md、记忆 (MEMORY.md / USER.md)、用户技能、命令白名单、消息平台配置、API 密钥（Telegram / OpenRouter / OpenAI / Anthropic / ElevenLabs）、TTS 资源、工作目录指令等。

​
常见问题

  • Hermes Agent：Python 实现、Nous Research 出品，主打自学习闭环——技能自我演化、跨会话记忆，研究友好（支持 trajectory 生成）
  • OpenClaw：Node.js 实现、面向本地隐私 + 多 IM 平台联动
  • FastClaw：Go 编写的单二进制运行时，主打多 Agent 管理 + Dashboard 形态
三者均可通过 API易 接入全模型矩阵，按场景选用即可。
支持。Hermes 同时支持 OpenAI 兼容和 Anthropic 原生两套协议：
  • OpenAI 协议端点：https://api.apiyi.com/v1，覆盖全模型矩阵
  • Anthropic 协议端点：https://api.apiyi.com（不带 /v1），覆盖 Claude 系列
模型 ID 直接填 API易 文档里的模型名（如 gpt-5.4、claude-sonnet-4-6、deepseek-v3.2、gemini-3.1-pro-preview 等）。Claude 主力用户建议走 Anthropic 原生，可额外吃到 Hermes 的 1 小时跨会话缓存。
Hermes 提供一个单一 Gateway 进程，统一管理 Telegram / Discord / Slack / WhatsApp / Signal 等平台的 Bot 连接。hermes gateway setup 引导你填入各平台 Token，hermes gateway start 启动后，所有平台的消息会被路由到同一个 Agent 实例，跨平台会话连续——你在 Telegram 上问的问题可以在 Discord 接着聊。支持语音留言转写，所有平台的 cron 投递也走同一通道。
可以，而且 Hermes 强烈推荐云端部署。它提供 7 种终端后端：
  • 本地 / Docker / SSH / Singularity：传统部署
  • Modal / Daytona：Serverless 持久化，空闲时休眠几乎不计费，按需唤醒
  • Vercel Sandbox：边缘运行时
一个 5 美元 VPS 就能挂着 24/7 待命，从手机 Telegram 给云端 VM 派活完全可行。

​
相关资源

项目仓库

github.com/NousResearch/hermes-agent

官方文档

hermes-agent.nousresearch.com/docs/

OpenClaw 对比方案

本地隐私 + IM 联动场景的另一选择

FastClaw 对比方案

多 Agent 工厂 + Dashboard 形态的另一选择