Hermes Agent 对接微信教程（免费 本地模型 无需Token）

[b]完全免费、无需 API Key、可接入微信[/b]——Hermes Agent WebUI Ollama 本地模型，打造私有 AI 助手系统。

[hr]

size=20一、整体架构/b

listOllama 本地模型 — 大模型推理
[*]Hermes Agent — AI Agent 调度核心
[*]Hermes WebUI — 可视化操作界面
[*]微信接入 — 聊天控制[/list]

[hr]

size=20二、安装本地模型（Ollama）/b

1️⃣ [url=https://ollama.com]下载安装 Ollama[/url]

2️⃣ 拉取模型：
[quote]ollama run gemma4[/quote]

3️⃣ 获取局域网 API 地址（CMD执行 [b]ipconfig[/b]，找 IPv4 地址）：
[quote]http://192.168.x.x:11434/v1[/quote]

[hr]

size=20三、安装 WSL2（Windows 推荐）/b

管理员 PowerShell 执行：
[quote]wsl --install
wsl --install -d Ubuntu
wsl --version （确认版本为 WSL2）[/quote]

[hr]

size=20四、部署 Hermes Agent WebUI/b

Ubuntu 中执行：
[quote]curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash[/quote]

检查环境：
[quote]hermes doctor[/quote]

安装 WebUI：
[quote]git clone https://github.com/nesquena/hermes-webui.git hermes-webui
cd hermes-webui
./start.sh[/quote]

启动后访问：[b]http://127.0.0.1:8787[/b]

Mac 系统一键部署：
[quote]git clone https://github.com/nesquena/hermes-webui.git hermes-webui
cd hermes-webui
python3 bootstrap.py[/quote]

[hr]

size=20五、配置 Hermes 对接本地模型/b

[quote]hermes setup[/quote]

关键配置：
listModel Provider：选择 [b]OpenAI Compatible[/b]
[*]Base URL：填入你的 Ollama 地址（用局域网 IP，不是 127.0.0.1）
[*]Model Name：[b]gemma4/b

⚠ 如果提示 context window too small，修改 context_length: 8192

[hr]

size=20六、对接微信（重点）/b

[quote]hermes setup[/quote]

找到 [b]messaging platforms[/b] → 选择 [b]weixin / wechat[/b]

系统会弹出二维码，用微信扫码即可绑定。

✅ 完成效果：
list一个微信 AI 助手
[*]基于本地模型，无需 API 费用
[*]可执行自动化任务[/list]

⚠ 微信掉线是微信协议限制，建议保持 Hermes 常驻运行，避免频繁重启。

[hr]

size=20七、常见问题/b

list模型上下文不足：换更大模型或设置 context_length
[*]Ollama 无法访问：检查是否用了 127.0.0.1，必须用局域网 IP
[*]WebUI 无法打开：检查端口占用，重新 ./start.sh[/list]

[hr]

[quote]参考来源：[url=https://www.freedidi.com/23749.html]零度博客[/url] - 感谢零度解说的详尽教程。[/quote]