🧙 Hermes 安装指南
从零开始
👋 欢迎小白朋友! Hermes Agent 是 Nous Research 开发的自进化 AI 智能体,支持任意大模型 + 20 余种社交平台。这份指南会带你一步一步完成安装与配置,只需按顺序操作即可。
打开终端(在“启动台”里搜索“终端”),粘贴下面这行命令,然后按 回车:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
⏳ 脚本会自动下载并安装所需文件。看到“安装完成”或类似提示后,再进入下一步。
安装完成后,在终端输入以下命令启动配置向导:
hermes setup
💡 如果提示 command not found: hermes,先执行 source ~/.zshrc 然后重新打开终端,或直接重启终端再试。
在出现的菜单中,用键盘 ↑ ↓ 方向键 选择 “Custom endpoint (enter URL manually)”,然后按 回车。
⚠️ 请从你的AI服务商(如阿里云百炼、DeepSeek等)获取以上信息。粘贴时不要带空格或换行。
配置保存后,在终端运行:
hermes chat -q "你好,请用一句话介绍自己"
如果能收到正常的AI回复,恭喜你,大脑连接成功!
✅ 如果返回错误,请回到第3步检查 API Key 和 URL 是否完全正确。
启动网关配置界面:
hermes gateway setup
选择你想连接的平台(点击下方标签查看说明):
💬 微信
🐦 飞书
📌 钉钉
✈️ Telegram
🎮 Discord
💼 Slack
📱 WhatsApp
👆 点击平台查看推荐配置方式
✨ 点击上方任意平台,查看扫码或手动配置说明
平台配置完成后,启动网关服务:
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 说明为准。祝你搭建顺利!