Hermes Agent 快速上手

Hermes Agent 是 Nous Research 推出的自进化开源 AI 智能体，核心是跨会话持久记忆 + 自动生成可复用技能，本地 / 云端都能跑。下面是 5 分钟快速上手（Linux/macOS/WSL2）。

一、环境准备

系统：Linux / macOS / Windows WSL2

依赖：curl, bash（Windows 必须先装 WSL2）

必备：LLM API Key（OpenAI / OpenRouter / Claude / Kimi 等）

二、一键安装（推荐）

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

安装完成后重载 shell：

source ~/.bashrc   # 或 ~/.zshrc

```{insert\_element\_0\_}

验证：

```bash

hermes --version

三、首次配置（必做）

3.1 交互式配置

hermes setup

按提示选择：

LLM 提供商：OpenAI / OpenRouter / Claude / Moonshot (Kimi) 等

输入 API Key

终端后端：本地 / Docker（推荐安全）

消息平台（可选）：Telegram/Discord/Slack 等

3.2 手动配置（示例：OpenRouter）

hermes config set provider openrouter
hermes config set model anthropic/claude-sonnet-4
hermes config set api_key sk-your-key-here

四、启动 & 基础使用

4.1 启动交互模式

hermes

出现 > 提示符即可开始对话。

4.2 常用命令（斜杠 /）

/help — 帮助

/model — 切换模型

/skills — 查看已学技能

/memory — 查看记忆

/config — 编辑配置

/interrupt — 中断当前任务

/history — 历史会话

/clear — 清空当前对话

4.3 常用用法示例

1）自然对话

> 帮我写一个 FastAPI 带 JWT 认证的 TODO API

2）执行终端命令（会确认）

> 查看磁盘占用最大的5个目录

> Run: ls -la

3）文件操作

> 查看 ./main.py 并重构数据库连接

4）多行输入

Alt+Enter 或 Ctrl+J 换行

5）恢复会话

hermes --continue   # 恢复最近

hermes -r "项目名"   # 按名称恢复

五、核心特性：自进化（关键）

第一次任务：从零推导、多轮工具调用

第二次同类任务：自动复用技能，速度大幅提升

技能保存在 ~/.hermes/skills/，可手动编辑

六、安全建议（必看）

生产环境用 Docker 沙箱：

hermes config set terminal.enabled true
hermes config set terminal.backend docker

```{insert\_element\_3\_}

敏感机器不要开终端权限

定期备份 ~/.hermes

七、进阶：消息网关（手机远程）

Telegram 示例

hermes gateway setup

# 选择 Telegram，输入 Bot Token、允许的用户 ID

hermes gateway

即可在 Telegram 跟 Hermes 聊天。

八、常见问题

安装失败：检查 WSL2 / 网络 /curl

API 报错：确认 Key 正确、余额充足、模型名正确

慢：换更快模型（如 GPT-4o / Claude Sonnet）

忘记配置：hermes setup 重来

九、下一步

用 hermes model 切换更强模型

尝试复杂任务：代码项目、自动化脚本、数据分析

用 /skills 看它学会了什么

部署到 VPS 7×24 运行