Open Euler 部署 Hermes Agent

2.环境准备

• • Linux（Ubuntu 20.04+、Debian、Arch 等）
  • macOS（Intel & Apple Silicon）
  • Windows WSL2（推荐用 Ubuntu 子系统）

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

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

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

# 安装
pip install -e .

hermes --version

hermes setup

1. 选择模型提供商（OpenRouter / Anthropic / DeepSeek / ...）
2. 输入 API Key
3. 选择终端配色主题
4. 配置消息平台（可选，跳过也行）
5. 启用需要的工具集

~/.hermes/
├── config.yaml          # 主配置文件
├── .env                 # API Key 等敏感信息
├── skills/             # 安装的技能包
├── sessions/           # 对话历史记录
├── logs/               # 日志文件
└── hermes-agent/       # 源代码（git 安装时才有）

# 查看当前配置
hermes config

# 编辑配置
hermes config edit

# 查看配置路径
hermes config path

model:
  default: anthropic/claude-sonnet-4-6
  provider: openrouter
  api_key: ${OPENROUTER_API_KEY}

agent:
  max_turns: 90
  tool_use_enforcement: true

terminal:
  backend: local
  timeout: 180

memory:
  memory_enabled: true
  user_profile_enabled: true

# OpenRouter
OPENROUTER_API_KEY=sk-or-v1-xxxxx

# 或 Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxx

# 或 DeepSeek
DEEPSEEK_API_KEY=sk-xxxxx

hermes

$ hermes
[Hermes Agent v2.x.x]
Type /help for commands.

You: 帮我查看当前目录有什么文件

hermes chat -q "What is the capital of France?"

You: 读取 ~/.bashrc 文件的前 20 行

You: 在当前目录创建一个名为 hello.py 的 Python 文件，内容是打印 "Hello, Hermes!"

You: 在当前目录找出所有 .md 文件

You: 用 Python 写一个函数，计算斐波那契数列第 n 项，然后测试 n=10

# 查看可用工具
hermes tools list

# 启用/禁用工具
hermes tools enable terminal    # 启用终端工具
hermes tools enable web         # 启用网页搜索
hermes tools enable file        # 启用文件操作

# 列出已安装技能
hermes skills list

# 搜索技能市场
hermes skills search "python"
hermes skills browse

# 安装技能
hermes skills install technical-blog-writing

# 在会话中加载技能，加载后，Hermes 会读取该技能的完整说明（包括工作流、最佳实践），并在当前任务中应用。
You: /skill technical-blog-writing

You: 把这个工作流存成一个技能，方便以后复用

# 查看记忆状态
hermes memory status

hermes honcho setup    # 如果装了 honcho 插件

# 启动 Gateway
hermes gateway run

# 配置消息平台
hermes gateway setup

hermes gateway install     # 安装为 systemd 服务
hermes gateway start       # 启动
hermes gateway status      # 查看状态

# 创建定时任务
hermes cron create "0 9 * * *" "总结昨天的日志写入 ~/daily-log.md"

# 列出所有任务
hermes cron list

# 手动触发一次
hermes cron run <job_id>

# 删除任务
hermes cron remove <job_id>

# 查看历史会话
hermes sessions list

# 恢复会话
hermes --continue # 恢复最近一次
hermes --resume 20260225_143052_a1b2c3 # 按 ID 恢复

# 导出会话
hermes sessions export ~/conversations.jsonl

# 清理旧会话
hermes sessions prune --older-than 30 days

# 示例：同时让三个子 Agent 并行工作
# Agent A: 调研竞品
# Agent B: 写架构设计
# Agent C: 准备测试数据

# 添加 MCP 服务器
hermes mcp add <name> --url <server_url>
# 或
hermes mcp add <name> --command "<command>"

# 列出已配置的 MCP 服务器
hermes mcp list

# 测试连接
hermes mcp test <name>

# 创建新 Profile
hermes profile create work

# 切换
hermes profile use work

# 克隆现有配置
hermes profile create personal --clone-from default

# 创建一个 Webhook 路由
hermes webhook subscribe mytask

# 测试这个 Webhook
curl -X POST http://localhost:18989/webhooks/mytask \
  -d '{"prompt": "分析上传的日志文件"}'

# 1. 启动 Hermes，加载写作技能
hermes -s technical-blog-writing

# 2. 告诉它你要写什么
You: 我要写一篇关于 Docker 容器安全的博客，面向有基础的开发者

# 3. 它会按技能规范产出：
#    - 正确的结构
#    - 可运行的代码示例
#    - 结尾签名块
#    - 保存到 workspace/articles/
#    - 上传到飞书云盘

hermes

You: 审查 ~/myproject/src/ 目录下的所有 Python 文件，找出潜在的安全问题

# 创建一个每天早上 9 点执行的任务
hermes cron create "0 9 * * 1-5" \
  "检查服务器状态，把异常日志发到我邮箱"

# 检查安装
which hermes
ls ~/.hermes/venv/bin/hermes

# 重新加载 PATH
source ~/.bashrc
# 或
source ~/.zshrc

# 检查 .env 文件是否正确
cat ~/.hermes/.env

# 测试 Key 是否有效
hermes doctor

# 检查工具是否启用
hermes tools list

# 重启新 session
/exit
hermes

# 查看日志
tail -50 ~/.hermes/logs/gateway.log

# 飞书用户特别注意
# 需要安装 lark-oapi 包：
~/.hermes/venv/bin/pip install lark-oapi

# 检查配置
hermes config

# 切换模型
hermes model

# 查看详细错误
hermes doctor