Hermes Agent 部署教程：一键安装、Docker、Dashboard 与 Gateway

sudo useradd -m -s /bin/bash hermesuser
sudo usermod -aG sudo hermesuser

sudo visudo

sudo su - hermesuser

sudo -n true && echo "sudo 免密已生效"

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

source ~/.bashrc

sudo apt install ripgrep -y

brew install ripgrep

sudo apk add ripgrep

rg --version

hermes

hermes setup

~/.hermes/.env

~/.hermes/config.yaml

~/.hermes/cron/
~/.hermes/sessions/
~/.hermes/logs/

hermes doctor
hermes -z "请只回复：模型连通性测试通过"

hermes config show | sed -n '/^model:/,/^[^ ]/p'
hermes -z "请只回复：模型连通性测试通过"

The model provider failed after retries. I kept raw provider details out of chat; check gateway logs for diagnostics.

journalctl --user -u hermes-gateway.service -n 120 --no-pager -o cat

hermes dashboard --host 0.0.0.0 --port 9119 --tui --insecure

http://服务器IP:9119

hermes gateway install
hermes gateway start
hermes gateway status

hermes config set approvals.mode smart
hermes config set command_allowlist '["stop/restart system service"]'
hermes config set telegram.reply_to_mode off
hermes config set telegram.gateway_restart_notification true
hermes config set platforms.telegram.reply_to_mode off
hermes config set platforms.telegram.gateway_restart_notification true
hermes config set platforms.telegram.extra.disable_link_previews true
hermes config set display.tool_progress off
hermes config set display.interim_assistant_messages false
hermes config set display.background_process_notifications off
hermes config set display.cleanup_progress true

hermes config set approvals.mode yolo

hermes config set approvals.mode smart

systemd-run --user --on-active=5s systemctl --user restart hermes-gateway

systemctl --user list-units 'hermes*' --no-pager

display:
  tool_progress: off
  cleanup_progress: true
  interim_assistant_messages: false
  long_running_notifications: true
  busy_ack_detail: true
  background_process_notifications: off
  platforms:
    telegram:
      tool_progress: off
      cleanup_progress: true
      interim_assistant_messages: false
      long_running_notifications: true
      busy_ack_detail: true
      background_process_notifications: off

streaming:
  enabled: false

platforms:
  telegram:
    reply_to_mode: off
    gateway_restart_notification: true
    guest_mode: false
    extra:
      disable_link_previews: true

你现在运行在一台刚安装好的 Hermes Agent 服务器上。请先做一次保守的安装后优化，不要猜测不存在的配置字段。

目标：
1. 让 Telegram bot 保持安静，只显示最终回答、必要心跳和心跳里的工作进度细节。
2. 保留危险操作确认，不开启全局 yolo。
3. 确认 Gateway 能长期运行并能随用户会话/系统重启恢复。
4. 确认 Hermes 的配置、环境变量、sessions、memory、skills、cron 和 logs 已纳入备份范围。
5. 不把 Dashboard 或 Gateway API 无认证暴露到公网。

执行要求：
1. 先读取本机配置和当前版本帮助，例如 ~/.hermes/config.yaml、~/.hermes/.env、`hermes config --help`、`hermes gateway --help`，以及当前版本能找到的 cli-config.yaml.example。如果机器可以联网，再对照 Hermes 官方 Configuration Options。
2. 修改前先备份：
   cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak.$(date +%Y%m%d-%H%M%S)
3. 优先使用 Hermes 官方提供的 `hermes config set` 命令调整参数，保持配置文件规范；不要优先手写 YAML。请按功能执行下面 11 处调整：
   hermes config set approvals.mode smart
   # 开启智能审批模式。低风险命令自动放行，高风险命令仍然提示确认。比 manual 少打扰，比 YOLO/off 安全。

   hermes config set command_allowlist '["stop/restart system service"]'
   # 加入命令审批白名单，允许“停止/重启系统服务”这类操作更容易通过审批。注意：这是偏权限放宽的配置，新环境里如果要更保守，可以先不加。

   hermes config set display.background_process_notifications off
   # 关闭后台进程通知。避免后台任务、进程状态变化频繁打扰 Telegram。

   hermes config set display.cleanup_progress true
   # 开启清理进度信息。通常用于让界面或消息里的进度展示更干净，减少残留进度噪声。

   hermes config set display.interim_assistant_messages false
   # 关闭中间态助手消息。减少“我正在处理/中间进度”这类临时消息，更安静。

   hermes config set display.tool_progress off
   # 关闭工具调用进度提示。减少 Telegram 里显示工具执行过程的噪声，只看最终结果。

   hermes config set platforms.telegram.extra.disable_link_previews true
   # 关闭 Telegram 链接预览。避免发送链接时自动展开预览，消息更清爽。

   hermes config set platforms.telegram.gateway_restart_notification true
   # 开启 platforms.telegram 路径下的网关重启/上线提醒。建议和 telegram.gateway_restart_notification 一起设置，避免不同加载路径漏生效。

   hermes config set platforms.telegram.reply_to_mode off
   # 关闭 Telegram 回复引用模式。机器人回复时不引用或挂在线程式回复到原消息，聊天界面更干净。

   hermes config set telegram.gateway_restart_notification true
   # 开启 Telegram 顶层配置里的网关重启/上线提醒。重启后会收到类似 “Gateway online” 的上线提示。

   hermes config set telegram.reply_to_mode off
   # 关闭 Telegram 顶层配置里的回复引用模式。和 platforms.telegram.reply_to_mode off 建议一起设置。
4. 导入机器人、批量恢复配置或初始化 profile 时，如果确认当前环境风险可控，可以先临时开启 YOLO 来减少确认：
   hermes config set approvals.mode yolo
   批量操作完成后必须切回：
   hermes config set approvals.mode smart
5. 检查 Telegram 入口权限，优先使用 pairing、allowed users 或 allowed chats，不要设置 allow all users。
6. 检查 platform_toolsets。如果 Telegram 是日常入口，不要默认给不可信群聊开放过强工具；至少说明当前 Telegram 可用哪些工具集。
7. 检查 systemd user 服务：
   systemctl --user status hermes-gateway.service --no-pager
   systemctl --user list-units 'hermes*' --no-pager
8. 如果需要长期运行，确认当前 Linux 用户已执行 loginctl enable-linger，或者说明为什么不需要。
9. 修改后运行：
   hermes doctor
   hermes gateway status
10. 做一次真实模型连通性检查。不要只看 hermes doctor；请同时确认当前默认模型配置，并用一次性 prompt 实测：
   hermes config show | sed -n '/^model:/,/^[^ ]/p'
   hermes -z "请只回复：模型连通性测试通过"
   如果 Telegram 或日志出现 provider failed，请查看 gateway 日志并只汇报 provider、model、base_url、HTTP 状态码和简短错误原因，不要打印任何 token。常见例子：HTTP 402 通常是模型账户余额不足，不是 gateway 挂了。
11. 如果需要让新配置立即生效，不要在当前 Telegram 回复还没发完时直接重启 gateway。请优先安排延迟重启，例如：
   systemd-run --user --on-active=5s systemctl --user restart hermes-gateway
   如果服务名不同，先用下面命令确认：
   systemctl --user list-units 'hermes*' --no-pager
12. 最后给出变更摘要，列出改了哪些文件、哪些字段、哪些命令成功、模型连通性是否通过、是否已安排延迟重启、哪些地方需要人工确认。说明：如果 gateway 重启导致当前 Telegram 会话短暂中断，这是预期行为。

限制：
- 不要删除现有配置。
- 不要打印 API Key、Telegram Token、SSH 密钥、cookie 或密码。
- 不要把 Dashboard 的 --insecure 服务暴露到公网。
- 不要启用全局 yolo。
- 不要运行破坏性命令。

请帮我基于当前默认 Hermes 配置，创建一个专门写代码的 Telegram 机器人 profile。

目标：
1. 使用官方 profile 命令从当前默认 profile 克隆一个新 profile，名称用 code。
2. 如果默认 profile 已经配置好，可以用普通 clone 作为起点，复用基础配置和安静模式；不要使用 `--clone all` 直接全量复制，避免把原机器人的 Telegram token、模型和环境引用也一起带过去。
3. 新 profile 使用单独的 Telegram bot token，不要复用默认机器人的 token。
4. 新 profile 使用单独的大模型配置，不要沿用默认机器人的 model/provider/base_url/API key。模型用于写代码、排障和服务器维护。
5. 新 profile 的 sessions、memory、skills、cron 和 gateway 服务要和默认 profile 分开。
6. 新 profile 面向写代码、排障、服务器维护和技术任务，但 Telegram 里仍然保持安静。
7. 新 profile 要有单独的写代码人格/说明，不要完全沿用默认日常助手的性格。它可以中文、技术向、简洁、主动验证，适合开发、排障和运维。

执行步骤：
1. 先读取官方 profile/gateway/config/tools 文档或本机帮助，确认当前版本的准确命令和配置 schema：
   hermes --version
   hermes profile --help
   hermes gateway --help
   hermes config --help
   hermes tools --help
   hermes profile list
2. 修改前先检查是否已经有等价备份。列出：
   ls -lh ~/.hermes/config.yaml ~/.hermes/config.yaml.bak.* 2>/dev/null
   如果最近的备份和当前 `~/.hermes/config.yaml` 内容一致，就不要二次备份；如果没有备份，或当前配置已经有新改动，再执行：
   cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak.$(date +%Y%m%d-%H%M%S)
3. 如果当前版本提供配置迁移或校验命令，例如 `hermes config migrate`，只在已经确认有可用备份后执行。不要手工改 `_config_version`，不要猜新字段。
4. 如果接下来要连续创建 profile、写入模型和 gateway 配置，可以临时减少确认打断；但不要长期保持全局 YOLO。当前这次批量操作前可以临时设置：
   hermes config set approvals.mode off
   批量操作结束后必须恢复：
   hermes config set approvals.mode smart
   如果我是从 shell 里手动启动一个新的临时 Hermes 会话，也可以改用一次性启动参数 `hermes --yolo`，任务结束退出即可；不要把它当作长期配置。
   如果中途失败或不确定下一步，也先恢复：
   hermes config set approvals.mode smart
5. 创建 profile。优先使用官方 clone 命令，例如：
   hermes profile create code --clone --description '写代码、排障和运维专用 Hermes profile；继承默认 profile 的基础配置、安静模式和安全策略。'
   不要使用 `--clone all`，除非你明确确认当前版本不会复制不该共用的 token、模型、sessions、memory 或 gateway state。
6. 检查新 profile 配置文件路径，通常类似：
   ~/.hermes/profiles/code/config.yaml
   同时确认 code profile 的 `.env` 路径，通常类似：
   ~/.hermes/profiles/code/.env
   `.env` 权限应尽量收紧：
   chmod 600 ~/.hermes/profiles/code/.env
7. 把新 Telegram bot token 配到 code profile 对应的环境或 gateway 配置里。不要覆盖默认 profile 的 Telegram token。检查时只列出变量名，不要打印变量值，例如只汇报存在 `TELEGRAM_BOT_TOKEN` 之类的键名。
8. 给 code profile 配置专用大模型。请先询问我要使用哪个 provider、model、base_url 和 API key 环境变量名；如果我已经提供，就只写入 code profile，不要改默认 profile。配置完成后明确列出 code profile 当前使用的模型，例如：
   model.provider = <code-provider>
   model.default = <code-model>
   model.base_url = <code-base-url>
   API key 从 code profile 对应 .env 或环境变量读取，不要明文打印。
9. 普通 `--clone` 可能会继承默认 profile 的人格、SOUL/说明或 display personality。请检查 code profile 是否还是日常助手口吻；如果是，就单独调整成写代码机器人。目标风格：
   - 中文回复
   - 技术向但不啰嗦
   - 先读项目和当前配置，再动手
   - 优先使用 rg、git、测试和官方命令
   - 修改前说明风险，修改后验证结果
   - 适合开发、排障、服务器维护和自动化任务
   如果当前版本支持配置项，可以把 code profile 的显示风格设成 technical；如果使用 SOUL.md 或 profile 说明文件，就只改 code profile 自己的说明文件，不要改默认 profile。
10. 普通 `--clone` 理论上已经继承默认 profile 的安静模式。不要无脑重写整段配置；只检查 code profile 是否已经继承这些关键项，缺什么再用 `hermes -p code config set ...` 补什么：
   display.tool_progress = off
   display.interim_assistant_messages = false
   display.background_process_notifications = off
   platforms.telegram.reply_to_mode = off
   platforms.telegram.extra.disable_link_previews = true
   telegram.reply_to_mode = off
   如果默认 profile 已经开启 gateway 上线提醒，也让 code profile 保持一致：
   telegram.gateway_restart_notification = true
   platforms.telegram.gateway_restart_notification = true
11. 为 code profile 检查工具权限和 Telegram 平台工具集。写代码 profile 可以保留 terminal、file、web、browser、skills、todo 等开发工具，但不要开启全局 yolo；危险操作仍需确认。如果 clone 后工具状态已经符合预期，不要重复改。重点核对：
   hermes -p code tools list
   platform_toolsets.telegram 是否符合风险预期
   如果这个 bot 只给自己私聊使用，可以保留开发工具；如果以后会进群，必须单独收窄 Telegram 可用工具。
12. 配置 Telegram 访问授权。优先使用当前版本支持的 pairing、allowed users 或 allowed chats，不要让任何人都能调用 code profile。至少确认：
   - 第二个 Telegram bot token 只属于 code profile
   - code profile 只允许我的 Telegram 用户或指定私聊
   - 如果进群，先限制群 ID 或只响应 mention/thread
13. 安装或启动 code profile 的 gateway。若 Hermes 支持 profile 参数，请使用 code profile 对应方式，例如：
   hermes --profile code gateway install
   hermes --profile code gateway start
   hermes --profile code gateway status
   如果当前版本命令不同，按 `hermes gateway --help` 的官方输出执行。
14. 检查 systemd user 服务名，可能类似：
   hermes-gateway-code.service
   请用 `systemctl --user list-units 'hermes*' --no-pager` 确认，不要凭空假设。
15. 在第二个 Telegram bot 里发送 `/sethome`，把当前聊天设为 code profile 的 home channel。
16. 先做 CLI 侧真实连通性测试，再做 Telegram 测试。不要只看配置文件：
   hermes --profile code -z "请只回复：code profile 模型连通性测试通过"
   然后在第二个 Telegram bot 里发一句测试消息，确认回复来自 code profile。
17. 运行：
   hermes --profile code doctor
   hermes --profile code gateway status
   如果失败，查看对应 gateway 日志，但只汇报 provider、model、base_url、HTTP 状态码和简短错误原因，不要打印 token。
18. 最后再次确认审批模式已经恢复为 smart，并汇报：
   - 创建了哪个 profile
   - 新 profile 配置文件路径
   - 新 profile .env 路径和权限是否正确，不打印密钥值
   - code profile 使用的 provider、model 和 base_url
   - code profile 的人格/说明是否已调整为写代码、排障和运维专用
   - code profile 的 Telegram 访问授权是否已限制
   - code profile 的工具集和 platform_toolsets.telegram 是否符合预期
   - 新 gateway 服务名
   - 第二个 Telegram bot 是否已连接
   - CLI 和 Telegram 真实连通性测试是否通过
   - 安静模式是否生效
   - 当前 `approvals.mode` 是否已恢复为 smart
   - 还有哪些需要我手动确认

限制：
- 不要打印 Telegram bot token 或任何 API Key。
- 不要覆盖默认 profile 的配置和 token。
- 不要修改默认 profile 的模型配置。
- 不要删除默认机器人的 gateway 服务。
- 不要启用全局 yolo。
- 不要运行破坏性命令。

tmux new -s hermes 'hermes gateway run'

mkdir -p ~/docker/hermes
cd ~/docker/hermes

x-common: &common
  image: nousresearch/hermes-agent:latest
  volumes:
    - ./hermes:/opt/data
  environment:
    - HERMES_UID=1000
    - HERMES_GID=1000
  restart: unless-stopped

services:
  gateway:
    <<: *common
    container_name: hermes-gateway
    network_mode: host
    command: ["hermes", "gateway", "run"]

  dashboard:
    <<: *common
    container_name: hermes-dashboard
    ports:
      - "127.0.0.1:9119:9119"
    command: ["hermes", "dashboard", "--host", "0.0.0.0", "--port", "9119", "--tui", "--no-open", "--insecure"]

docker compose up -d

docker compose logs -f

docker compose down

ssh -L 9119:127.0.0.1:9119 hermesuser@服务器IP

http://127.0.0.1:9119

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
mkdir -p ~/.hermes
echo 'NVIDIA_API_KEY=<替换为你的Nvidia API Key>' > ~/.hermes/.env
hermes setup
hermes

sudo nano /etc/systemd/system/hermes-dashboard.service

[Unit]
Description=Hermes Dashboard
After=network.target

[Service]
Type=simple
User=你的用户名
ExecStart=/home/你的用户名/.local/bin/hermes dashboard --port 9119 --tui --insecure
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable hermes-dashboard
sudo systemctl start hermes-dashboard
sudo systemctl status hermes-dashboard

--host 0.0.0.0

hermes --version

hermes doctor

hermes uninstall

hermes uninstall --full --yes