Hermes 实例重建手册 🔄

Hermes 实例重建手册

版本: 1.3 | 更新日期: 2026-05-18 | 基准实例: Oracle H02

⚠️ 重要：当前实例运行在 Docker 容器内部（无 Docker socket），docker compose 命令不可直接使用。本手册的 Docker 命令适用于在宿主机上重建一个全新容器的场景，而非在容器内操作。

📑 两种重建路径

重建当前 Hermes 实例有两种方法：

方法一：配置法（纯默认路径）

步骤 1：docker-compose.yml

services:
  hermes:
    image: nousresearch/hermes-agent:v2026.5.7
    volumes:
      - ./data:/opt/data
    environment:
      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
    restart: unless-stopped

步骤 2：首次启动

docker compose up -d

步骤 3：修改 config.yaml

agent:
  disabled_toolsets: [browser, web]
  max_turns: 90
  gateway_timeout: 1800

model:
  default: deepseek-v4-flash
  provider: opencode-go

approvals:
  mode: smart
  timeout: 60
  cron_mode: allow
  mcp_reload_confirm: false

# 修改后自动 restart

步骤 3.1：.env 环境变量

TELEGRAM_BOT_TOKEN=...
OPENCODE_GO_API_KEY=...
TRILIUM_ETAPI_TOKEN=...
TRILIUM_ETAPI_URL=https://trilium.atibm.com/etapi
GOOGLE_API_KEY=...
V100_API_BASE=https://v1008080.atibm.com/v1
V100_API_KEY=...

步骤 4：第二次启动

docker compose up -d

步骤 5：聊天逐项恢复组件

5.1 注册 MCP 服务器

Trilium MCP：

[at c] 安装 Trilium MCP

PinchTab MCP（v2.4 最佳实践）：

用户发给 Agent 的对话：

[at c] 安装 pinchtab 到默认路径，注册 MCP，放行所有域名，
禁用原生浏览器，使用已有的 Chromium 引擎

Agent 收到后实际执行：

# Step 1: npm install → $HOME/pinchtab/
# Step 2: pinchtab config set security.allowedDomains '["*"]'
#         pinchtab config set browser.binary /opt/hermes/.../headless_shell
# Step 3: 改 config.yaml → mcp_servers.pinchtab (args: ["mcp"])
#                          disabled_toolsets: [browser, web]
# Step 4: CLI 验证 → pinchtab nav https://example.com --json
# Step 5: 重启 Gateway（需用户确认）
# Step 6: 最终验证 → "打开 example.com"

红线（违反就出问题）：

当前实例路径（参考）：/www/kc-ai-hermes/pinchtab/ — 历史原因手动迁移。新环境用 $HOME/pinchtab/。

官方资源：GitHub pinchtab/pinchtab → docs/guides/mcp-agents.md + skills/pinchtab/SKILL.md

5.2 恢复 gbrain 知识库

[at c] 验证 gbrain

学习安装 github的financial-services 增强金融分析能力

5.3 恢复 cron 定时任务

cron job 定义在 /opt/data/cron/jobs.json 中自动恢复。脚本路径在 ~/.hermes/scripts/ 下（当前实例 symlink 指向 /www/kc-ai-hermes/cron/run.sh）。

[at c] 重建 cron 脚本（Method 1）：
# 创建 ~/.hermes/scripts/hermes-cron-master.sh → symlink → 实际脚本
# 包含 tasks.conf + 各任务 run.sh + lib/report.sh

5.4~5.6 验证

[at c] 列出目前所有 cron
[at c] 测试手动触发 cron
[at c] 测试 MCP 工具
[at c] 检查 gbrain 状态

方法一恢复清单

方法二：目录映射法（完全一致克隆）

步骤 1：docker-compose.yml

services:
  hermes:
    image: nousresearch/hermes-agent:v2026.5.7
    volumes:
      - ./data:/opt/data
      - ./www:/www
    environment:
      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
      - HERMES_WORKSPACE_DIR=/www
    restart: unless-stopped

步骤 2：复制数据目录

• tar备份

  --exclude=data/www \
  --exclude=data/home/miniconda3 \
  --exclude=data/data/home/.* \
  --exclude=data/data/.npm \
  --exclude=data/data/.cache \

• tar恢复

  tar -xzf ~/at.tar.gz -C /www/hermes
  tar -xzvf ~/x99_20260519132010.tar.gz -C / www/hermes/at

步骤 3：启动

docker compose up -d

方法二自动恢复的组件

组件层级对照

Oracle H02 实例快照

— 本文档由 Hermes Agent 维护于 Trilium | v1.3 同步 PinchTab 安装最佳实践 v2.4