Windows Hermes Agent 使用说明

在 Windows 上推荐通过 WSL2 安装 Hermes Agent，并配置为使用积木AI代码助手接口。

返回热门工具登录后创建对应产品线 Key

开始前先做这一步：先到 Key 管理创建你要使用的对应产品线 Key。Hermes 只推荐填写你自己创建的真实 Key，不要填示例值或别人的 Key。

快速入口

Hermes 没有和 OpenClaw / OpenCode 一样的一键写配置脚本。最关键的步骤是先创建真实 Key，再在 Hermes 里选择 Custom endpoint 并手动填入接口信息。

创建 Key 两种模式填写示例飞书接入

先看这一条

Hermes 在 Windows 上的推荐方式是先安装 WSL2，再在 Ubuntu / Debian 终端里完成安装和配置。只要你愿意先把 WSL2 装好，后续流程是可以正常走通的。

是否适合你

适合

已经在用 WSL2、愿意手动选模型、想接飞书 / Lark 机器人，或长期把它当个人助理来用。

不适合

只想在 Windows 原生环境里直接双击脚本完成配置，或者暂时不想安装 WSL2 / 使用终端交互。

系统要求

系统

Windows 10/11，推荐已安装 WSL2（Ubuntu / Debian）

先做什么

如果你现在还是纯 Windows 原生环境，先把 WSL2 安装好，再继续下面步骤。

安装方式

Hermes 官方安装脚本基于 bash；Windows 推荐在 WSL2 终端执行，不建议直接走原生 PowerShell。

可选功能

如需接入飞书 / Lark，还需要准备 App ID、App Secret，以及允许访问的用户或群聊配置。

先理解两种模式

Quick setup

这是 Hermes 自带的官方账号直连方式。只有你本身就有对应官方订阅或官方账号时才适合选。

Custom endpoint（本站推荐）

没有官方订阅时，就选这个。然后把 Base URL、API Key、Model 手动填成本站提供的值。

安装步骤（Windows 推荐 WSL2）

打开 WSL2 终端

推荐在 Windows Terminal 中打开 Ubuntu / Debian。若你还没装 WSL2，可先完成系统安装后再继续本页。

安装 Hermes Agent

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

安装完成后，建议重新打开一个终端，确保 hermes 命令已经生效。

验证安装

hermes --help

登录后创建并复制对应产品线 Key

Hermes 是单模型接入方式。你准备用哪个模型，就创建对应产品线的 Key：

gpt-5.4 / gpt-5.4-mini / gpt-5.3-codex-spark / gpt-5.3-codex：使用 Codex Key
claude-sonnet-4-6 / claude-opus-4-6 / claude-opus-4-7 / claude-opus-4-8：使用 Claude Code Key
gemini-2.5-flash / gemini-2.5-pro：使用 Gemini Key

配置模型与接口

hermes model

进入后按下面方式选择：

选择 Custom endpoint
Base URL：https://code.jimuxyz.com/p/v1
API Key：填写你刚创建的真实 Key
Model：填写下方任一模型 ID

可选：接入飞书 / Lark

Hermes 官方已经支持飞书 / Lark。对国内用户来说，这通常比 Telegram 更顺手，也更适合团队内部协作。

先在飞书开放平台创建应用

到飞书开放平台创建企业自建应用，开通机器人能力，并记录 App ID 与 App Secret。

入口可直接打开：open.feishu.cn。如果你使用国际版 Lark，可改走对应的 Lark 开放平台。

在 Hermes 中进入网关配置

hermes gateway setup

在交互式配置里选择 Feishu / Lark，再按提示填写应用信息。

启动网关

hermes gateway

启动后，去飞书里私聊机器人或把机器人拉进群即可开始测试。群聊中建议通过 @ 提及机器人来触发。

默认行为与推荐设置

连接模式

推荐 FEISHU_CONNECTION_MODE=websocket。这样通常不需要公网回调地址；只有你明确需要 HTTP 回调时再考虑 webhook。

私聊

私聊里，Hermes 默认会响应消息，适合做个人助理。

群聊

群聊里，默认只有在 @ 提及机器人时才处理消息。这样更安全，也更适合团队场景。

共享群会话

默认通常按“同一个群里每个用户各自独立会话”处理，避免多人在同一群里把上下文串在一起。

推荐限制

建议配置 FEISHU_ALLOWED_USERS 或群聊策略，先只开放给你自己或小范围测试群，跑通后再逐步放开。

排查命令

# 重新进入飞书网关配置
hermes gateway setup

# 启动网关
hermes gateway

# 查看帮助
hermes gateway --help

如果飞书里消息发不进去，优先检查：App ID / Secret、连接模式、允许用户范围、是否 @ 了机器人，以及网关是否正在运行。

常用命令

# 查看 / 切换模型
hermes model

# 重新配置
hermes setup

# 查看帮助
hermes --help

Hermes 与 OpenClaw 的区别

Hermes

更偏个人助理、长期使用体验与飞书 / Lark 等消息通道交互。

OpenClaw

更偏控制式、多工具编排和终端工作流。

产品线	推荐模型 ID	说明
Codex	`gpt-5.4` `gpt-5.4-mini` `gpt-5.3-codex-spark` `gpt-5.3-codex`	适合代码理解、补全和长任务。
Claude Code	`claude-sonnet-4-6` `claude-opus-4-6` `claude-opus-4-7` `claude-opus-4-8`	适合高质量生成、复杂分析和长上下文任务。
Gemini	`gemini-2.5-flash` `gemini-2.5-pro`	适合轻量请求、通用问答和多模型补位。