hermes-agent/README.zh-CN.md

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 即可切换——无需改代码，无锁定。

真正的终端界面	完整的 TUI，支持多行编辑、斜杠命令自动补全、对话历史、中断重定向和流式工具输出。
随你所在	Telegram、Discord、Slack、WhatsApp、Signal 和 CLI——全部从单个网关进程运行。语音备忘录转写、跨平台对话连续性。
闭环学习	代理管理记忆并定期自我提醒。复杂任务后自动创建技能。技能在使用中自我改进。FTS5 会话搜索配合 LLM 摘要实现跨会话回溯。Honcho 辩证式用户建模。兼容 agentskills.io 开放标准。
定时自动化	内置 cron 调度器，支持向任何平台投递。日报、夜间备份、周审计——全部用自然语言描述，无人值守运行。
委派与并行	生成隔离子代理处理并行工作流。编写 Python 脚本通过 RPC 调用工具，将多步管道压缩为零上下文开销的轮次。
随处运行	六种终端后端——本地、Docker、SSH、Daytona、Singularity 和 Modal。Daytona 和 Modal 提供 Serverless 持久化——代理环境空闲时休眠、按需唤醒，空闲期间几乎零成本。$5 VPS 或 GPU 集群都能跑。
研究就绪	批量轨迹生成、轨迹压缩——用于训练下一代工具调用模型。

---

快速安装

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

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

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

Windows： 原生 Windows 不受支持。请安装 WSL2 并运行上述命令。

安装后：

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       # 诊断问题

📖 完整文档 →

CLI 与消息平台 快速对照

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

操作	CLI	消息平台
开始对话	hermes	运行 hermes gateway setup + hermes gateway start，然后给机器人发消息
开始新对话	/new 或 /reset	/new 或 /reset
更换模型	/model [provider:model]	/model [provider:model]
设置人格	/personality [name]	/personality [name]
重试或撤销上一轮	/retry、/undo	/retry、/undo
压缩上下文 / 查看用量	/compress、/usage、/insights [--days N]	/compress、/usage、/insights [days]
浏览技能	/skills 或 /<skill-name>	/skills 或 /<skill-name>
中断当前工作	Ctrl+C 或发送新消息	/stop 或发送新消息
平台特定状态	/platforms	/status、/sethome

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

---

文档

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

章节	内容
快速开始	安装 → 设置 → 2 分钟内开始首次对话
CLI 使用	命令、快捷键、人格、会话
配置	配置文件、提供商、模型、所有选项
消息网关	Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant
安全	命令审批、DM 配对、容器隔离
工具与工具集	40+ 工具、工具集系统、终端后端
技能系统	过程记忆、技能中心、创建技能
记忆	持久记忆、用户画像、最佳实践
MCP 集成	连接任意 MCP 服务器扩展能力
定时调度	定时任务与平台投递
上下文文件	影响每次对话的项目上下文
架构	项目结构、代理循环、关键类
贡献	开发设置、PR 流程、代码风格
CLI 参考	所有命令和标志
环境变量	完整环境变量参考

---

从 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 流程。

贡献者快速开始——克隆并使用 setup-hermes.sh：

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh     # 安装 uv、创建 venv、安装 .[all]、创建符号链接 ~/.local/bin/hermes
./hermes              # 自动检测 venv，无需先 source

手动安装（等效于上述命令）：

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 构建。