🧙 Hermes 安装指南 从零开始

👋 欢迎小白朋友! Hermes Agent 是 Nous Research 开发的自进化 AI 智能体,支持任意大模型 + 20 余种社交平台。这份指南会带你一步一步完成安装与配置,只需按顺序操作即可。
1

运行一键安装脚本

打开终端(在“启动台”里搜索“终端”),粘贴下面这行命令,然后按 回车

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
脚本会自动下载并安装所需文件。看到“安装完成”或类似提示后,再进入下一步。
2

确认安装并进入配置模式

安装完成后,在终端输入以下命令启动配置向导:

hermes setup
💡 如果提示 command not found: hermes,先执行 source ~/.zshrc 然后重新打开终端,或直接重启终端再试。
3

连接AI大脑 · 自定义接口

在出现的菜单中,用键盘 ↑ ↓ 方向键 选择 “Custom endpoint (enter URL manually)”,然后按 回车

⚠️ 请从你的AI服务商(如阿里云百炼、DeepSeek等)获取以上信息。粘贴时不要带空格或换行
4

测试你的Hermes是否“活”了

配置保存后,在终端运行:

hermes chat -q "你好,请用一句话介绍自己"

如果能收到正常的AI回复,恭喜你,大脑连接成功!

如果返回错误,请回到第3步检查 API Key 和 URL 是否完全正确。
5

接入社交平台(微信/飞书/钉钉)

启动网关配置界面:

hermes gateway setup

选择你想连接的平台(点击下方标签查看说明):

💬 微信 🐦 飞书 📌 钉钉 ✈️ Telegram 🎮 Discord 💼 Slack 📱 WhatsApp
👆 点击平台查看推荐配置方式
✨ 点击上方任意平台,查看扫码或手动配置说明
6

重启网关 & 开始聊天

平台配置完成后,启动网关服务:

hermes gateway start

之后你就可以在对应的社交 App 里找到机器人,和它对话了!

🛠 常见问题速查
· Invalid API Key → 检查 Key 是否完整,无多余空格或换行符。
· 扫码没反应 → 确保手机与电脑在同一网络,并使用管理员账号扫描。
· command not found: hermes → 执行 source ~/.zshrc 并重启终端。
· 安装脚本失败 → 检查网络连接,或访问项目 GitHub 查看最新安装方式。
· 网关无响应 → 执行 hermes gateway stop 后再 hermes gateway start 重启。

🌟 项目更新频繁,可随时运行 hermes update 升级到最新版,遇到问题用 hermes doctor 诊断。如有疑问请以 Hermes Agent 官方 GitHub 说明为准。祝你搭建顺利!