文档中心

火山方舟

接入 AI 工具

Hermes Agent

本文介绍如何在 Hermes Agent 中配置并使用方舟 Agent Plan。

前提条件

您已按需订阅 Agent Plan 套餐。如未订阅，请访问开通管理-Agent Plan 页面订阅套餐。

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

安装 Hermes Agent

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

macOS / Linux

Windows

执行以下 cURL 命令安装：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后重新加载 Shell。

source ~/.bashrc # or: source ~/.zshrc

配置 Hermes Agent

需配置的信息

如您对 Hermes Agent 熟悉，或本地已有配置，可获取以下信息直接配置。

Base URL：https://ark.cn-beijing.volces.com/api/plan/v3。

API Key：获取专属 API Key。

Model：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

方式 1：一键配置（推荐）

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

安装 Ark CLI

环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

根据界面提示选择登录方式，推荐选择火山 SSO (浏览器登录)，在浏览器中完成授权即可。

一键配置 Hermes Agent

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：agent-plan_cn-beijing_personal。

选择默认 model：按需选择。

选择 AI Agent：Hermes Agent。

支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

配置完成后，Hermes Agent 会自动识别配置的模型。启动 Hermes Agent 即可使用。

方式 2：手动配置

Agent Plan 兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。

Responses API

Chat API

使用 Responses API，需要配置 api_mode: codex_responses。

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

配置完成后，配置文件 ~/.hermes/config.yaml 内容如下。您也可以直接编辑该配置文件。

说明

如需使用 1M 上下文，直接选择支持 1M 上下文的模型，Hermes Agent 会自动完成调整，无需手动配置。

若模型本身支持 1M 上下文，但 Hermes Agent 未正确识别，可在 ~/.hermes/config.yaml 中手动添加或修改相应模型的 context_length 字段：context_length: 1048576。

使用 Hermes Agent

执行以下命令开启 Hermes Agent。

hermes

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

其他操作

添加图片生成/视频生成能力

方舟 Agent Plan Medium 及以上套餐提供图片生成模型配额，Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见配置视觉模型。

注意

不同的套餐支持的视觉模型有所不同，具体参见支持模型及 Harness。

视觉模型不支持通过 Auto 及控制台切换使用。

切换模型

你可以随时根据需求切换文本生成模型。

配置方式	通过控制台	修改配置文件
切换模型操作	参考配置 Hermes Agent，将 model.default 配置为 ark-code-latest。在开通管理页面选择要使用的模型，切换后 3-5 分钟即可生效。	参考配置 Hermes Agent，将 model.default 配置为需要使用的 Model Name。重新启动 Hermes Agent 后生效。

接入飞书机器人

注意

本文档基于 Hermes Agent v0.8.0（2026.4.8）编写，工具迭代演进过程配置步骤可能会有差异，可参考以下内容配置关键信息。

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

在终端执行以下命令配置信息平台。

hermes gateway setup

Select a platform to configure：选择 Feishu / Lark

How would you like to set up Feishu / Lark：选择 Scan QR code to create a new bot automatically (recommended)，通过飞书客户端扫描二维码后，创建飞书机器人。

* **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`

在飞书打开刚创建的飞书机器人，发送任意消息获取配对码。

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

hermes pairing approve feishu <pairing-code>

在飞书中发送/sethome命令将飞书会话设置为主会话，然后即可正常在飞书中使用 Hermes Agent。

最近更新时间：2026.11.04 17:47:42

这个页面对您有帮助吗？

有用

无用