Windows Hermes Agent 安装指南

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

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

系统要求

系统

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

安装方式

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

可选功能

如需 Telegram Bot，还需要单独准备 Bot Token 和你的 Telegram 数字 ID。

安装步骤（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.3-codex：使用 Codex Key
claude-sonnet-4-6 / claude-opus-4-6 / claude-opus-4-7：使用 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

可选：接入 Telegram Bot

申请 Bot Token

打开 Telegram，搜索 @BotFather，输入 /newbot，按提示完成创建并记录返回的 Bot Token。

获取你的 Telegram 数字 ID

可搜索 @userinfobot 查看自己的 Telegram 数字 ID。

在 Hermes 中配置消息通道

安装或重新执行 hermes setup 时，选择 Telegram，填入 Bot Token 和你的数字 ID 即可。如果暂时不需要 Telegram，可先跳过。

常用命令

# 查看 / 切换模型
hermes model

# 重新配置
hermes setup

# 查看帮助
hermes --help

Hermes 与 OpenClaw 的区别

Hermes

更偏个人助理、长期使用体验与 Telegram 交互。

OpenClaw

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

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