# Hermes Agent
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
[Hermes Agent](https://hermes-agent.nousresearch.com/) 是由 Nous Research 开发的开源自主 AI 智能体，具备跨会话持久记忆和自我学习能力。本文介绍如何在 Hermes Agent 使用方舟 Coding Plan 企业版。
# 核心配置
需要获取 Coding Plan 企业版支持的模型、Base URL和专属的 API Key，才能正常使用并抵扣套餐额度。
## **模型配置**
支持以下两种方式配置模型：
**选项：配置 Model Name (配置文件指定)**
在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：
> **注意**
>
> 配置 Model Name 时，支持使用全小写格式，同时也支持直接复制 [Coding Plan 企业版页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=enterprise) 中的模型名称。
* `doubao-seed-evolving`
* `doubao-seed-2.1-pro`
* `doubao-seed-2.1-lite`
* `doubao-seed-2.0-mini`
* `glm-5.3` (`glm-latest`)
* `glm-5.3-flash`
* `deepseek-v4.1-flash`
* `deepseek-v4.1-flash-economy`
* `deepseek-v4-flash`
* `deepseek-v4-pro`
* `kimi-k2.8-preview`
* `kimi-k3.1-pro`
> **说明**
>
> Model Name 不支持配置为 `Auto`，如需使用，请通过控制台切换该模式。
**选项：配置 ark-code-latest (控制台管理)**
1. 在配置文件中指定模型为`ark-code-latest`。
2. 通过 [Coding Plan 企业版页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=enterprise) 选择或切换目标模型，切换模型后 3-5 分钟即可生效。
支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。
## **专属 Base URL**
不同的工具配置的 Base URL 根据兼容的协议会有不同：
* 兼容 Anthropic 接口协议工具：`https://ark.cn-beijing.volces.com/api/coding`
* 兼容 OpenAI 接口协议工具：`https://ark.cn-beijing.volces.com/api/coding/v3`
> **注意**
>
> 请勿使用 `https://ark.cn-beijing.volces.com/api/v3` ，接入会产生额外费用。
## **专属 API Key**
[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise/mine)
> **注意**
>
> Coding Plan 企业版专属 API Key 与火山方舟平台的 API Key 不同，请勿混用。
# 一、前提条件
支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。
# 二、安装Hermes Agent
前提条件：支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。
> **说明**
>
> Windows 系统请在 PowerShell 中运行安装命令（见下文步骤）；macOS 和 Linux 系统使用 cURL 命令。
根据操作系统执行以下命令安装 Hermes Agent，安装过程中会检测并安装 uv、Python、Node.js、ripgrep、ffmpeg 等依赖，安装完成后重新加载 Shell 或终端。更多安装说明参见 [Hermes Agent 官方文档](https://hermes-agent.nousresearch.com/docs/getting-started/installation)。
**选项：macOS / Linux**
1. 执行以下 cURL 命令安装：
```Bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
2. 安装完成后重新加载 Shell。
```Bash
source ~/.bashrc # or: source ~/.zshrc
```
**选项：Windows**
1. 在 PowerShell 中执行以下命令安装：
```PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
2. 安装完成后重新打开 PowerShell 窗口，或执行 `. $PROFILE` 刷新环境变量。
# 三、配置Hermes Agent
Coding Plan 兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
**选项：Responses API**
> **注意**
>
> 使用 Responses API，需要配置 `api_mode: codex_responses`。
执行以下命令配置 Hermes Agent，其中需要将 `` 替换为您自己的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise/mine)，可用的模型参见 [模型配置](/docs/coding-plan-enterprise-ai-hermes-agent#2e9b1559)。
```Bash
hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/coding/v3
hermes config set model.api_key
hermes config set model.default ark-code-latest
hermes config set model.api_mode codex_responses
```
配置完成后，配置文件 `~/.hermes/config.yaml` 内容如下。您也可以直接编辑该配置文件。
```YAML
model:
default: ark-code-latest
provider: custom
base_url: https://ark.cn-beijing.volces.com/api/coding/v3
api_key:
api_mode: codex_responses
```
**选项：Chat API**
> **注意**
>
> 使用 Chat API，需要配置 `api_mode: chat_completions`。
执行以下命令配置 Hermes Agent，其中需要将 `` 替换为您自己的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/coding-plan-enterprise/mine)，可用的模型参见 [模型配置](/docs/coding-plan-enterprise-ai-hermes-agent#2e9b1559)。
```Bash
hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/coding/v3
hermes config set model.api_key
hermes config set model.default ark-code-latest
hermes config set model.api_mode chat_completions
```
配置完成后，配置文件 `~/.hermes/config.yaml` 内容如下。您也可以直接编辑该配置文件。
```YAML
model:
default: ark-code-latest
provider: custom
base_url: https://ark.cn-beijing.volces.com/api/coding/v3
api_key:
api_mode: chat_completions
```
> **说明**
>
> * 如需使用 1MB 上下文，直接选择支持 1M 上下文的模型，Hermes Agent 会自动完成调整，无需手动配置。
> * 若模型本身支持 1M 上下文，但 Hermes Agent 未正确识别，可在 `~/.hermes/config.yaml` 中手动添加或修改相应模型的 `context_length` 字段：`context_length: 1048576`。
# 四、启动并使用 Hermes Agent
1. 执行以下命令开启 Hermes Agent。
```Bash
hermes
```
2. 开始使用 Hermes Agent，支持的 CLI Interface 参见 [官方文档](https://hermes-agent.nousresearch.com/docs/user-guide/cli)。
# 接入飞书机器人
> **注意**
>
> 本文档基于 Hermes Agent v0.8.0（2026.4.8）编写，工具迭代演进过程配置步骤可能会有差异，可参考以下内容配置关键信息。
1. 单击 [链接](https://open.larkoffice.com/page/openclaw?form=multiAgent) 快速创建飞书机器人。
2. 在终端执行以下命令配置信息平台。
```Bash
hermes gateway setup
```
* **Select a platform to configure**：选择 `Feishu / Lark`
* **How would you like to set up Feishu / Lark**：选择 `Enter existing App ID and App Secret manually`
* 配置创建的机器人对应的 **App ID**、**App Secret**
* **Domain**：选择`feishu`
* **Connection mode**：选择`WebSocket`
* **How should direct messages be authorized**：选择 `Use DM pairing approval`
* **How should group chats be handled**：选择`Respond only when @mentioned in groups`
* **Home chat ID**：暂不配置
* 选择 **done** 后， **Install the gateway as a launchd service**：选择 `Y`
* **Start the service now**：选择 `Y`
3. 在飞书打开刚创建的飞书机器人，发送任意消息获取配对码。
4. 在终端执行以下命令对飞书进行配置，其中``需替换为获取的配对码。
```Bash
hermes pairing approve feishu
```
5. 在飞书中发送`/sethome`命令将飞书会话设置为主会话，然后即可正常在飞书中使用 Hermes Agent。
