Hermes Agent 安装配置教程：从零到 Telegram 控制 AI Agent，含 Docker 沙箱

Hermes Agent 安装比大多数 AI Agent 框架简单——一行命令搞定所有依赖（Python 3.11、Node.js）。这篇带你从安装到接入 Telegram，再到 Docker 沙箱。

前置条件#

• 系统：Linux 或 macOS（Windows 用 WSL2）
• 必须：git
• 可选：Docker（沙箱隔离）

Step 1：一键安装#

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc   # 或 source ~/.bashrc
hermes --version

安装脚本自动安装 Python 3.11（uv）、Node.js（nvm）、所有依赖，并将 hermes 加入 PATH。

Step 2：选择 LLM 提供商#

hermes model

选项 A：OpenRouter（推荐） 一个 Key 访问 200+ 模型，包括 Claude、GPT-4、Gemini、Llama。注册 openrouter.ai，粘贴 API Key，选默认模型（推荐 anthropic/claude-sonnet-4-5）。

选项 B：直接用 Anthropic 在 hermes model 里选 Anthropic，选 Claude Code OAuth（已装 Claude Code 的无需再配 Key）或输入 Anthropic API Key。

选项 C：本地 Ollama（免费）

ollama pull llama3.3     # 8GB 显存
# hermes model 选 Custom Endpoint
# Base URL: http://localhost:11434/v1
# Model: llama3.3

Step 3：启动#

hermes          # 新对话
hermes -c       # 继续上次会话
hermes doctor   # 诊断配置
hermes update   # 更新版本

会话内常用斜杠命令：

Step 4：接入 Telegram（强烈推荐）#

4.1 创建 Bot#

1. Telegram 搜索 @BotFather
2. 发 /newbot，填名字和用户名（必须以 bot 结尾）
3. 保存返回的 Bot Token

4.2 配置网关#

hermes gateway telegram --token YOUR_BOT_TOKEN
hermes gateway start

Telegram 里找到你的 Bot，发消息就能控制 Hermes。终端和 Telegram 的对话历史、技能全部同步。

Step 5：Docker 沙箱（推荐）#

默认 Hermes 直接在本机执行命令。Docker 沙箱提供隔离：

hermes config set terminal.backend docker
hermes doctor  # 验证

沙箱内操作不影响主机文件系统。

Step 6：连接 MCP 工具（可选）#

编辑 ~/.hermes/config.yaml：

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

重启 hermes，Agent 就能操作 GitHub 了。

Step 7：安装社区技能#

hermes skills search "code review"
hermes skills install code-reviewer
hermes skills list

也可以在 clawhub.ai 浏览后安装。

配置定时任务#

> 每天早上 9 点检查 Hacker News AI 新闻，发摘要到 Telegram

Hermes 自动创建 cron 任务，通过网关定时推送，不需要手动编辑 crontab。

常见问题#

hermes: command not found

source ~/.zshrc
# 或手动加路径：export PATH="~/.hermes/bin:<your-PATH>"

国内安装超时

HTTPS_PROXY=http://127.0.0.1:7890 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

其他问题：hermes doctor 自动诊断，有问题的配置项标红。

来源：Hermes Agent 官方文档 | 整理：ClaudeEagle