Hermes Agent 使用手册：会「长脑子」的开源 AI 智能体

Hermes Agent 支持 Linux、macOS、WSL2（Windows 子系统）和 Termux（Android）。Windows 用户需要先安装 WSL2。

Windows 安装 WSL2：

1. 以管理员身份打开 PowerShell
2. 运行：wsl --install
3. 重启电脑后，打开 Ubuntu 终端

macOS / Linux 用户直接跳到下一步。

确认你的环境：

# 检查 Node.js（需要 18+）
node -v

# 检查 Python（需要 3.10+）
python3 --version

# 检查 Git
git --version

# 一行命令安装（推荐）
curl -fsSL https://hermes.xaapi.ai/install.sh | bash

# 或者用 npm 安装
npm install -g hermes-agent

# 验证安装
hermes --version

安装完成后，初始化配置：

hermes init

系统会引导你完成基本设置：选择默认模型、配置 API Key、设置消息平台。

Hermes Agent 需要 API Key 来调用大模型。最简单的配置方式：

# 编辑配置文件
hermes config edit

# 或直接设置环境变量
export OPENAI_API_KEY="sk-xxx"           # OpenAI
export ANTHROPIC_API_KEY="sk-ant-xxx"    # Claude
export GLM_API_KEY="xxx.xxx"             # 智谱 GLM
export MOONSHOT_API_KEY="sk-xxx"         # Kimi

国内用户推荐配置：

# 方案 A：智谱 GLM-5.1（推荐，国内直连）
export GLM_API_KEY="你的智谱API Key"
hermes config set defaultModel "glm-5.1"

# 方案 B：通过 OpenRouter 使用多种模型
export OPENROUTER_API_KEY="sk-or-xxx"
hermes config set defaultModel "openrouter:auto"

# 启动 CLI 交互模式
hermes chat

# 或直接提问
hermes ask "帮我分析一下这段 Python 代码的性能问题"

Web 仪表盘模式（v0.9.0+ 新增）：

# 启动本地 Web UI
hermes web

# 浏览器自动打开 http://localhost:3000

在 Web UI 中，你可以更直观地管理对话、查看记忆、编辑 Skills。

接入微信（推荐 WeChat Gateway）：

# 安装微信平台插件
hermes platform add wechat

# 扫码登录
hermes wechat login

扫码后在微信中就能直接和 Hermes 对话了。

接入飞书：

# 安装飞书平台插件
hermes platform add feishu

# 配置飞书应用
hermes feishu setup

按提示创建飞书自建应用，配置事件订阅即可。

接入钉钉：

hermes platform add dingtalk
hermes dingtalk setup

这是 Hermes 最独特的功能。当你完成一个任务后，Hermes 会自动提炼可复用的 Skills：

1. 和 Hermes 完成一个稍微复杂的任务，比如："帮我写一份周报，总结本周完成的功能开发、遇到的问题和下周计划"
2. 任务完成后，Hermes 会自动提示：✨ New skill created: weekly-report-generator
3. 下次你只需说"写周报"，Hermes 就会自动加载这个 Skill

查看和管理 Skills：

# 列出所有 Skills
hermes skills list

# 查看某个 Skill 的详情
hermes skills show weekly-report-generator

# 手动创建 Skill
hermes skills create my-skill

# 从 OpenClaw 迁移 Skills
hermes claw migrate --skills

Hermes 的记忆分为三层，各司其职：

# 查看记忆概况
hermes memory stats

# 搜索历史记忆
hermes memory search "上周讨论的数据库方案"

# 清除特定记忆
hermes memory forget --before 2026-01-01

# 完整迁移（设置 + 记忆 + Skills + API Keys）
hermes claw migrate

# 只迁移 Skills
hermes claw migrate --skills

# 只迁移记忆
hermes claw migrate --memory

# 查看迁移预览（不实际执行）
hermes claw migrate --dry-run

迁移完成后，你的 Hermes 会拥有和 OpenClaw 一样的"记忆"和"技能"，无缝切换。

# 拉取官方镜像
docker pull hermesagent/hermes:latest

# 运行容器
docker run -d \
  --name hermes \
  -e GLM_API_KEY="你的Key" \
  -v hermes-data:/app/data \
  -p 3000:3000 \
  hermesagent/hermes:latest

# 访问 Web UI
# http://localhost:3000