夜雨聆风你是否想过拥有一个真正属于自己、能帮你写代码、查资料、执行命令的AI助理？它不仅要聪明，还得足够私密、安全，并且能随时随地通过手机（比如飞书）联系上。
本文将带你从零开始，在Windows电脑的WSL2环境中，一步步部署强大的开源AI Agent——Hermes，并将其接入飞书，让你在手机和电脑上都能随时召唤它。整个过程，我们还会使用国内稳定、性价比高的阿里云百炼大模型作为“大脑”。
文章适合：对AI工具感兴趣、有一定电脑基础但不想被复杂配置劝退的读者。
---
第一章：准备工作——在Windows中安装WSL2
Hermes Agent 最推荐运行在Linux环境中。对于Windows用户，最便捷的方式就是使用WSL2（Windows Subsystem for Linux）。
1. 以管理员身份打开 PowerShell，执行以下命令开启WSL功能：
```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```
2. 重启电脑，然后继续在管理员PowerShell中更新WSL2内核并设为默认版本：
```powershell
wsl --update
wsl --set-default-version 2
```
3. 打开 Microsoft Store，搜索并安装你喜欢的Linux发行版，推荐 Ubuntu 22.04 LTS 或 24.04 LTS。安装完成后启动，并按照提示设置你的用户名和密码。
---
第二章：安装Hermes——一行命令搞定
Ubuntu终端启动后，我们开始安装主角Hermes Agent。为了避免国内网络问题，我们使用镜像加速。
1. 执行安装命令（等待脚本自动完成环境检测和依赖安装）：
```bash
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
2. 激活虚拟环境：安装完成后，激活Hermes自带的Python虚拟环境，以便后续使用。
```bash
source ~/.hermes/venv/bin/activate
```
---
第三章：配置“大脑”——接入阿里云百炼大模型
Hermes本身只是一个“躯壳”，我们需要给它接入一个大模型作为“大脑”。考虑到国内访问的稳定性，这里推荐使用阿里云百炼（DashScope）。
1. 获取API Key：登录阿里云百炼控制台，创建一个API Key（以 sk- 开头）。如果你在中国站创建，请记住使用中国站的接入地址。
2. 在Hermes中配置：
```bash
# 设置环境变量（将你的API Key替换进去）
echo "DASHSCOPE_API_KEY=sk-你的阿里云百炼API_Key" >> ~/.hermes/.env
```
3. 运行配置向导，选择 Qwen Cloud / DashScope 提供商，并务必根据你的API Key区域修改Base URL：
```bash
hermes setup
```
· 中国站（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
· 国际站（新加坡）：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
4. 测试：在终端中输入 hermes chat，然后发送“你好”，如果能看到回复，说明“大脑”已经成功激活。
---
第四章：连接“神经”——配置飞书机器人网关
为了能在手机或电脑的飞书上随时和它聊天，我们需要配置飞书网关。
1. 创建飞书应用：前往飞书开放平台，创建一个“企业自建应用”，记下 App ID 和 App Secret，并启用“机器人”能力。
2. 在Hermes中配置网关，按照提示输入App ID和App Secret，连接模式选择 WebSocket（无需公网IP）：
```bash
hermes gateway setup
```
3. 安全设置：在权限设置中，推荐选择 “Use DM pairing approval”，这能有效防止陌生人滥用你的机器人。
---
第五章：启动与配对——让AI“活”起来
所有配置完成后，就是激动人心的启动时刻了。
1. 启动网关：在终端中执行以下命令，保持终端运行。
```bash
hermes gateway
```
2. 飞书配对：打开飞书，找到你的机器人（应用名称），发送一条消息（如“你好”）。机器人会回复一个配对码。
3. 在终端批准：复制配对码，并在终端中执行批准命令。完成后，再次在飞书中发送消息，机器人就会智能地回复你了！
```bash
hermes pairing approve feishu <你的配对码>
```
---
第六章：体验与总结
至此，你的专属AI助理已经正式上岗了！🎉
你可以这样使用它：
· 终端使用：随时在WSL终端中通过 hermes chat 进行高强度、复杂任务的对话。
· 飞书使用：在飞书私聊或群聊中 @你的机器人，进行日常问答、资料查询、代码编写等。
总结一下技术亮点与优势：
· 数据私密：所有代码和文件操作都在你的本地WSL环境中执行。
· 模型灵活：可以轻松切换不同的模型提供商（DeepSeek、OpenAI、本地Ollama等）。
· 多渠道接入：一次配置，不仅限于飞书，还支持Telegram、微信等多种平台。
· 性价比高：使用阿里云百炼等国内服务，成本更低，延迟更小。
希望这篇教程能帮你打开AI应用世界的一扇新大门。动手试试，让Hermes成为你工作学习中的得力伙伴吧！
---
💡 最后提醒：
如果在任何步骤遇到网络超时问题，可以尝试更换镜像源或使用Wget方式下载ZIP包。如果在配置中遇到错误，记得仔细检查API Key和Base URL是否匹配你的模型服务区域。
