Hermes Agent 是由 Nous Research 开发的开源自主 AI 智能体，上线仅六周便突破 4.7 万 GitHub 星标，成为 2026 年最受关注的开源 AI Agent 框架之一。其核心竞争力在于持久化记忆与完整的自我学习闭环——能自主创建技能、在使用中优化技能、跨会话召回记忆。
本文将从安装优化、模型配置、工具启用三个维度，为你提供一份保姆级教程。
一、安装优化：一行命令快速部署
1.1 前置条件
Hermes Agent 支持 Linux、macOS、WSL2 多平台，前置依赖只需要 Git，其余（Python、ripgrep、ffmpeg）安装脚本自动处理。
| 平台 | 支持状态 | 备注 |
|---|---|---|
| Linux | 官方支持 | 推荐 Ubuntu 20.04+ |
| macOS | 官方支持 | 支持 Intel 和 Apple Silicon |
| Windows (WSL2) | 官方支持 | 需先安装 WSL2 |
| Android (Termux) | 官方支持 | 手机也能跑 |
1.2 一键安装命令
官方原版命令（海外用户）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash国内加速镜像（推荐）：
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash1.3 环境变量刷新
安装完成后，需刷新环境变量使命令生效：
# Bash 用户
source ~/.bashrc
# Zsh 用户
source ~/.zshrc1.4 安装优化技巧
- 使用国内镜像：下载速度提升 5-10 倍，避免超时失败
- 切换 root 用户：部分系统需要 root 权限，执行
sudo su root后再安装 - 预先安装 Git：执行
sudo apt install git -y（Ubuntu/Debian） - 网络检查：确保能访问 GitHub 或国内镜像站点
二、模型配置：对接主流大模型 API
2.1 配置向导
安装完成后，执行以下命令进入配置向导：
# 完整配置向导（推荐新手）
hermes setup
# 单独配置大模型
hermes model
# 单独配置工具权限
hermes tools2.2 支持的模型服务商
Hermes Agent 兼容主流大模型 API：
| 服务商 | 推荐模型 | 配置方式 |
|---|---|---|
| 阿里云百炼 | qwen3-max, qwen3.5-plus | 输入 DASHSCOPE_API_KEY |
| 智谱 AI | glm-5, glm-4-plus | 输入 ZHIPU_API_KEY |
| 月之暗面 | kimi-k2.5 | 输入 MOONSHOT_API_KEY |
| DeepSeek | deepseek-chat, deepseek-coder | 输入 DEEPSEEK_API_KEY |
| OpenAI | gpt-4o, gpt-4-turbo | 输入 OPENAI_API_KEY |
| Anthropic | claude-3-opus, claude-3-sonnet | 输入 ANTHROPIC_API_KEY |
2.3 阿里云百炼配置详解（推荐）
步骤一：获取 API Key
- 访问 阿里云百炼大模型服务平台
- 进入「密钥管理」，点击「创建 API-Key」
- 推荐购买「Coding Plan AI 编码套餐」：固定月费，额度内无限调用
步骤二：配置 Hermes Agent
hermes model
# 选择 "More providers..." → "Custom endpoint"
# 输入 BaseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
# 输入 API-KEY: sk-xxxxxxxxxxxxxxxx
# 输入 Model name: qwen3.5-plus2.4 模型选择建议
- 日常对话：qwen3.5-plus（性价比高）
- 复杂任务：qwen3-max（能力更强）
- 代码开发：deepseek-coder（专业代码模型）
- 长文本处理：kimi-k2.5（超长上下文）
三、工具启用指南：释放 Agent 全部能力
3.1 核心工具一览
| 工具类别 | 具体功能 | 适用场景 |
|---|---|---|
| 信息处理 | 网络搜索、网页提取、论文查找 | 资料调研、科研辅助 |
| 文件操作 | 文件读写、内容搜索、代码修补 | 文档处理、代码开发 |
| 终端执行 | Shell 命令、进程管理、权限控制 | 服务器运维、自动化 |
| 浏览器自动化 | 网页导航、页面交互、表单填写 | 爬虫、自动化测试 |
| 多平台接入 | 微信、飞书、钉钉、Telegram | 即时交互、任务下发 |
3.2 工具权限配置
hermes tools
# 按提示开启/关闭各类工具权限
# 建议首次使用全部开启，后续按需调整权限建议：
- 文件读写：开启（核心功能）
- 终端执行：谨慎开启（有安全风险）
- 网络搜索：开启（信息获取）
- 浏览器自动化：按需开启（资源占用较大）
3.3 技能系统启用
Hermes Agent 的核心优势是自主技能生成。在完成任务过程中，Agent 会自动创建可复用的技能文件。
手动安装技能：
# 从本地文件安装
hermes skills install ./my_skill.py
# 从 GitHub 仓库安装
hermes skills install https://github.com/xxx/hermes-skills
# 查看已安装技能
hermes skills list3.4 多平台接入配置
Hermes Agent 支持 12+ 消息平台接入，以微信为例：
配置步骤：
hermes gateway setup
# 选择 "Weixin/Wechat"
# 输入 Y 确认开启微信登录
# 浏览器打开输出链接，微信扫码授权
# 按提示完成权限配置支持的平台：
- 即时通讯：微信、企业微信、QQ、钉钉、飞书
- 国际平台：Telegram、Discord、Slack
- 其他：邮件、Webhook
四、启动与验证
4.1 启动命令
# 启动交互式对话
hermes
# 查看版本与能力
hermes --version
# 恢复上一次会话
hermes --continue
# 指定模型启动
hermes --model qwen3-max4.2 验证安装成功
启动成功后，终端会显示欢迎横幅，包含：
- 当前使用的模型
- 可用的工具列表
- 已安装的技能数量
- 内存系统状态
五、常见问题与解决方案
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 安装脚本执行失败 | 网络问题/权限不足 | 使用国内镜像；切换 root 用户 |
| 模型调用失败 | API Key 错误 | 核对 Key 有效性；确保地域匹配 |
| 微信接入无响应 | 网络异常/网关未重启 | 检查网络；重启聊天通道网关 |
| 技能无法生成 | 权限不足 | 开启终端工具执行权限 |
| 内存不足 | 实例规格过低 | 升级配置，关闭不必要进程 |
六、进阶配置建议
6.1 性能优化
- 定期更新：执行
hermes update获取最新功能 - 清理缓存：执行
hermes cache clear释放空间 - 日志查看：执行
hermes logs排查问题
6.2 安全建议
- 切勿将 API Key 泄露到公共平台
- 为不同场景配置最小权限
- 定期检查技能文件内容
- 使用 Docker 隔离运行环境（高级用户）
6.3 长期使用建议
- 购买 Coding Plan 套餐，避免按量计费超支
- 配置定时任务，实现自动化运维
- 定期备份技能和记忆文件
- 加入社区获取最新技能和最佳实践
七、总结
Hermes Agent 作为 2026 年最具潜力的开源 AI Agent 框架，其安装配置已非常简化。一行命令安装、交互式配置向导、丰富的工具生态——让每个人都能快速拥有自己的”数字员工”。
核心要点回顾：
- 安装：使用国内镜像加速，注意环境变量刷新
- 模型：推荐阿里云百炼，性价比高且稳定
- 工具：按需开启权限，注意安全风险
- 技能：让 Agent 越用越聪明，自主进化
现在就动手安装，开启你的 AI Agent 之旅吧！
