从零到一：Windows WSL 免费搭建 Hermes AI 智能助手（微信+飞书全通）

一台 Windows 电脑 + 能上网，就能搭一套自己的 AI 助手，还能连上微信和飞书。

文章目录

• • 前言
  • 准备工作
  • Step 1：安装 WSL——给 Windows 装个 Linux
  • • 1.1 开启 WSL 功能
    • 1.2 更新 Linux 内核
    • 1.3 设置 WSL 2 为默认版本
    • 1.4 安装 Ubuntu
    • 1.5 设置 Linux 账户
    • 1.6 检查
    • 1.7 常用操作
  • Step 2：装 Hermes
  • • 2.1 更新软件包
    • 2.2 装依赖
    • 2.3 一键安装
    • 2.4 验证
  • Step 3：免费申请 API Key——给 AI 安个大脑
  • • 3.1 方案一：NVIDIA NIM API（国内直连，无需代理）
    • 3.2 方案二：DeepSeek API（备选）
  • Step 4：配置 Hermes 模型
  • • 4.1 验证
  • Step 5：连接微信
  • • 5.1 启动网关
    • 5.2 扫码
    • 5.3 让网关一直在后台跑
  • Step 6：连接飞书
  • • 6.1 配置飞书
    • 6.2 验证
    • 6.3 重启网关
  • 踩坑记录
  • 总结
  • • 进阶方向
  • 参考链接

⚠️ 推荐正道：Hermes 有官方中文社区，文档齐全、持续更新——hermesagent.org.cn。本文是个人搭建过程的记录，遇到本文未覆盖的问题，去中文社区查文档最靠谱。

前言

Hermes 是 Nous Research 开源的 AI Agent 框架，支持 20+ LLM 提供商（OpenRouter、Anthropic、DeepSeek 等），能接微信、飞书、Telegram。有持久记忆、技能系统、多平台网关——别人在群里 @ 它或者私聊它，它就能干活。

不需要月付，不需要云服务器。一台 Windows 电脑，跟着本文走完就行。

你不需要会写代码。每步该点什么按钮、该打什么字，我都会写清楚。

下面是整篇文章要搭建的系统架构——微信和飞书通过 Hermes 网关连到大模型，全部跑在本地 WSL 里：

准备工作

先看电脑够不够用：

• 系统：Windows 10（版本 2004 及以上）或 Windows 11
• 内存：8GB 以上（推荐 16GB）
• 硬盘：20GB 以上剩余空间
• 网络：能正常上网

这些要求大多数电脑都满足。

Step 1：安装 WSL——给 Windows 装个 Linux

Hermes 跑在 Linux 上。Windows 自带 WSL（Windows Subsystem for Linux），装了之后可以在 Windows 里直接跑 Linux。

1.1 开启 WSL 功能

管理员身份打开 PowerShell（左下角「开始」→ 搜「PowerShell」→ 右键「以管理员身份运行」）。

依次输入：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完关闭窗口，重启计算机。

1.2 更新 Linux 内核

下载 适用于 x64 计算机的 WSL2 Linux 内核更新包，双击安装。

1.3 设置 WSL 2 为默认版本

管理员身份重新打开 PowerShell：

wsl —set-default–version 2

1.4 安装 Ubuntu

方法一：一条命令（Windows 11，网络好推荐）

wsl —install

自动装好 WSL 和 Ubuntu，5-10 分钟，重启电脑。

方法二：离线安装（网络不好用这个）

微软官网的 .appx 下载特别慢。清华镜像站提供了 .wsl 格式的离线镜像：

• Ubuntu 24.04：https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/24.04/ubuntu-24.04.4-wsl-amd64.wsl
• Ubuntu 22.04：https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/22.04/ubuntu-22.04.5-wsl-amd64.wsl

下载后用 wsl –import 导入：

mkdir D:\\WSL\\Ubuntu2204
wsl —import Ubuntu2204 D:\\WSL\\Ubuntu2204 D:\\下载\\ubuntu-22.04.5-wsl-amd64.wsl —version 2

启动：

wsl –d Ubuntu2204

⚠️ 如果导入报「权限不足」，检查是否以管理员身份运行 PowerShell。

1.5 设置 Linux 账户

首次启动 Ubuntu 会提示创建 Linux 用户名和密码（与 Windows 账户独立）：

• 用户名：随便输，比如 hermes，回车
• 密码：输一个密码（打字时屏幕没反应，不是键盘坏了），回车
• 确认密码：再输一次，回车

看到 hermes@DESKTOP:~$ 这样的提示符，WSL 就好了。

以后每次操作 Hermes，打开 Ubuntu 终端就行。Windows 开始菜单里会有 Ubuntu 图标：

1.6 检查

wsl –version
wsl -l -v

确认 WSL 版本是 2，Status 为 Running：

1.7 常用操作

Step 2：装 Hermes

现在在 Ubuntu 终端里操作。

2.1 更新软件包

sudo apt update
sudo apt upgrade -y

2.2 装依赖

sudo apt install curl git -y

2.3 一键安装

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

等几分钟。装完显示「Hermes installed successfully!」。

网络不好可以反复跑，安装脚本支持断点续传。

2.4 验证

hermes –version

有版本号就装好了。

Step 3：免费申请 API Key——给 AI 安个大脑

Hermes 本身是空壳，得连上大模型才能回答问题。

3.1 方案一：NVIDIA NIM API（国内直连，无需代理）

NVIDIA 注册送免费额度，国内直连。

① 注册账号

打开 https://build.nvidia.com，点右上角「Login」→「Create Account」→ 填邮箱（QQ 邮箱或 Outlook，收验证码比较稳）→ 设密码 → 去邮箱激活。

② 验证手机号

页面顶部提示「Verify your account to unlock API access」。点「Verify」→ 输手机号（+86）→ 收短信验证码提交。

③ 创建 API Key

点右上角头像 →「API Keys」→「+ Create API Key」→ Name 随便填 → Expiration 选 12 个月 →「Create Key」。

⚠️ Key 只显示一次，关掉就看不到了。立刻复制保存。

3.2 方案二：DeepSeek API（备选）

NVIDIA 额度用完或者想用国产模型，去 DeepSeek 官网申请：

https://platform.deepseek.com/

同样流程——注册、认证、创建 API Key。计费也比较良心，充几块钱用很久。

Step 4：配置 Hermes 模型

把 API Key 告诉 Hermes。

hermes setup

选 quick setup。

或者用更细粒度的模型配置：

hermes model

上下键选择：

① 选 Provider：找到 NVIDIA NIM（方案一）或 DeepSeek（方案二），空格选中，回车确认。

② 输 API Key：把保存的 Key 粘贴进去，回车。

💡 控制台输入时不显示内容。先复制 Key，在黑窗口里右键一次粘贴，再回车。

③ 选模型：建议 minimaxai/minimax-m2.7 或 z-ai/glm-5.1，回车确认。

4.1 验证

hermes chat -q "你好，你是谁？"

能正常回答就通了。报错多半是 API Key 没填对，或者网络问题。

hermes chat -q "xxx" 是一次性问答，答完退出。

Step 5：连接微信

5.1 启动网关

hermes gateway run

程序启动后会显示二维码，用微信扫码。

没显示二维码可能是没装 qrcode 库，复制它给的链接到浏览器手动打开。

5.2 扫码

扫码后你的微信会进入聊天界面。发条消息给机器人，比如「测试」，看终端有没有回复。

微信相当于一个 AI 入口——别人发消息给你，Hermes 也能处理。

5.3 让网关一直在后台跑

关掉 Ubuntu 窗口网关就停了。装 tmux 来保持运行：

sudo apt install tmux -y

tmux new-session -d -s hermes-gw 'hermes gateway run'

关了窗口它也在跑。查看状态：

tmux capture-pane -t hermes-gw -p | tail -20

关掉：

tmux kill-session -t hermes-gw

Step 6：连接飞书

微信有了，再加个飞书。

6.1 配置飞书

在 Ubuntu 终端运行：

hermes gateway setup

选飞书（Feishu/Lark），会弹出链接或二维码。浏览器打开链接或用飞书扫码，授权后自动创建好机器人，不需要手动去开发者后台折腾。

6.2 验证

飞书给机器人发消息，应该能正常回复。

6.3 重启网关

⚠️ 微信和飞书共用同一个网关进程。配完飞书需要重启才能生效：

tmux kill-session -t hermes-gw 2>/dev/null
tmux new-session -d -s hermes-gw 'hermes gateway run'

踩坑记录

总结

进阶方向

• 安装 Hermes Workspace，Web 管理界面
• 技能系统和持久记忆
• 接入更多平台（Telegram、Discord 等）

参考链接

• Hermes Agent 官方文档
• Hermes Agent 中文社区 – 快速入门
• Hermes Agent 中文社区 – Windows 安装
• Hermes Agent GitHub 仓库
• NVIDIA NIM API Key 申请
• DeepSeek 开发者平台
• WSL 官方安装文档
• WSL 手动安装步骤
• WSL2 Linux 内核更新包
• 清华镜像站 – Ubuntu 24.04 WSL
• 清华镜像站 – Ubuntu 22.04 WSL
• 飞书开放平台文档

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。