Hermes Agent 安装指南
一、安装流程概览
准备环境 → 拉取项目 → 启动并配置
二、安装前置要求
工具检查命令说明Python 3.11+python –version 或 python3 –version显示 Python 3.11.x 即可Gitgit –version显示版本号即可uv—使用一键安装脚本时会自动处理，无需手动安装
三、Linux / macOS 安装步骤
方式一：一键安装（推荐）
执行命令：
脚本会自动完成所有依赖配置、虚拟环境创建，并将 hermes 命令链接到系统路径。
方式二：手动安装
第一步：克隆仓库
执行命令：
git clone –recurse-submodules
cd hermes-agent
⚠️ 必须加上 –recurse-submodules，否则子模块无法正确拉取，后续步骤会失败。
若已克隆但忘记加该参数，可补救：
git submodule update –init –recursive
第二步：安装 uv 并创建虚拟环境
执行命令：
uv venv venv –python 3.11
第三步：安装依赖
执行命令：
export VIRTUAL_ENV=”$(pwd)/venv”
安装全部功能（含 Discord / Telegram / cron 支持）：
uv pip install -e “.[all]”
或仅安装核心功能：
uv pip install -e “.”
第四步：启动 Hermes
执行命令：
./hermes
启动成功后会显示欢迎界面，包含当前模型、可用工具和技能列表。
四、Windows 用户：安装 WSL2
⚠️ Hermes Agent 不支持原生 Windows，必须先安装 WSL2，再在 WSL2 终端内执行上述 Linux 安装步骤。
第一步：以管理员身份打开终端
按 Win + X，选择「终端管理员」。
第二步：安装 WSL2
执行命令：
wsl –install
第三步：进入 WSL
执行命令：
wsl
第四步：设置用户名和密码
首次进入时会提示创建 Unix 用户名和密码。
💡 输入密码时屏幕不会有任何显示，盲打完成后按回车确认即可。
验证成功标志：终端出现绿蓝相间的提示符（格式为 用户名@主机名:路径$），即说明已成功进入 WSL2 环境。
第五步：在 WSL2 中运行一键安装命令
执行命令：
💡 macOS 用户无需以上操作，直接执行上方一键安装命令即可。
五、启动后配置
启动 Hermes 后会进入模型与服务商选择阶段：
-
国外模型：OpenAI GPT-4、Anthropic Claude 等
-
国内 / 灵活方案：Qwen 等
⚠️ 所选模型必须支持 至少 64K context。主流托管模型均满足此要求；若使用本地模型，需手动将 context size 设置为 64K 以上。
选择完成后记得保存配置。
六、如果你想把 Hermes 接入 Discord，该怎么做？
先在 Discord 里创建 bot → 再把 token 和用户权限配置到 Hermes → 最后启动 gateway
第一步：在 Discord Developer Portal 创建应用
进入 Discord Developer Portal，创建新的 Application，再进入 Bot 页面创建机器人。
第二步：打开关键权限
在 Bot → Privileged Gateway Intents 里打开：
-
Server Members Intent
-
Message Content Intent（最重要，不开则 bot 读不到消息内容）
第三步：复制 Bot Token
在 Bot 页面生成并复制 token。
⚠️ 不要把 token 暴露在公开仓库、文档或聊天群里。一旦泄露，直接重置。
第四步：生成邀请链接，把 bot 拉进服务器
进入 OAuth2 → URL Generator，生成邀请链接，将 bot 加入你的服务器。
第五步：打开开发者模式，复制你的 User ID
-
打开 Discord
-
进入 Settings → Advanced，打开 Developer Mode
-
右键你的用户名，点击 Copy User ID
第六步：在 Hermes 里配置 Discord
方式一：交互式配置
执行命令：
hermes gateway setup
选择 Discord，按提示填写 bot token 和 User ID。
方式二：手动写入配置文件 ~/.hermes/.env
配置内容：
DISCORD_BOT_TOKEN=your-bot-token
DISCORD_ALLOWED_USERS=284102345871466496
多个用户用逗号分隔：
DISCORD_ALLOWED_USERS=284102345871466496,198765432109876543
第七步：启动 Discord gateway
执行命令：
hermes gateway
启动成功后，bot 会在 Discord 中显示在线，可以私信、@ 或在频道中直接对话。
你的 Hermes agent 已经不只是本地 agent，而是一个真正接入 Discord 的可用机器人了。
七、两个关键配置建议
1. Max iterations
建议值：90
能给 agent 留出足够的执行空间，避免复杂任务因轮数限制被截断。
2. Session reset mode
建议设置成：Never auto-reset
保留上下文比频繁重置更合理，Hermes 本身依赖连续会话、记忆沉淀和经验复用。
八、实际使用中最容易遇到的问题
-
Windows 用户未使用 WSL2 导致环境不兼容
-
clone 时忘加 –recurse-submodules 导致子模块缺失
-
对 memory.md / session search 不熟悉
-
不清楚 Hermes 在实际业务流程里该怎么嵌入
-
Discord bot 已经在线，但一直不回复
-
token 配置看起来没问题，但仍然提示权限错误或用户不可用
九、Discord 接入最常见的坑
1. Bot 在线，但不回复消息
大概率是没有打开 Message Content Intent。
2. 提示 User not allowed，或者机器人直接无视你
你的 Discord 用户 ID 没有正确写进 DISCORD_ALLOWED_USERS。
3. Bot 一直处于离线状态
优先检查：
-
hermes gateway 是否已经启动成功
-
DISCORD_BOT_TOKEN 是否填写错误或已失效
如果在安装中遇到问题，可以私信我
本文来自转载知野 ，不代表发现AI立场，如若转载，请联系原作者；如有侵权，请联系编辑删除。
