Hermes Agent：能自我进化的AI智能体完全指南

1

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 克隆仓库
git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent

# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动
python run_agent.py

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# docker-compose.yml
version: '3.8'
services:
  hermes:
    image: ghcr.io/nousresearch/hermes-agent:latest
    volumes:
      - ./hermes-data:/root/.hermes
    ports:
      - "8080:8080"
    environment:
      - HERMES_LLM_PROVIDER=openrouter
      - OPENROUTER_API_KEY=your-key-here

1
2
3
4
5
6

# 安装 Termux（从 F-Droid）
pkg install python git
git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent
pip install -r requirements.txt
python run_agent.py

1
2
3
4
5
6
7

~/.hermes/
├── config.yaml      # 主配置文件
├── .env             # 环境变量（API密钥等）
├── SOUL.md          # 人格定义文件
├── memories/        # 持久化记忆
├── skills/          # 技能库
└── agents/          # 智能体定义

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# LLM 提供商配置
llm:
  provider: openrouter           # 提供商名称
  model: anthropic/claude-sonnet-4  # 模型名称
  api_key: ${OPENROUTER_API_KEY}    # API密钥（推荐用环境变量）

# 消息网关配置
telegram:
  enabled: true
  bot_token: ${TELEGRAM_BOT_TOKEN}

discord:
  enabled: true
  bot_token: ${DISCORD_BOT_TOKEN}

# 安全配置
security:
  command_approval: smart    # manual / smart / off
  blocked_commands:
    - rm -rf /
    - mkfs

# 工具集配置
tools:
  enabled:
    - terminal
    - browser
    - web
    - file
    - cron

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# LLM API 密钥
OPENROUTER_API_KEY=sk-or-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# 消息平台令牌
TELEGRAM_BOT_TOKEN=123456:ABC...
DISCORD_BOT_TOKEN=MTIz...

# 可选：HTTP 代理
HTTPS_PROXY=http://proxy:7890

1
2
3

hermes                    # 使用默认配置启动
hermes --model gpt-4o     # 指定模型
hermes --provider anthropic  # 指定提供商

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

hermes [选项]

选项:
  -m, --model MODEL        指定 LLM 模型
  -p, --provider PROVIDER  指定 LLM 提供商
  --no-memory              禁用记忆加载
  --no-skills              禁用技能加载
  --workdir DIR            设置工作目录
  --config FILE            指定配置文件路径
  --debug                  启用调试模式

1
2
3
4
5

telegram:
  enabled: true
  bot_token: ${TELEGRAM_BOT_TOKEN}
  allowed_users:
    - your_telegram_id

1
2
3
4
5

discord:
  enabled: true
  bot_token: ${DISCORD_BOT_TOKEN}
  allowed_channels:
    - "#bot-home"

1
2

security:
  command_approval: smart    # smart 模式：智能判断是否需要审批

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

---
name: my-skill
description: 技能描述
version: 1.0
tags: [devops, python]
---

# 技能名称

## 触发条件
什么时候使用这个技能...

## 步骤
1. 第一步：执行命令 X
2. 第二步：检查输出 Y
3. 第三步：如果失败则...

## 注意事项
- 常见坑点 A
- 必须满足的前提条件 B

## 验证
如何确认任务成功完成...

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 列出所有技能
/skills

# 查看技能详情
/skill view <name>

# 创建新技能
/skill create <name>

# 更新技能
/skill patch <name>

# 删除技能
/skill delete <name>

1
2
3
4

当前环境: Ubuntu 22.04, Python 3.13.5
项目路径: /opt/data/home/my-blog
博客使用 Hexo + Matery 主题
GitHub 仓库: zz3656/zz3656.github.io

1
2
3

用户使用中文沟通
偏好简洁的回复，不需要过多追问
项目使用 pytest 测试框架

1
2
3
4
5
6
7
8

# 每天早上 9 点发送天气预报
"每天早上9点查一下北京天气发给我"

# 每 2 小时检查服务器状态
"每隔2小时检查一次服务器负载"

# 每周一生成项目周报
"每周一生成上周的项目总结"

1
2
3
4

# config.yaml 中的 cron 配置
cron:
  timezone: Asia/Shanghai
  max_concurrent: 3

1
2
3
4
5

/cron list           # 查看所有任务
/cron pause <id>     # 暂停任务
/cron resume <id>    # 恢复任务
/cron remove <id>    # 删除任务
/cron run <id>       # 手动触发

1

hermes --workdir /path/to/project

1
2
3
4

"帮我同时做三件事：
1. 研究 Kubernetes 最新版本特性
2. 分析这个日志文件中的错误
3. 给项目写一个 README"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# config.yaml
mcp:
  servers:
    - name: filesystem
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    
    - name: database
      command: npx
      args: ["-y", "@modelcontextprotocol/server-sqlite", "db.sqlite"]

1
2

security:
  command_approval: smart  # 推荐