10+年产品经理聊聊产品、测测产品,产品人交流学习成长平台,按 Ctrl+D 收藏我们
关于我 留言板 小程序 标签云

苏米客

  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
  • 登录
  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
当前位置: 首页 » AI学习教程

Hermes Agent 全平台部署指南:Linux、macOS、WSL2、Termux、Docker 一键安装

2小时前 AI学习教程 16 0

苏米注:Hermes Agent 官方唯一推荐的部署方式就是一行命令,适用于 Linux、macOS、WSL2、Termux。这篇文章我来整理全平台部署的完整指南,包括前置条件、部署步骤和常用命令。

Hermes Agent 启动界面

一、一键安装命令(官方推荐)

适用于 Linux、macOS、WSL2、Termux:

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

安装完成后必须执行:

source ~/.bashrc # 或 source ~/.zshrc(macOS 默认)
hermes doctor # 验证安装
hermes # 直接进入聊天

苏米注:下面按平台给你完整前置条件 + 部署步骤,全部来自官方 README 和最新变更记录。

二、Windows 部署(必须通过 WSL2)

官方明确说明:原生 Windows 不支持,必须安装 WSL2。

前置条件

  • Windows 10 版本 2004 或更高 / Windows 11
  • 启用"虚拟机平台"和"适用于 Linux 的 Windows 子系统"功能

WSL2 安装步骤

在 Windows PowerShell 以管理员身份运行:

# 启用 WSL2
wsl --install

# 设置默认版本为 WSL2
wsl --set-default-version 2

# 更新 WSL
wsl --update

# 重启电脑(重要!)

重启后,打开 Ubuntu(开始菜单搜索"Ubuntu"),进入 Ubuntu 终端,或者直接在 PowerShell 中输入 wsl 即可进入 WSL2 内部署 Hermes。

WSL2 内部署 Hermes

# 前置依赖(避免 ripgrep/ffmpeg 报错)
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository universe -y
sudo apt update

# 官方安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes doctor

三、Linux 部署(Ubuntu / Debian / Fedora 等)

前置条件

  • Ubuntu 22.04 / 24.04 或其他主流发行版
  • 普通用户权限(sudo)

部署步骤

# 前置依赖(强烈推荐)
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository universe -y
sudo apt update

# 官方安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes doctor

四、macOS 部署(Intel + Apple Silicon 均支持)

前置条件

  • macOS Ventura 或更高版本
  • 命令行工具(如果没有会自动提示安装)

部署步骤

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc  # macOS 默认使用 zsh
hermes doctor

五、Android / Termux 部署(手机部署)

前置条件

  • Android 7.0+
  • 已安装 Termux + Termux:API(F-Droid 或 GitHub 下载最新版)
  • 执行过 termux-setup-storage

部署步骤(在 Termux 内)

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

Termux 部署完成界面

官方特殊说明:Termux 会自动使用 [termux] 精简依赖,避免完整 [all] 拉取不兼容的语音库。

六、Docker 部署(VPS / 服务器 / 容器化)

苏米注:这是最推荐长期运行的方式。

前置条件

  • 已安装 Docker 或 Podman

部署步骤

# 拉取官方镜像
docker pull ghcr.io/nousresearch/hermes-agent:latest

# 运行(持久化配置)
docker run -d \
  --name hermes \
  -v ~/.hermes:/root/.hermes \
  -p 18789:18789 \
  ghcr.io/nousresearch/hermes-agent:latest

进入容器后可执行 hermes 命令。

七、通用部署后操作(所有平台)

1. 配置模型(推荐 DeepSeek)

hermes config provider deepseek --api-key sk-你的 key

2. 启动持久服务

hermes start

3. 更新 Hermes(所有平台统一)

hermes update

部署优先级推荐:

  • 最推荐:直接用 curl 一键安装(官方维护最好)
  • 服务器长期运行:Docker
  • 手机:Termux
  • Windows 用户:必须走 WSL2

八、常用 CLI 命令

以下是官方 CLI 最常用命令:

基础聊天

hermes # 进入交互式聊天模式(最常用)
hermes chat -q "你的问题" # 单次查询(非交互)
hermes chat --model "deepseek/chat" # 指定模型
hermes chat --provider deepseek # 指定提供商

会话管理

hermes --continue 或 hermes -c # 继续上一个会话
hermes --resume # 继续指定会话
hermes sessions list # 查看所有历史会话

技能加载

hermes -s skill1,skill2 # 启动时预加载技能
hermes chat -s github-pr-workflow -q "任务" # 单次查询加载技能

工具与调试

hermes doctor # 健康诊断
hermes --verbose # 详细模式
/tools # 查看当前可用工具
/skills browse # 浏览技能中心

其他实用命令

hermes start # 启动持久后台服务
hermes update # 更新 Hermes
hermes gateway setup # 配置消息通道(如飞书)
/voice on # 开启语音模式
/reasoning high # 提升推理强度

九、技能篇(常用技能与管理)

Hermes 技能分类图

Hermes 官方内置 79 个技能 + 47 个可选 + 521 个社区技能,共 647 个,分为 16 大类。

常用高频技能分类

  • 内容创作:youtube-content、songwriting-and-ai-music
  • GitHub 工作流:github-pr-workflow、github-code-review、github-issues
  • 生产力:powerpoint、notion、google-workspace、nano-pdf
  • 媒体生成:ascii-video、manim-video、stable-diffusion-image-generation
  • AI 开发:hermes-agent(自指)、dspy、unsloth、vllm
  • 研究工具:arxiv、llm-wiki

技能使用方式

  • 直接在对话中提到关键词,Hermes 会自动触发
  • 启动时预加载:hermes -s skill 名称
  • 浏览技能:聊天中输入 /skills browse

创建/自定义技能

  • 技能本质是 Markdown 文件(.md),放在 ~/.hermes/skills/ 目录
  • 官方推荐结构:描述 + 使用示例 + 参数 + 工具调用
  • 社区技能可通过 Skills Hub 一键安装

十、消息通道配置(飞书、个人微信、企业微信)

飞书/Lark 配置完整步骤

方式一:一键创建(推荐)

hermes gateway setup

选择 Feishu / Lark → 用手机扫码自动创建应用。

方式二:手动配置

  1. 打开飞书开放平台
  2. 创建应用 → 复制 App ID 和 App Secret
  3. 开启 Bot 能力

配置环境变量(推荐写到 ~/.hermes/.env):

FEISHU_APP_ID=cli_xxxx
FEISHU_APP_SECRET=xxxx
FEISHU_DOMAIN=feishu # 或 lark(国际版)
FEISHU_CONNECTION_MODE=websocket  # 推荐
FEISHU_ALLOWED_USERS=ou_xxx,ou_yyy  # 可选白名单

启动消息通道:

hermes gateway

设置默认主页聊天(用于定时任务通知):在飞书里和机器人聊天,输入 /set-home

部署后立即建议

hermes config provider deepseek --api-key sk-你的 key
hermes start
hermes gateway setup

十一、总结

Hermes Agent 的部署非常简单,官方一键脚本已经处理了 99% 的情况。核心命令就一个:

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

根据你的平台选择对应的前置依赖安装,然后一键搞定。

声明:本站原创文章文字版权归本站所有,转载务必注明作者和出处;本站转载文章仅仅代表原作者观点,不代表本站立场,图文版权归原作者所有。如有侵权,请联系我们删除。
未经允许不得转载:Hermes Agent 全平台部署指南:Linux、macOS、WSL2、Termux、Docker 一键安装
#Hermes Agent #部署教程 #WSL2 #Termux #Docker #AI 助手 
收藏 1
Seedance 2.0 Prompt 圣经:5 层提示词结构 + 镜头关键词库 + 约束系统完整指南
LangChain Deep Agents v0.5 + Deploy 详解:异步子 Agent 与一条命令部署生产环境
推荐阅读
  • 基于MiniMax Agent的端到端开发体验,打造AI原创音乐生成器
  • 多 Agent 协调的五种模式详解:从生成 - 验证到共享状态,按需演进
  • 即梦AI图像生成器.exe(开源+打包)
  • 手把手教你在 Mac mini部署 OpenClaw 并接入企业微信,打造属于自己的AI助理全流程
  • 从零开始的完整部署永久免费7×24 在线运行的 OpenClaw 实操指南
评论 (0)
请登录后发表评论
分类精选
Cursor永久免费攻略:无限邮箱注册+重置机器码+Cursor试用期重置工具实现永久免费使用
46395 1年前
手把手教你如何使用扣子Coze搭建“文生图” AI Bot
19295 1年前
n8n新手入门指南:5 分钟本地部署 + 中文汉化 + 快速启动,玩转工作流(Docker版)
18140 10月前
安装字节Trae登录提示App Unavailable(应用程序不可用)解决办法,这份官方指南请收好!
17510 1年前
Gemini CLI 装好了,登录异常怎么办?手把手教你解决 Gemini CLI 登录问题
14518 9月前
零基础上手 VSCode + Claude Code + GLM-4.6 保姆级安装配置教程
14338 6月前
一文搞懂什么是 Vibe Coding?Vibe Coding工具推荐及Cursor编程开发实践
14098 11月前
AI 概念篇:Token是什么?一文讲清楚Token分词、窗口、计费与常用计算工具
13345 4月前
手把手教你使用 Gemini 2.5 Pro 免费 API搭建本地知识库,一键接入 Gemini!
13088 9月前
手把手教你快速入门OpenCode + GLM-4.7 + Oh-My-Opencode + Skills 安装配置与高效使用指南
11653 3月前

文章目录

关注「苏米客」公众号

订阅推送更及时,手机查看更方便
分类排行
1 Hermes Agent 全平台部署指南:Linux、macOS、WSL2、Termux、Docker 一键安装
2 Seedance 2.0 Prompt 圣经:5 层提示词结构 + 镜头关键词库 + 约束系统完整指南
3 在飞书操控 Claude Code:GitHub 开源 Skill 远程部署指南
4 MiniMax-M2.7 量化版本地部署指南:Unsloth 22 个版本选择 +3 种部署方式详解
5 Hermes Agent 新手指南:上手后必试的 10 个核心功能
6 Hermes Agent 零基础上手指南:3 种安装方式 +12 个踩坑解决方案
7 Hermes Agent 部署教程:一行命令安装 + 微信个人号扫码接入(10 分钟完成)
8 Hermes Agent 微信配置完整教程:个人微信与企业微信接入指南
9 手把手教你Windows WSL2环境下安装Hermes Agent,和本地 CLI 与微信通道完整配置教程指南
10 WorkBuddy 进阶:别再用默认模型了!切换 GLM-5.1 后我的工作效率翻了 3 倍
©2015-2024 苏米客XMSUMI 版权所有 · WWW.XMSUMI.COM 闽ICP备14005900号-6
微信文章助手 程序库 免费影视APP 免费字体下载 Axure RP 10 免费Axure模板 Axure元件库下载 申请友联