Hermes
准备 API
在配置之前，请确保已获取以下信息
API Key
以 magik- 开头的字符串。 Base URL (接口地址)
地址：https://api.magikcloud.cn/v1
重要：务必包含末尾的
/v1
模型名称
请在模型广场复制完整模型名称，如：DeepSeek-V4-Pro
安装 Hermes
通过 Hermes 官方渠道下载并安装。 Installation | Hermes Agent
Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Hermes不支持原生 Windows。请安装 WSL2 并从那里运行 Hermes Agent。上面的安装命令在 WSL2 内有效。
Android / Termux
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
接入 Hermes
编辑配置文件
修改 ~/.hermes/config.yaml，添加或更新模型配置：
model:
default: GLM-5.1
provider: custom
base_url: https://api.magikcloud.cn/v1
api_key: magik-你的API密钥
context_length: 200000
max_tokens: 200000
关键字段说明
| 字段 | 说明 |
|---|---|
default |
默认使用的模型名称（如 GLM-5.1 / DeepSeek-V4-Pro / MiniMax-M2.7） |
provider |
设置为 custom 表示使用自定义接口 |
base_url |
接口地址，务必包含末尾的 /v1 |
api_key |
API 密钥（以 magik- 开头） |
context_length |
上下文长度 |
max_tokens |
最大输出 token 数 |
| ### 切换模型 |
如需切换模型，修改 default 字段为其他模型名称即可：
model:
default: DeepSeek-V4-Pro
provider: custom
base_url: https://api.magikcloud.cn/v1
api_key: magik-你的API密钥
context_length: 200000
max_tokens: 200000
保存与生效
保存配置文件后，执行以下命令重启 Hermes 即可应用新配置。