> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent 交互式配置指南

> AceDataCloud Coding Plan 集成指南 - Ace Data Cloud

使用 Hermes Agent 自带的 `hermes model` 向导连接 Ace Data Cloud。向导负责写入 `~/.hermes/config.yaml` 和 `~/.hermes/.env`，适合不想手动编辑 YAML 的用户。

## 配置步骤

1. 在 Ace Data Cloud 控制台创建 Coding 专属 API Token。
2. 运行 `hermes model`，选择添加自定义 OpenAI-compatible Provider。
3. 按下面填写：

| 字段                           | 值                              |
| ---------------------------- | ------------------------------ |
| Provider name                | `acedatacloud`                 |
| Base URL                     | `https://api.acedata.cloud/v1` |
| API key environment variable | `ACEDATACLOUD_API_KEY`         |
| Model                        | 在 Coding 配置向导中选择的模型 ID         |
| API format                   | Chat Completions               |

4. 保存后完全退出并重新启动 Hermes。

Token 只写入本机凭据文件，不要提交到仓库、Issue、日志或截图。

## 验证

```bash theme={null}
hermes --version
hermes chat --model MODEL_ID "Reply only OK"
```

如果返回 401，检查 `~/.hermes/.env` 中的 Token；如果修改未生效，重新启动 Hermes。部分只提供流式响应的兼容服务还需要在 Hermes 的 `auxiliary.stream_only_base_urls` 中登记，本配置的普通聊天无需额外设置。

## 官方参考

* [Hermes Agent 配置](https://hermes-agent.nousresearch.com/docs/user-guide/configuration/)
* [Hermes Agent Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers/)

返回 [Coding Plan 配置中心](https://platform.acedata.cloud/documents/coding-plan-integration)。