macOS / Linux Hermes Agent 安装指南

在 macOS 或 Linux 上安装 Hermes Agent，并配置为使用积木AI代码助手接口。

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

系统要求

系统

macOS 或主流 Linux 发行版

安装方式

官方提供 bash 安装脚本，适合终端环境。

可选功能

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

安装步骤

打开终端

macOS 可用 Cmd+Space 搜索 Terminal；Linux 直接打开你常用的终端即可。

安装 Hermes Agent

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

验证安装

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`	适合轻量请求、通用问答和多模型补位。