How to Deploy and Configure Hermes Agent on QNAP NAS with Container Station

如何在 QNAP NAS 上使用 Container Station 部署和配置 Hermes Agent

Container Station will automatically create the hermes-data folder on first run when the volume path is declared in the Compose file. No prior folder creation or SSH access is required. Alternatively, the folder can be created in advance via File Station.

1. Open Container Station in the QNAP web interface.
2. Navigate to Applications and click Create.
3. Select Create Application and paste the following Docker Compose YAML:

4. version: "3.8"
   
   services:
     hermes:
       image: nousresearch/hermes-agent:latest
       container_name: hermes
       restart: unless-stopped
       command: gateway run
       volumes:
         - /share/Container/hermes-data:/opt/data
   
   

5. Click Create. Container Station will pull the image and start the container. The hermes-data folder will be created automatically at /share/Container/hermes-data.
6. Verify the container is running by checking the Containers list. The status should show Running.

Note: All credentials are managed by the setup wizard in Step 2 and stored in the data volume. 

After the container is running, open an interactive shell session to complete first-time configuration. The setup wizard configures your LLM provider, API keys, and messaging platform tokens, writing all settings to the persistent data volume.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash (or /bin/sh if bash is unavailable) to open an interactive shell.
3. In the shell, run:
   hermes setup

4. 

   

5. Follow the on-screen prompts to configure:
   • LLM provider and model (e.g., OpenAI, Anthropic, OpenAI Codex)
   • API keys
   • Messaging platform (e.g., Telegram bot token) — recommended at this stage
6. The wizard writes your settings to /opt/data/config.yaml and /opt/data/.env. This step only needs to be performed once.
7. After the wizard completes, type exit to close the shell, then restart the container via Container Station to apply the configuration.

1. In Container Station, select the hermes container and click Logs.
2. Confirm the following lines appear in the output:
   Hermes Gateway Starting...
3. Click Execute and select /bin/bash (or /bin/sh if bash is unavailable) to open an interactive shell.
4. In the shell, run:  hermes 
5. Then you can talk to it.
6. If using Telegram, send a message to your configured bot to verify the connection.

Use the hermes model command to interactively switch providers or models at any time.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash (or /bin/sh ).
3. In the terminal session, run:
   hermes model
4. Follow the interactive prompts to select a new provider and model. The selection is saved to config.yaml automatically.

Supported providers include: anthropic, openai-codex, openai, openrouter, nous, deepseek, minimax, and others. For a full list, refer to the official CLI reference.

Use hermes setup gateway to add or update messaging integrations (Telegram, Discord, Slack, WhatsApp, Signal, etc.) without re-running the full setup wizard.

1. In Container Station, select the hermes container.
2. Click Execute and select /bin/bash.
3. Run:
   hermes setup gateway
4. Follow the prompts to add or update your messaging platform credentials.
5. Restart the container after completing the wizard:
   exit
   Then restart via Container Station — select the container and click Restart.

To reconfigure any part of the setup (model, terminal backend, tools, gateway, agent personality), run the full wizard or a specific section:

1. Open a shell in the container via Container Station Execute.
2. Run the full wizard:
   hermes setup
3. Or run a specific section only:
   • hermes setup model — LLM provider and model
   • hermes setup gateway — Messaging platform configuration
   • hermes setup tools — Enable or disable tools
   • hermes setup terminal — Terminal backend (local, Docker sandbox, SSH)
   • hermes setup agent — Agent identity and personality (SOUL.md)
4. Restart the container after making changes.

Container Station 将在运行时自动创建hermes-data文件夹，当在 Compose 文件中声明了卷路径时。无需提前创建文件夹或 SSH 访问。或者，可以通过 File Station 提前创建文件夹。

1. 在 QNAP 网页界面中打开 Container Station。
2. 导航到应用程序并点击创建。
3. 选择创建应用程序  并粘贴以下 Docker Compose YAML：

4. version: "3.8"
   
   services:
     hermes:
       image: nousresearch/hermes-agent:latest
       container_name: hermes
       restart: unless-stopped
       command: gateway run
       volumes:
         - /share/Container/hermes-data:/opt/data

5. 点击创建。Container Station 将拉取镜像并启动容器。hermes-data文件夹将在/share/Container/hermes-data自动创建。
6. 通过检查容器列表来验证容器是否正在运行。状态应显示运行中。

注意：所有凭据由步骤 2 中的设置向导管理，并存储在数据卷中。

容器运行后，打开一个交互式 shell 会话以完成配置。设置向导配置您的 LLM 提供商、API 密钥和消息平台令牌，并将所有设置写入持久数据卷。

1. 在 Container Station 中，选择hermes容器。
2. 点击执行并选择/bin/bash（或/bin/sh如果 bash 不可用）以打开交互式 shell。
3. 在 shell 中运行：
   hermes setup

4. 

   

5. 按照屏幕上的提示进行配置：
   • LLM 提供商和模型（例如，OpenAI，Anthropic，OpenAI Codex）
   • API 密钥
   • 消息平台（例如，Telegram 机器人令牌）——此阶段推荐
6. 向导将您的设置写入/opt/data/config.yaml和/opt/data/.env。此步骤只需执行一次。
7. 向导完成后，输入exit关闭 shell，然后通过 Container Station 重启容器以应用配置。

1. 在 Container Station 中，选择hermes容器并点击Logs。
2. 确认输出中出现以下行：
   Hermes Gateway Starting...
3. 点击Execute并选择/bin/bash（如果 bash 不可用，则选择/bin/sh）以打开交互式 shell。
4. 在 shell 中运行： hermes 
5. 然后您可以与其对话。
6. 如果使用 Telegram，向您配置的机器人发送消息以验证连接。

使用hermes model命令随时交互式切换提供商或模型。

1. 在 Container Station 中，选择hermes容器。
2. 点击Execute并选择/bin/bash（或/bin/sh ）。
3. 在终端会话中运行：
   hermes model
4. 按照交互提示选择新的提供商和模型。选择将自动保存到config.yaml。

支持的提供商包括：anthropic、openai-codex、openai、openrouter、nous、deepseek、minimax等。完整列表请参阅官方 CLI 参考。

使用hermes setup gateway添加或更新消息集成（Telegram、Discord、Slack、WhatsApp、Signal 等），无需重新运行完整的设置向导。

1. 在 Container Station 中，选择hermes容器。
2. 点击Execute并选择/bin/bash。
3. 运行：
   hermes setup gateway
4. 按照提示添加或更新您的消息平台凭据。
5. 完成向导后重启容器：
   exit
   然后通过 Container Station 重启——选择容器并点击Restart。

要重新配置设置的任何部分（模型、终端后端、工具、网关、代理个性），请运行完整的向导或特定部分：

1. 通过 Container Station Execute 在容器中打开一个 shell。
2. 运行完整的向导：
   hermes setup
3. 或仅运行特定部分：
   • hermes setup model — LLM 提供商和模型
   • hermes setup gateway — 消息平台配置
   • hermes setup tools — 启用或禁用工具
   • hermes setup terminal — 终端后端（本地，Docker 沙箱，SSH）
   • hermes setup agent — 代理身份和个性（SOUL.md）
4. 更改后重启容器。