Hermes部署指南

如果是腾讯云hermes应用模版直接安装的可以参照下面腾讯云openclaw接入北洋API教程

配置

Hermes是什么

Hermes Agent 是由 Nous Research 开发的一款开源 AI 终端助手。你可以把它理解为一个运行在命令行里的"超级 AI 助手"，它能够：

在终端中与你对话，回答各种问题

执行终端命令（帮你操作电脑）

读写文件、搜索文件内容

浏览网页、搜索互联网信息

分析图片内容

编写和调试代码

设置定时任务（自动化）

连接 Telegram、Discord、微信等消息平台

拥有持久记忆，跨会话记住你的偏好

支持语音输入和语音回复

简单来说：它是一个能帮你干活的 AI，而且比普通聊天机器人强大得多。

Windows部署指南

💡

前置要求：安装 WSL2（Windows 子系统 Linux），开启系统更新

1.首次安装wsl2

Hermes Agent 不支持原生 Windows，必须通过 WSL2 运行。WSL2 就是在 Windows 里装一个 Linux 系统，不影响你正常使用 Windows。
以管理员身份打开 PowerShell（右键开始菜单 → "终端(管理员)"）

如果wsl安装卡到了0%，试试换一种方式

2.等待安装完成，系统会提示你重启电脑

3.重启后，WSL 会自动打开，要求你设置 Linux 用户名和密码

4.设置完成后，你就有了一个 Ubuntu 终端。按下win键输入wsl会出现一个小企鹅的标志

5.验证安装成功：powershell管理员运行

如果显示版本号，说明安装成功。

6.安装Git

在wsl2终端（Ubuntu）中运行

看到版本号输出即可。

提示：后续所有命令都在 WSL2 终端中执行，不是在 Windows 的 CMD 或 PowerShell 中。

推荐一键安装：Linux，masOS，Windows安装好wsl2后

安装脚本会自动处理所有依赖，包括：

Python 3.11（通过 uv 包管理器，无需 sudo）

Node.js v22（用于浏览器自动化）

ripgrep（快速文件搜索）

ffmpeg（音频格式转换）

安装完成后，重新加载终端配置：

后续Hermes更新只需要在所依赖的环境运行：

手动安装（动手能力强大的人）

如果一直安装失败，可以尝试手动安装：
第1步：安装 uv（Python 包管理器）

第2步：克隆仓库

第3步：创建虚拟环境：

第4步：安装依赖：

第5步：安装 Node.js 依赖（可选，用于浏览器工具）

第6步：创建配置目录

第7步：添加到系统路径

最后：验证安装

如何配置？

安装完成之后，让你输入管理员密码。注意：密码输入以及API Key输入进去之后是看不到的

1.在你所依赖的环境中运行

2.选择快速配置

3.选择More Povider

4.选择合适的协议后，填入你的URL。比如：

填入URL:http://api.tsbys.com/v1，或者http://api.tsbys.com/

5.复制张贴你的APIkey，粘贴进去之后你是看不见的，你直接回车即可，如果一直验证不出来，可能是你的key没有填进去，或者试一下换URL，再不行把你的那个东西给关掉或者重新启动你所依赖的环境。

成功之后你将看到这些模型的名称，最后输入你对应模型的上下文大小之后配置你的聊天渠道，这里就不做演示了，我们这边选择跳过

6.聊天

在此输入Y，即可开始与Hermes聊天

如果能够正常回复你，那么就配置成功了
后续配置其他的东西，直接与你的Hermes说要求即可

7.为什么你配置好其他聊天渠道之后没有反应？试试运行：

常见问题

Q1：hermes: command not found（找不到命令）
原因： 安装后没有重新加载终端配置。
解决：

或者

如果还不行，检查 PATH：

如果没有输出，手动添加

Q2：上下文长度只有 16k / 2048，AI 回复经常断
原因： 上下文窗口配置过小。
解决： 在配置文件中手动设置上下文长度：

Q3：如何设置备用模型（自动故障转移）？

配置文件目录结构

** Q4：WSL2 中无法访问 Windows 上运行的本地模型**
原因： WSL2 和 Windows 使用不同的网络。
解决方案一（推荐，Windows 11）：
在 Windows 中创建文件 C:\Users\你的用户名.wslconfig：

然后在 PowerShell 中重启 WSL：

*解决方案二（Windows 10）：
在 WSL2 中获取 Windows 主机 IP：

用这个 IP 替代 localhost。
Q5：更新后配置丢失

如果是腾讯云hermes应用模版直接安装的可以参照下面腾讯云openclaw接入北洋API教程#

Hermes是什么#

Windows部署指南#

1.首次安装wsl2#

2.等待安装完成，系统会提示你重启电脑#

3.重启后，WSL 会自动打开，要求你设置 Linux 用户名和密码#

4.设置完成后，你就有了一个 Ubuntu 终端。按下win键输入wsl会出现一个小企鹅的标志#

5.验证安装成功：powershell管理员运行#

6.安装Git#

推荐一键安装：Linux，masOS，Windows安装好wsl2后#

手动安装（动手能力强大的人）#

如何配置？#

1.在你所依赖的环境中运行#

2.选择快速配置#

3.选择More Povider#

4.选择合适的协议后，填入你的URL。比如：#

5.复制张贴你的APIkey，粘贴进去之后你是看不见的，你直接回车即可，如果一直验证不出来，可能是你的key没有填进去，或者试一下换URL，再不行把你的那个东西给关掉或者重新启动你所依赖的环境。#

6.聊天#

7.为什么你配置好其他聊天渠道之后没有反应？试试运行：#

常见问题#

如果是腾讯云hermes应用模版直接安装的可以参照下面腾讯云openclaw接入北洋API教程

Hermes是什么

Windows部署指南

1.首次安装wsl2

2.等待安装完成，系统会提示你重启电脑

3.重启后，WSL 会自动打开，要求你设置 Linux 用户名和密码

4.设置完成后，你就有了一个 Ubuntu 终端。按下win键输入wsl会出现一个小企鹅的标志

5.验证安装成功：powershell管理员运行

6.安装Git

推荐一键安装：Linux，masOS，Windows安装好wsl2后

手动安装（动手能力强大的人）

如何配置？

1.在你所依赖的环境中运行

2.选择快速配置

3.选择More Povider

4.选择合适的协议后，填入你的URL。比如：

5.复制张贴你的APIkey，粘贴进去之后你是看不见的，你直接回车即可，如果一直验证不出来，可能是你的key没有填进去，或者试一下换URL，再不行把你的那个东西给关掉或者重新启动你所依赖的环境。

6.聊天

7.为什么你配置好其他聊天渠道之后没有反应？试试运行：

常见问题