教程目录
官方文档中文翻译版
作者: 佚名 • 版本: 通用
分布向导式教程
# Hermes Agent ☤ 中文使用教程
# Hermes Agent ☤ 中文使用教程
---
## 项目简介
由Nous Research开发的自我进化AI代理，是唯一内置学习循环的智能体：它能从经验中创建技能，在使用过程中迭代优化技能，主动留存知识，检索过往对话记录，并在多会话交互中逐步构建对用户的深度认知模型。你可以在5美元的廉价VPS、GPU集群或闲置时几乎零成本的无服务器基础设施上运行它。它不会绑定你的本地电脑——你可以通过Telegram与在云虚拟机中运行的它随时随地对话。
## 支持的大模型
可使用任意主流大模型：Nous Portal、OpenRouter（200+模型）、NVIDIA NIM（Nemotron）、小米MiMo、z.ai/GLM、Kimi/月之暗面、MiniMax、Hugging Face、OpenAI或你自建的模型端点。通过`hermes model`命令即可快速切换，无需修改代码，也不会被厂商锁定。
## 核心特性
1. **原生终端界面**：完整的文本用户界面(TUI)，支持多行编辑、斜杠命令自动补全、对话历史查看、中断重定向与流式工具输出
2. **多平台适配**：通过单一网关进程支持Telegram、Discord、Slack、WhatsApp、Signal与CLI，内置语音备忘录转录与跨平台对话连续性
3. **闭环学习系统**：代理 curated 记忆与周期性提示，复杂任务后自动创建技能，技能在使用中自我优化，支持FTS5会话搜索与LLM摘要实现跨会话召回，兼容Honcho辩证用户建模，支持agentskills.io开放标准
4. **定时自动化任务**：内置cron调度器，支持向任意平台交付任务，可无人值守运行日报、夜间备份、周度审计等自然语言任务
5. **并行委托能力**：可生成隔离的子代理处理并行工作流，编写通过RPC调用工具的Python脚本，将多步骤流程压缩为零上下文开销的交互
6. **跨环境运行**：支持6种终端后端——本地、Docker、SSH、Daytona、Singularity与Modal。Daytona和Modal提供无服务器持久化能力，代理环境在闲置时休眠，按需唤醒，会话间隔成本极低，可在5美元VPS或GPU集群上运行
7. **科研就绪**：支持批量轨迹生成、Atropos RL环境、轨迹压缩，用于训练下一代工具调用模型
---
## 快速安装
```bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash ```
支持的系统：Linux、macOS、WSL2，以及通过Termux运行的Android。安装脚本会自动处理平台特定的配置。
### 平台注意事项
- **Android / Termux**：官方提供了经过测试的手动安装路径，在Termux上Hermes会安装精选的`.termux`额外依赖，因为完整的`.all`依赖包目前会引入Android不兼容的语音依赖
- **Windows**：不支持原生Windows系统，请安装WSL2后运行上述命令
---
## 安装后首次使用
```bash source ~/.bashrc # 重载Shell配置（Zsh用户请执行：source ~/.zshrc） hermes # 启动交互式CLI开始对话 ```
### 入门命令
```bash hermes # 启动交互式CLI，开始第一次对话 hermes model # 选择你的大模型提供商与模型 hermes tools # 配置启用哪些工具集 hermes config set # 单独设置配置项 hermes gateway # 启动消息网关（支持Telegram、Discord等） hermes setup # 运行完整的设置向导，一键配置所有内容 hermes claw migrate # 从OpenClaw迁移数据（如果之前使用过OpenClaw） hermes update # 更新到最新版本 hermes doctor # 诊断运行问题 ```
📖 完整文档地址：hermes-agent.nousresearch.com/docs
---
## CLI与消息平台快速参考
Hermes有两种启动入口：
1. 通过`hermes`命令启动终端UI
2. 运行网关进程，通过Telegram、Discord、Slack、WhatsApp、Signal或Email与代理对话
大部分斜杠命令在两种界面中通用：
| 操作 | CLI界面 | 消息平台界面 | |--------------------------|------------------------|--------------------------| | 开始对话 | `hermes` | 运行`hermes gateway setup` + `hermes gateway start`，然后给机器人发消息 | | 开启新对话 | `/new` 或 `/reset` | `/new` 或 `/reset` | | 切换大模型 | `/model [提供商:模型]` | `/model [提供商:模型]` | | 设置角色性格 | `/personality [名称]` | `/personality [名称]` | | 重试或撤销上一轮对话 | `/retry` 或 `/undo` | `/retry` 或 `/undo` | | 压缩上下文/查看使用情况 | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` | | 浏览技能 | `/skills` 或 `/<技能名称>` | `/skills` 或 `/<技能名称>` | | 中断当前工作 | `Ctrl+C` 或 发送新消息 | `/stop` 或 发送新消息 | | 平台特定状态 | `/platforms` | `/status`, `/sethome` |
完整命令列表请查看CLI指南与消息网关指南。
---
## 完整文档目录
| 文档章节 | 内容覆盖 |
|------------------------|----------------------------------------------|
| 快速开始 | 安装 → 设置 → 2分钟内完成第一次对话 |
| CLI使用指南 | 所有命令、快捷键、角色性格、会话管理 |
| 配置指南 | 配置文件、提供商、模型、所有配置选项 |
| 消息网关指南 | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant |
| 安全指南 | 命令审批、DM配对、容器隔离 |
| 工具与工具集 | 40+内置工具、工具集系统、终端后端 |
| 技能系统 | 过程式记忆、技能中心、创建自定义技能 |
| 持久化记忆 | 持久化存储、用户档案、最佳实践 |
| MCP集成 | 连接任意MCP服务器扩展功能 |
| Cron调度 | 定时任务与平台交付 |
| 上下文文件 | 塑造每次对话的项目上下文 |
| 架构指南 | 项目结构、代理循环、核心类 |
| 贡献指南 | 开发环境设置、PR流程、代码规范 |
| CLI命令参考 | 所有命令与参数 |
| 环境变量参考 | 完整环境变量列表 |
| 从OpenClaw迁移 | 迁移OpenClaw的配置、记忆、技能与API密钥 |
---
## 从OpenClaw迁移数据
如果你之前使用过OpenClaw，Hermes可以自动导入你的设置、记忆、技能与API密钥。
### 首次安装时
运行设置向导`hermes setup`时，会自动检测`~/.openclaw`目录，并在配置开始前提供迁移选项。
### 安装后任意时间执行
```bash 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流程。
### 开发者快速启动
```bash git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent ./setup-hermes.sh # 自动安装uv、创建虚拟环境、安装全部依赖并创建~/.local/bin/hermes软链接 ./hermes # 自动检测虚拟环境，无需手动执行source ```
### 手动安装（等价于上述脚本）
```bash 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 ```
### 强化学习开发（可选）
如果需要开发RL/Tinker-Atropos集成：
```bash git submodule update --init tinker-atropos uv pip install -e "./tinker-atropos" ```
---
## 社区与支持
- 💬 Discord社区
- 📚 技能中心
- 🐛 问题反馈
- 💡 讨论区
- 🔌 HermesClaw — 微信社区桥：在同一个微信账号上运行Hermes Agent与OpenClaw
## 开源协议
MIT协议，详细内容请查看LICENSE文件。
由Nous Research团队开发制作