Hermes Agent ☤

由 Nous Research 构建的自进化 AI 代理。 它是唯一内置学习闭环的智能代理——从经验中创建技能，在使用中改进技能，主动持久化知识，搜索过往对话，并在跨会话中逐步构建对你的深度理解。可以在 $5 的 VPS 上运行，也可以在 GPU 集群上运行，或者使用几乎零成本的 Serverless 基础设施。它不绑定你的笔记本——你可以在 Telegram 上与它对话，而它在云端 VM 上工作。

支持任意模型——Nous Portal、OpenRouter（200+ 模型）、NVIDIA NIM（Nemotron）、小米 MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face、OpenAI，或自定义端点。使用 hermes model 即可切换——无需改代码，无锁定。

快速安装

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

支持 Linux、macOS、WSL2 和 Android (Termux)。安装程序会自动处理平台特定的配置。

Android / Termux： 已测试的手动安装路径请参考 Termux 指南。在 Termux 上，Hermes 会安装精选的 .[termux] 扩展，因为完整的 .[all] 扩展会拉取 Android 不兼容的语音依赖。

Windows： 在 PowerShell 中运行：

root@kitploit:~

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装完成后，可能需要重启终端，然后运行 hermes 开始对话。

安装后：

source ~/.bashrc    # 重新加载 shell（或: source ~/.zshrc）
hermes              # 开始对话！

快速入门

hermes              # 交互式 CLI — 开始对话
hermes model        # 选择 LLM 提供商和模型
hermes tools        # 配置启用的工具
hermes config set   # 设置单个配置项
hermes gateway      # 启动消息网关（Telegram、Discord 等）
hermes setup        # 运行完整设置向导（一次性配置所有内容）
hermes claw migrate # 从 OpenClaw 迁移（如果来自 OpenClaw）
hermes update       # 更新到最新版本
hermes doctor       # 诊断问题

📖 完整文档 →

省去到处收集 API Key — Nous Portal

Hermes 始终允许你使用任意服务商，这点不会改变。但如果你不想为模型、网页搜索、图像生成、TTS、云浏览器分别去申请五个不同的 API Key，Nous Portal 用一个订阅就能覆盖全部：

• 300+ 模型 — 用 /model <name> 随时切换
• Tool Gateway — 网页搜索（Firecrawl）、图像生成（FAL）、文本转语音（OpenAI）、云浏览器（Browser Use），全部通过订阅托管。无需额外注册任何账户。

全新安装时一条命令即可：

hermes setup --portal

它会通过 OAuth 登录、把 Nous 设为推理服务商，并启用 Tool Gateway。随时用 hermes portal info 查看路由状态。完整说明见 Tool Gateway 文档。

你随时可以按工具单独切回自己的 API Key — Gateway 是按工具粒度生效的，不是一刀切。

CLI 与消息平台 快速对照

Hermes 有两种入口：用 hermes 启动终端 UI，或运行网关从 Telegram、Discord、Slack、WhatsApp、Signal 或 Email 与之对话。进入对话后，许多斜杠命令在两种界面中通用。

完整命令列表请参阅 CLI 指南 和 消息网关指南。

文档

所有文档位于 hermes-agent.nousresearch.com/docs：

从 OpenClaw 迁移

如果你来自 OpenClaw，Hermes 可以自动导入你的设置、记忆、技能和 API 密钥。

首次安装时： 安装向导（hermes setup）会自动检测 ~/.openclaw 并在配置开始前提供迁移选项。

安装后任意时间：

hermes claw migrate              # 交互式迁移（完整预设）
hermes claw migrate --dry-run    # 预览将要迁移的内容
hermes claw migrate --preset user-data   # 仅迁移用户数据，不含密钥
hermes claw migrate --overwrite  # 覆盖已有冲突

导入内容：

• SOUL.md — 人格文件
• 记忆 — MEMORY.md 和 USER.md 条目
• 技能 — 用户创建的技能 → ~/.hermes/skills/openclaw-imports/
• 命令白名单 — 审批模式
• 消息设置 — 平台配置、允许用户、工作目录
• API 密钥 — 白名单中的密钥（Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs）
• TTS 资产 — 工作区音频文件
• 工作区指令 — AGENTS.md（使用 --workspace-target）

使用 hermes claw migrate --help 查看所有选项，或使用 openclaw-migration 技能进行交互式代理引导迁移（含干运行预览）。

贡献

欢迎贡献！请参阅 贡献指南 了解开发设置、代码风格和 PR 流程。

贡献者快速开始——使用标准安装器，然后在它创建的完整 git checkout 中开发： $HERMES_HOME/hermes-agent（通常是 ~/.hermes/hermes-agent）。这会匹配 hermes update、托管 venv、lazy dependencies、gateway 和 docs tooling 使用的布局。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

手动克隆备用路径（用于一次性 clone / CI，或你明确不想使用 managed install layout 时）：

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"
python -m pytest tests/ -q

社区

• 💬 Discord
• 📚 技能中心
• 🐛 问题反馈
• 💡 讨论区
• 🔌 HermesClaw — 社区微信桥接：在同一微信账号上运行 Hermes Agent 和 OpenClaw。

许可证

MIT — 详见 LICENSE。

由 Nous Research 构建。