近期AI开源圈最火的工具非HermesAgent莫属,这款由硅谷Nous Research实验室开发的自进化AI智能体,开源不到两个月GitHub星标就飙升至9.3万。为了帮新手快速上手,避开安装和接入过程中的各种坑,本文整理了一份全程保姆级教程——无需复杂技术基础,不用深入研究底层逻辑,从终端安装、环境检测、模型配置,到聊天软件接入,每一步都附带详细说明和问题解决方案。

一、安装Hermes

1、打开终端(Windows 用户推荐用 WSL2, macOS 和 Linux 用户直接用自带终端),粘贴以下命令:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

官方把安装脚本放在了 GitHub 上,这条命令本质上是下载脚本然后自动执行。-fsSL 是 curl 的参数,意思是"失败不输出错误、静默模式、跟随重定向",不需要懂,记住这条就够了。

2、安装完成后,运行这两条命令:

hermes version

hermes doctor

①hermes version 会显示当前版本号,如果报 “command not found”,说明安装路径没加到环境变量里,重启终端再试。

②hermes doctor 是诊断命令,它会检查你的系统环境、依赖项是否齐全。看到 “All checks passed” 就可以继续了。如果哪里红了,去官方文档找对应的修复方案,一般是缺某个系统库。

3、最后需要配置模型,推荐用 DeepSeek 或 Kimi,原因是免费额度高、响应速度快、对中文理解好。

DeepSeek模型配置命令如下:

hermes config set MODEL_PROVIDER deepseek

hermes config set DEEPSEEK_API_KEY your_api_key_here

Kimi模型配置命令如下:

hermes config set MODEL_PROVIDER kimi

hermes config set KIMI_API_KEY your_api_key_here

二、接入聊天软件

1、接入Telegram

①在 Telegram 里搜索 @BotFather,发送 /newbot,按提示给机器人起名字

②创建完成后,BotFather 会给你一串 Token,格式类似 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

③在终端配置 Token:

hermes config set TELEGRAM_BOT_TOKEN 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

④启动 Telegram 网关:

bashhermes gateway --platform telegram

现在你可以在 Telegram 里给你的机器人发消息了,它会通过 Hermes 处理并回复你。

2、接入飞书 / 钉钉

①以钉钉为例子,登录钉钉开放平台,创建一个企业内部应用,拿到 AppKey 和 AppSecret

②输入以下命令:

hermes config set DINGTALK_APP_KEY your_app_key

hermes config set DINGTALK_APP_SECRET your_app_secret

③启动网关:

hermes gateway --platform dingtalk

接飞书同理,换成 --platform feishu 就行。