Flaq AI 智能体指南

实用指南 | 在 Hermes Agent 中使用 Flaq AI 的 API 服务

使用 Flaq AI 的 Hermes Agent 兼容接口，可以快速完成 Hermes Agent 的接入配置，并在终端使用我们提供的模型服务。配置 API key 后，您可以参考指南提供的示例，选择目前支持的模型，并完成调试验证。

智能体指南

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

安装

安装 Hermes Agent

为你的系统安装 Hermes Agent。如有需要，重新加载 shell 配置，然后先确认 hermes 命令可用，再继续添加 Flaq AI 设置。如果安装程序打开了安装向导，可以跳过 Nous Portal 登录，之后手动配置 Flaq。

1

安装 Hermes Agent

选择适合当前系统的安装方式，然后运行下面的安装命令。

安装程序可能会打开 Hermes 安装向导。对于 Flaq 配置，你可以跳过 Nous Portal 登录，然后继续使用下面的手动配置方式。

官方安装脚本

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
2

重新加载 shell 配置

如果安装后 hermes 命令还不可用，请运行这一步。如果你的 shell 使用 bash，可以改用 source ~/.bashrc。

重新加载 shell 配置

source ~/.zshrc
3

验证 Hermes Agent

在添加 Flaq AI 凭证之前，先确认 hermes 命令已经可以使用。

验证安装

hermes --version

配置

在 Hermes Agent 中配置 Flaq AI

先选择 Flaq OpenAI 兼容接口当前支持的模型，再将 Flaq API key 保存到 ~/.hermes/.env，并让 config.yaml 指向 Flaq API。

推荐作为 Hermes Agent 编码工作流默认选择的稳定文本模型。

使用 Hermes CLI 命令写入 Flaq API key 和模型设置，减少手动编辑文件的步骤。此方式会更新本地 Hermes 设置；如果你已经在使用 Hermes，请先备份现有配置。

通过 Hermes config 命令写入 Flaq key、选中的模型、custom provider、base URL 和 context length。

Hermes CLI 快速设置

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

验证

在 Hermes Agent 中验证 Flaq

运行一条 Hermes 单次测试命令。如果能够正常返回结果，说明 Hermes 已经可以通过 Flaq LLM 接口调用模型。

启动交互模式

hermes

快速测试命令

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

配置诊断

hermes config check

将选中模型设为默认模型

hermes config set model.default gpt-5.4-text-to-text

故障排查

Hermes Agent 常见问题

在本指南场景中使用时，可能会显著增加 token 用量。