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

Hermes Agent

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

核心配置#

接入工具的核心参数如下：

模型配置#

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

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

  • doubao-seed-evolving
  • doubao-seed-2.1-pro
  • doubao-seed-2.1-lite
  • doubao-seed-2.0-mini
  • minimax-m3
  • glm-5.3 (glm-latest)
  • glm-5.3-flash
  • deepseek-v4.1-flash
  • deepseek-v4-flash
  • deepseek-v4-pro
  • kimi-k2.8-preview
  • kimi-k3
  1. 在配置文件中指定模型为ark-code-latest。
  2. 通过 开通管理页面 选择或切换目标模型，切换模型后 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

一、前提条件#

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

二、安装 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#

方式 1：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

  1. 安装 Ark CLI。

    Bash
    # 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

  2. 登录 Ark CLI。

    Bash
    arkcli auth login

    image-20260624-144256-509.png

    根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

    1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。

    2. 选择消费模式（Type）：选择 coding-plan。

      image-20260624-163746-727.png

  3. 运行 ArkCLI Helper，根据界面提示完成 Hermes Agent 的配置。

    1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
    2. 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。
      image-20260624-163451-813.png
    3. 选择默认 model：按需选择。
    4. 选择要配置的 AI Agent：Hermes Agent。
      image-20260624-164208-100.png

完成上述操作后，将自动完成 Hermes Agent 的基础配置，无需手动安装。

方式 2：手动配置#

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. 参考三、配置 Hermes Agent配置模型名称为ark-code-latest。
2. 在 开通管理页面 选择要使用的模型，切换后3-5分钟即可生效。		 参考三、配置 Hermes Agent配置模型名称为您需要的模型。

接入飞书机器人#

  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。