安装指南

三步开始养马

PowerShell 安装 → 模型配置 → 消息网关。预计耗时 5 分钟。

第一步:安装 Hermes Agent

右键以 管理员身份 打开 PowerShell,执行以下命令:

irm https://res1.hermesagent.org.cn/install.ps1 | iex
国内镜像加速:安装脚本使用 res1.hermesagent.org.cn CDN 节点,全国平均下载速度 > 20 MB/s,整个安装过程约 30 秒。

安装完成后,在 PowerShell 中验证:

hermes --version

应输出类似 hermes-agent v0.10.0 (windows-native)

如果提示 "hermes 不是可识别的命令":关闭当前 PowerShell 窗口重新打开,或手动将 %USERPROFILE%\.hermes\bin 添加到 PATH 环境变量。

第二步:配置 AI 模型

运行 CLI 配置向导,选择你使用的模型提供商:

hermes setup

支持的模型提供商

提供商 推荐模型 需要 API Key 国内可用
OpenRouter Claude 4 Sonnet / GPT-4o ✅ OpenRouter Key ✅ 可用(需代理或国内代理)
通义千问 Qwen3-Max / Qwen3-Plus ✅ 阿里云 Key ✅ 完全可用
智谱 GLM GLM-4-Plus / GLM-4-Flash ✅ 智谱 Key ✅ 完全可用
DeepSeek DeepSeek-V3 / DeepSeek-R1 ✅ DeepSeek Key ✅ 完全可用
MiniMax abab7 / MiniMax-M1 ✅ MiniMax Key ✅ 完全可用
Ollama(本地) Qwen2.5-32B / Llama 3 ❌ 无需 ✅ 完全离线可用
推荐:日常使用选择通义千问或智谱(国内稳定、便宜);复杂任务用 OpenRouter 接 Claude/GPT;需要完全隐私的使用 Ollama 本地部署。

第三步(可选):连接消息平台

让 Hermes Agent 出现在微信、飞书、钉钉中——随时随地对话:

hermes gateway setup

Gateway 支持以下平台(按配置复杂度排序):

  1. 飞书

    创建飞书应用 → 获取 App ID/Secret → 配置消息回调 → 完成。约 5 分钟。

  2. 企业微信

    自建应用 → 配置回调 URL → 设置可信 IP → 完成。约 10 分钟。

  3. 钉钉

    创建机器人 → 配置 Webhook → 完成。约 5 分钟。

  4. 微信个人号

    需要 itchat-uos 或 wxhelper。约 10-20 分钟,需额外工具。

  5. Discord / Slack

    创建 Bot → 获取 Token → 配置 → 完成。约 5 分钟。

常见问题

安装时下载速度慢?

检查 DNS 是否被污染。在 PowerShell 中以管理员身份执行 ipconfig /flushdns 后重试。

hermes setup 报错 "连接超时"?

如果你选择的是 OpenRouter 等境外模型,需要配置代理。在 ~/.hermes/config.yaml 中添加:
proxy: http://127.0.0.1:7890(替换为你的代理端口)

如何从 OpenClaw 迁移?

Hermes 提供一键迁移命令:
hermes claw migrate --from ~/.openclaw
迁移内容包括:记忆数据、技能配置、API Key 等。

WSL2 和 Native 版如何选择?

Native 版:日常使用推荐。轻量、快速、集成 Windows 桌面体验。
WSL2 版:需要完整 Linux 环境、Docker、MCP Server 时使用。

还需要帮助?

加入微信社群,数百位养马人帮你解决问题。

加入微信社群