> ## 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

## 1. 获取 API Key

打开 [Ace Data Cloud 应用列表](https://platform.acedata.cloud/console/applications)，进入可用的应用并复制 API Key。

![获取 Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. 保存 Key

在 `~/.hermes/.env` 中写入：

```dotenv theme={null}
ACEDATACLOUD_API_KEY=你的 API Key
```

## 3. 配置 Provider

在 `~/.hermes/config.yaml` 中加入：

```yaml theme={null}
providers:
  acedatacloud:
    api: https://api.acedata.cloud/v1
    key_env: ACEDATACLOUD_API_KEY
    transport: chat_completions
    default_model: MODEL_ID

model:
  provider: custom:acedatacloud
  default: MODEL_ID
```

将两处 `MODEL_ID` 替换为 Coding Plan 当前提供的同一个模型 ID。不要把真实 Key 写进 YAML 或提交 `.env`。

## 4. 验证

```bash theme={null}
hermes config check
hermes -z "Reply only OK" --provider custom:acedatacloud --model MODEL_ID --ignore-rules
```

如果返回 401，检查 `~/.hermes/.env`；如果配置未生效，完全退出并重启 Hermes。

## 官方参考

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