Hermes 小白基础配置

Hermes 是一个面向开发者的命令行 AI 工具。配置好 API Key、模型和相关权限后，你可以在终端里用它询问项目问题、生成代码、解释报错，或者辅助完成日常开发任务。

本教程面向第一次使用 Hermes 的新手，目标是让你完成三件事：

• 安装 Hermes
• 写入 API Key 和模型配置
• 在本地项目里完成第一次测试

关于密钥

API Key 只能自己使用，不要截图发给别人，也不要写进公开仓库。配置文件如果要提交到 GitHub，必须先确认里面没有真实密钥。

---

一、使用前准备

1. 检查基础环境

Hermes 通常需要 Node.js、npm 和 Git。第一次配置前，建议先完成：

使用前环境配置

然后在终端执行：

node -v
npm -v
git --version

能正常显示版本号后，再继续安装 Hermes。

2. 创建 API Key

进入 coding-play.codes 控制台，打开 API 密钥 页面，创建一个专门给 Hermes 使用的密钥。

建议命名为：

hermes

单独创建密钥的好处是：后续如果不用 Hermes 了，可以只删除这一个密钥，不影响其他工具。

3. 确认配置项

配置 Hermes 前，需要准备：

配置项	说明
API Key	在 coding-play.codes 创建的密钥，或按当前渠道要求准备对应密钥
Model	你要使用的模型名称
Permissions	是否允许 Hermes 读取、编辑文件和执行命令

如果你不确定模型名称，优先去后台的模型列表查看，不要自己猜。

---

二、安装 Hermes

打开终端，执行：

curl -sSfL https://runrl.com/install | bash

安装完成后，检查命令是否可用：

hermes --version

如果能看到版本号，说明安装成功。

如果安装后命令找不到

重新打开一个终端窗口再执行 hermes --version。如果仍然找不到，检查安装脚本输出里提示的 PATH 配置。

---

三、写入基础配置

Hermes 推荐先使用初始化向导：

hermes setup

向导会引导你完成基础设置。配置模型时，可以执行：

hermes model

如果你使用的是 coding-play.codes 这类 OpenAI 兼容接口，推荐在 hermes model 里选择 Custom endpoint，然后依次填写：

提示项	应该填写什么
API base URL	后台提供的接口地址
API key	coding-play.codes 创建的 API Key
Model name	后台模型列表里的真实模型名称

如果你需要手动写入配置，也可以使用配置命令：

hermes config set model.provider custom
hermes config set model.base_url "你的 Base URL"
hermes config set model.default "你的模型名称"
hermes config set OPENAI_API_KEY "你的 API Key"

需要替换：

• 你的 API Key：换成 coding-play.codes 创建的密钥
• 你的 Base URL：换成后台提供的接口地址
• 你的模型名称：换成后台模型列表里的真实模型名

Hermes 会把 API Key 这类密钥保存到 ~/.hermes/.env，把模型、接口地址等普通配置保存到 ~/.hermes/config.yaml。

命令只是示例

如果你当前 Hermes 版本的配置命令不一样，以 hermes --help、hermes config --help 或当前渠道文档为准。核心是让 Hermes 能读取到 API Key，并选择一个可用模型。

---

四、查看当前配置

配置完成后，可以查看 Hermes 当前读取到的配置：

hermes config

检查重点：

• API Key 是否存在
• 模型是否已经选择
• 权限设置是否符合你的使用习惯

如果 API Key 会被隐藏成 ****，这是正常现象。

如果想单独检查或修改权限，可以执行：

hermes config set permissions 1

新手建议先使用相对保守的权限，等熟悉后再放开更多自动执行能力。

---

五、第一次运行

进入一个本地项目：

cd ~/Desktop/my-project

启动 Hermes：

hermes

第一次建议先发送一个只读任务：

请先分析这个项目，不要修改任何文件。告诉我它使用了什么技术栈，以及应该怎么启动。

如果 Hermes 能正常回答，说明基础配置已经生效。

---

六、新手常用问法

让它先看项目

请阅读当前项目，整理主要目录结构、启动命令和构建命令。

让它解释报错

我运行 npm run build 报错了，请解释报错原因，并告诉我应该改哪里。

让它写代码前先给方案

请先给出修改方案和会改动的文件列表，不要直接修改代码。

让它完成小改动

帮我新增一个 OpenClaw 配置文档页面，并把它加到侧边栏。

---

七、常见问题

1. hermes 命令找不到

优先检查：

• 是否已经安装成功
• 是否需要重新打开终端
• npm 全局安装目录是否在 PATH 环境变量里

可以尝试：

npm list -g --depth=0

看 Hermes 是否已经在全局包列表里。

2. 请求提示未授权

优先检查：

• API Key 是否填错
• 密钥是否已被删除
• 配置项名称是否写错
• 当前选择的模型是否需要另一种密钥

3. 模型调用失败

优先检查：

• 模型名称是否填写完整
• 当前账号是否有该模型权限
• 账户余额是否充足
• 当前 Hermes 版本是否支持你填写的模型协议

4. 不确定配置命令

执行：

hermes --help
hermes config --help

先看当前版本支持哪些命令，再按提示配置。