面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/coding-plan-enterprise-ai-hermes-agent.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

Hermes Agent

Hermes Agent 是由 Nous Research 开发的开源自主 AI 智能体，具备跨会话持久记忆和自我学习能力。本文介绍如何在 Hermes Agent 使用方舟 Coding Plan 企业版。

核心配置#

需要获取 Coding Plan 企业版支持的模型、Base URL和专属的 API Key，才能正常使用并抵扣套餐额度。

模型配置#

支持以下两种方式配置模型：

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

  • 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
  1. 在配置文件中指定模型为ark-code-latest。
  2. 通过 Coding Plan 企业版页面 选择或切换目标模型，切换模型后 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

专属 API Key#

获取专属 API Key

coding-plan-enterprise-api-key.png

一、前提条件#

支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。

二、安装Hermes Agent#


前提条件：支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。

根据操作系统执行以下命令安装 Hermes Agent，安装过程中会检测并安装 uv、Python、Node.js、ripgrep、ffmpeg 等依赖，安装完成后重新加载 Shell 或终端。更多安装说明参见 Hermes Agent 官方文档。

  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

  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 的配置，推理效果更好。

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您自己的 专属 API Key，可用的模型参见 模型配置。

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 <ARK_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: <ARK_API_KEY>
  api_mode: codex_responses

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您自己的 专属 API Key，可用的模型参见 模型配置。

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 <ARK_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: <ARK_API_KEY>
  api_mode: chat_completions

四、启动并使用 Hermes Agent#

  1. 执行以下命令开启 Hermes Agent。

    Bash
    hermes

  2. 开始使用 Hermes Agent，支持的 CLI Interface 参见 官方文档。

接入飞书机器人#

  1. 单击 链接 快速创建飞书机器人。

  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. 在飞书打开刚创建的飞书机器人，发送任意消息获取配对码。

  1. 在终端执行以下命令对飞书进行配置，其中<pairing-code>需替换为获取的配对码。

    Bash
    hermes pairing approve feishu <pairing-code>
  1. 在飞书中发送/sethome命令将飞书会话设置为主会话，然后即可正常在飞书中使用 Hermes Agent。