hermes-agent

Hermes Agent — 部署与管理

Hermes Agent 是 Nous Research 推出的自我改进型 AI Agent。它会从经验中创建技能、搜索过往对话，并在多个会话中构建用户模型。

• 仓库：github.com/NousResearch/hermes-agent（11k+ 星标，MIT 许可证）
• 文档：hermes-agent.nousresearch.com/docs/
• 技能中心：agentskills.io

快速参考

项目	值
配置目录	~/.hermes/
配置文件	~/.hermes/config.yaml
密钥	~/.hermes/.env
身份信息	~/.hermes/SOUL.md
日志	~/.hermes/logs/
会话	~/.hermes/sessions/
技能	~/.hermes/skills/
记忆	~/.hermes/memories/
Cron 任务	~/.hermes/cron/
网关配置	~/.hermes/gateway.json

安装

快速安装（Linux/macOS/WSL2）

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

自动安装：uv、Python 3.11、Node.js v22、ripgrep、ffmpeg。唯一的前置条件是 git。 不支持原生 Windows，请使用 WSL2。

手动安装

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"
uv pip install -e "./mini-swe-agent"
npm install  # optional, for MCP/browser tools

mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env
chmod 600 ~/.hermes/.env

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Docker 部署

docker build -t hermes-agent:local .
docker run --rm -it \
  -v "$PWD:/home/agent/workspace" \
  -v "$HOME/.hermes:/home/agent/.hermes" \
  hermes-agent:local hermes

以 agent 用户身份运行。挂载 ~/.hermes 以持久化数据。

社区 Docker 镜像：

• xmbshwll/hermes-agent-docker
• Crustocean/hermes-agent-template
• ellickjohnson/portainer-stack-hermes

验证

hermes doctor        # Diagnose issues
hermes doctor --fix  # Auto-repair
hermes status --deep # Full status check

配置

完整配置参考：references/configuration.md

首要步骤

hermes model          # Select LLM provider/model
hermes tools          # Configure enabled tools
hermes config check   # Check for missing options
hermes config migrate # Add options introduced in updates

最简 .env

# Pick one provider
ANTHROPIC_API_KEY=sk-ant-...
# OR
OPENROUTER_API_KEY=sk-or-...

配置管理

hermes config show        # View current
hermes config edit        # Open in editor
hermes config set KEY VAL # Set value (auto-routes secrets to .env)
hermes config path        # Print config file path

消息网关

完整网关参考：references/messaging.md

快速设置

hermes gateway setup     # Interactive platform config
hermes gateway install   # Install as user systemd service
sudo loginctl enable-linger $USER  # Survive logout
hermes gateway start
hermes gateway status

支持的平台

Telegram、Discord、Slack、WhatsApp、Signal、SMS、Email、Home Assistant、 Mattermost、Matrix、DingTalk、webhooks。

安全（重要）

# Set explicit allowlists in .env — NEVER use GATEWAY_ALLOW_ALL_USERS=true
TELEGRAM_ALLOWED_USERS=123456789,987654321
DISCORD_ALLOWED_USERS=123456789012345678

# DM pairing for unknown users
hermes pairing approve telegram XKGH5N7P
hermes pairing list
hermes pairing revoke telegram 123456789

OpenClaw 迁移

Hermes 会在设置期间自动检测 ~/.openclaw。

hermes claw migrate              # Interactive full migration
hermes claw migrate --dry-run    # Preview first
hermes claw migrate --overwrite  # Overwrite conflicts

迁移内容：SOUL.md、记忆、技能、允许列表、消息设置、API 密钥、TTS 文件。

常见操作

任务	命令
交互式聊天	hermes
单次查询	hermes chat -q "..."
更改模型	hermes model
更新	hermes update
恢复会话	hermes -c 或 hermes -r <id>
浏览技能	hermes skills browse
安装技能	hermes skills install <name>
Cron 任务	hermes cron list / hermes cron create
分析	hermes insights --days 7
卸载	hermes uninstall --full --yes

Systemd（生产环境）

# User service
hermes gateway install
sudo loginctl enable-linger $USER
journalctl --user -u hermes-gateway -f

# System service (starts at boot)
sudo hermes gateway install --system

故障排除

症状	解决方法
hermes: command not found	source ~/.bashrc，检查 PATH 中是否包含 ~/.local/bin
缺少依赖	hermes doctor --fix
网关无法启动	检查 ~/.hermes/logs/gateway.log
身份验证失败	hermes login --provider <name>，或检查 .env
更新后配置过期	hermes config migrate
迁移问题	先运行 hermes claw migrate --dry-run

配置文件集成

部署到远程服务后，更新设备配置文件：

1. 将 hermes-agent 添加到 profile.servers[].apps[]
2. 在 profile.deployments{} 中记录部署信息
3. 通过 log_admin_event 记录日志