Hermes

Hermes Agent 是 Nous Research 开发的可扩展 AI 智能体，能通过工具、技能和自动化工作流帮你完成编码、研究、文件操作、日程任务等实际工作，支持本地终端、微信等多种接入方式。

Hermes

MacOS / Linux

系统要求

macOS 10.15+ 或主流 Linux 发行版

1.安装Hermes

1.打开终端，粘贴下面命令，回车

bash

1curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

2.都输入 y 并回车即可

3.选择“快速设置（Quick Setup）”，选择“跳过信息平台设置”（Skip-set up later）

4.安装完成后，执行下面这条让 hermes 在当前终端立即可用

bash

1source $HOME/.local/bin/env

重新打开终端后就不用再执行 source 了，因为安装脚本已经把路径写进了你的 shell 配置。

2.配置

创建您的API key：/docs/create-api-key

1.点击复制下面命令，弹窗处填写您创建的API key，然后复制代码到终端回车执行

bash

1mkdir -p ~/.hermes && cat > ~/.hermes/config.yaml << 'EOF'

2model:

3 default: claude-opus-4-8

4 provider: uniroute-claude

5custom_providers:

6- name: uniroute-claude

7 base_url: https://api.uniroute.dev

8 api_key: 在这里替换成你的_API_KEY

9 api_mode: anthropic_messages

10- name: uniroute-openai

11 base_url: https://api.uniroute.dev/v1

12 api_key: 在这里替换成你的_API_KEY

13 api_mode: chat_completions

14- name: uniroute-gemini

15 base_url: https://api.uniroute.dev/gemini_cli/v1beta

16 api_key: 在这里替换成你的_API_KEY

17 api_mode: chat_completions

18EOF

3.验证

1.终端粘贴下面命令，回车

bash

1hermes

2./model 选择以uniroute开头的模型

3.测试对话，有正常回复即为安装成功啦

常用命令	/model（查看和切换模型）	↑ / ↓（浏览历史命令）	Esc（撤回 / 退出）	/help（列出所有可用命令）

Windows

系统要求

Windows 10/11 + WSL2 + Ubuntu 22.04

1.装WSL（已装的跳过）

安装完成后电脑会要求重启。重启后会自动弹出 Ubuntu 窗口，设置一个用户名和密码即可。 如果之前已经装过 WSL 且能正常打开 Ubuntu 终端，直接跳到【安装Hermes】

按 Win + R 输入 Powershell 打开 PowerShell （建议以管理员身份运行）并执行：

bash

1wsl --install

2wsl --list --online

3wsl --install -d Ubuntu-22.04

4wsl.exe --install

2.设置您的用户名和密码

遇到[Y/n/e]，都输入y，并回车

2.安装Hermes

1.打开 WSL 终端（搜索 Ubuntu 或在 PowerShell 输入 wsl），粘贴下面命令

bash

1curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

遇到[Y/n/e]，输入y，并回车遇到Password，输入您一开始创建的密码，并回车

2.选择“快速设置（Quick Setup）”，选择“跳过信息平台设置”（Skip-set up later）

3.安装完成后，执行下面这条让 hermes 在当前终端立即可用

bash

1source $HOME/.local/bin/env

重新打开 WSL 终端后就不用再执行 source 了，安装脚本已经自动配好了路径。 如遇到报错：-bash: /home/he1124/.local/bin/env: No such file or directory；执行：sed -i '/source \$HOME\/.local\/bin\/env/s/^/#/' ~/.bashrc && source ~/.bashrc

3.配置

创建您的API key：/docs/create-api-key

1.点击复制下面命令，弹窗处填写您创建的API key，然后复制代码到终端回车执行

bash

1mkdir -p ~/.hermes && cat > ~/.hermes/config.yaml << 'EOF'

2model:

3 default: claude-opus-4-8

4 provider: uniroute-claude

6custom_providers:

7- name: uniroute-claude

8 base_url: https://api.uniroute.dev

9 api_key: 在这里替换成你的_API_KEY

10 api_mode: anthropic_messages

12- name: uniroute-openai

13 base_url: https://api.uniroute.dev/v1

14 api_key: 在这里替换成你的_API_KEY

15 api_mode: chat_completions

17- name: uniroute-gemini

18 base_url: https://api.uniroute.dev/gemini_cli/v1beta

19 api_key: 在这里替换成你的_API_KEY

20 api_mode: chat_completions

22- name: uniroute-deepseek

23 base_url: https://api.uniroute.dev/v1

24 api_key: 在这里替换成你的_API_KEY

25 api_mode: chat_completions

27- name: uniroute-glm

28 base_url: https://api.uniroute.dev/v1

29 api_key: 在这里替换成你的_API_KEY

30 api_mode: chat_completions

32- name: uniroute-minimax

33 base_url: https://api.uniroute.dev/v1

34 api_key: 在这里替换成你的_API_KEY

35 api_mode: chat_completions

37- name: uniroute-kimi

38 base_url: https://api.uniroute.dev/v1

39 api_key: 在这里替换成你的_API_KEY

40 api_mode: chat_completions

42- name: uniroute-qwen

43 base_url: https://api.uniroute.dev/v1

44 api_key: 在这里替换成你的_API_KEY

45 api_mode: chat_completions

47- name: uniroute-step

48 base_url: https://api.uniroute.dev/v1

49 api_key: 在这里替换成你的_API_KEY

50 api_mode: chat_completions

52- name: uniroute-bytedance

53 base_url: https://api.uniroute.dev/v1

54 api_key: 在这里替换成你的_API_KEY

55 api_mode: chat_completions

57compression:

58 summary_model: claude-haiku-4-5-20251001

59EOF

4.验证

1.终端粘贴下面命令，回车

bash

1hermes

2./model 选择模型

3.测试对话，有正常回复即为安装成功啦

常用命令	/model（查看和切换模型）	↑ / ↓（浏览历史命令）	Esc（撤回 / 退出）	/help（列出所有可用命令）

配置微信Hermes

前置条件1.按照上述教程已经安装好Hermes-agent 2.移动端和PC端微信版本为最新

1.运行接入

1.打开终端（Linux/mac）或 WSL（windows)，运行

更新Hermes版本

1hermes update

配置网关接口

1hermes gateway setup

2.选择微信配置

2.配置相关内容

1.输入 y 并回车

2.打开给的链接（选择复制粘贴到浏览器上即可打开），然后用微信app扫码

3.选择【Allow all direct messages】；选择【Allow all group chats】

4.输入 y 并回车

5.选择【Done】

6.都输入 y 并回车（Start the gateway automatically on login/boot as a launchd service 为开机是否要自动启动，可选n，选择不自动启动）

3.测试

1.因为 execute_code（执行代码）属于高风险操作 —— 脚本可以创建子进程、修改文件等，所以 Hermes 的安全机制会暂停执行，要求你手动批准。

/approve 仅批准这一次执行 /approve session 本次会话内同类操作都自动批准 /approve always 永久批准此类操作（以后不再询问） /deny 拒绝执行，取消这次操作

根据您的需求执行即可

2.正常回复，就可以使用啦

配置桌面Hermes

Hermes桌面应用程序是一款原生应用程序，它基于与CLI和网关相同的代理构建——相同的配置、相同的API密钥、相同的会话、相同的技能、相同的内存。

前置条件需要终端已成功安装Hermes并正常回复，如未安装，点击链接去安装：/docs/Hermes-cli#hermes

1.终端配置

1.需要终端已成功安装Hermes并正常回复，如未安装，点击链接去安装：/docs/Hermes-cli#hermes

2.运行接入

1.新开窗口运行

bash

1hermes desktop

2.会跳转出这个页面

3.选择uniroute下的模型即可

3.测试

1.测试正常回复即可使用