朱皮特的烂笔头

Hermes-agent（爱马仕）

2026/04/09 program 共 5102 字，约 15 分钟

Hermes简介

NousResearch/hermes-agent: The agent that grows with you

由Nous Research开发的自我改进型 AI 代理。它是唯一一款内置学习循环的代理——它从经验中创造技能，在使用过程中不断改进，自我引导以巩固知识，并在不同会话中构建一个不断加深的关于你的模型。

文档：Hermes Agent Documentation

安装

统一安装命令：

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

Windows子系统WSL2下安装

Windows下必须在WSL里安装，不支持Windows原生系统，使用统一安装命令安装即可。 可以在在wsl的Ubuntu里安装个GUI版本的文本编辑工具：gedit（sudo apt install gedit），方便后面编辑配置文件。

权限

在 WSL2 中给 Hermes Agent 开通命令执行权限，核心是修改 ~/.hermes/config.yaml，开启终端工具并调整审批策略。

一、用 gedit 打开配置文件

gedit ~/.hermes/config.yaml

二、开启命令执行（终端权限）

在 config.yaml 中添加 / 修改 tools.terminal 部分：

tools:
  terminal:
    enabled: true          # 开启终端命令执行（关键）
    require_approval: true # 每次执行前需你确认（安全默认）
    backend: local         # 本地执行（WSL2 直接用）
    timeout: 300           # 超时时间（秒）
  • enabled: true：必须设为 true，否则完全不能执行命令。
  • require_approval: true：默认安全，每次命令都会问你确认。

三、可选：关闭审批（自动执行，谨慎！）

如果你信任环境、不想每次确认，把审批模式改成 off：

approvals:
  mode: off  # manual（默认）/ smart / off
  • mode: manual：默认，每次都问。
  • mode: smart：AI 自动判断风险，低风险自动放行。
  • mode: off：所有命令自动执行（危险）。

四、可选：限制可执行路径（更安全）

限制 Hermes 只能在指定目录执行命令：

filesystem:
  enabled: true
  allowed_paths:
    - ~/workspace
    - /tmp
    - ~/projects

五、保存并生效

  1. 保存 gedit 并关闭
  2. 重启 Hermes（必须）
hermes restart

使用

常用命令如下：

# 修改配置
gedit ~/.hermes/config.yaml

# 网关配置
hermes gateway setup

# 启动网关
hermes gateway start

# 配置大模型
hermes model

# 命令行启动
hermes

基础配置命令

hermes setup # 交互式配置向导
hermes setup model # 配置模型/提供商
hermes setup terminal # 配置终端后端
hermes setup gateway # 配置消息网关
hermes setup tools # 配置工具集
hermes setup agent # 配置代理参数

hermes model # 交互式模型/提供商选择器
hermes config # 查看当前配置
hermes config edit # 用编辑器打开 config.yaml
hermes config set KEY VAL # 设置配置项
hermes config path # 打印配置文件路径
hermes config env-path # 打印 .env 文件路径
hermes config check # 检查缺失/过时的配置
hermes config migrate # 更新配置到新选项

hermes login --provider P # OAuth 登录 (nous, openai-codex, qwen-oauth 等)
hermes logout # 清除存储的认证信息

hermes doctor # 检查依赖和配置
hermes doctor --fix # 自动修复问题
hermes status # 显示组件状态
hermes status --all # 显示所有组件状态

工具集配置

hermes tools # 交互式工具启用/禁用 (curses UI)
hermes tools list # 显示所有工具及状态
hermes tools enable NAME # 启用工具集
hermes tools disable NAME # 禁用工具集

技能配置

hermes skills list # 列出已安装技能
hermes skills search QUERY # 搜索技能中心
hermes skills install ID # 安装技能
hermes skills inspect ID # 安装前预览
hermes skills config # 按平台启用/禁用技能
hermes skills check # 检查更新
hermes skills update # 更新过时技能
hermes skills uninstall N # 移除技能
hermes skills publish PATH # 发布到注册中心
hermes skills browse # 浏览所有可用技能
hermes skills tap add REPO # 添加 GitHub 仓库作为技能源

MCP 服务器配置

hermes mcp add NAME --url URL # 添加 MCP 服务器
hermes mcp add NAME --command CMD # 添加命令式 MCP 服务器
hermes mcp remove NAME # 移除 MCP 服务器
hermes mcp list # 列出配置的服务器
hermes mcp test NAME # 测试连接
hermes mcp configure NAME # 切换工具选择
hermes mcp serve # 将 Hermes 作为 MCP 服务器运行

网关/平台配置

hermes gateway setup # 配置平台
hermes gateway run # 前台启动网关
hermes gateway install # 安装为后台服务
hermes gateway start # 启动服务
hermes gateway stop # 停止服务
hermes gateway restart # 重启服务
hermes gateway status # 检查状态

会话管理

hermes sessions list # 列出最近会话
hermes sessions browse # 交互式选择器
hermes sessions export OUT # 导出为 JSONL
hermes sessions rename ID T # 重命名会话
hermes sessions delete ID # 删除会话
hermes sessions prune # 清理旧会话 (--older-than N 天)
hermes sessions stats # 会话存储统计

Cron 定时任务

hermes cron list # 列出任务 (--all 显示禁用的)
hermes cron create SCHED # 创建：'30m', 'every 2h', '0 9 * * *'
hermes cron edit ID # 编辑计划、提示、投递
hermes cron pause/resume ID # 控制任务状态
hermes cron run ID # 触发下次执行
hermes cron remove ID # 删除任务
hermes cron status # 调度器状态

Webhooks 配置

hermes webhook subscribe N # 创建路由 /webhooks/
hermes webhook list # 列出订阅
hermes webhook remove NAME # 移除订阅
hermes webhook test NAME # 发送测试 POST

Profiles 配置

hermes profile list # 列出所有配置文件
hermes profile create NAME # 创建 (--clone, --clone-all, --clone-from)
hermes profile use NAME # 设置粘性默认值
hermes profile delete NAME # 删除配置文件
hermes profile show NAME # 显示详情
hermes profile alias NAME # 管理包装脚本
hermes profile rename A B # 重命名配置文件
hermes profile export NAME # 导出为 tar.gz
hermes profile import FILE # 从归档导入

凭证池配置

hermes auth add # 交互式凭证向导
hermes auth list [PROVIDER] # 列出 pooled 凭证
hermes auth remove P INDEX # 按提供商 + 索引移除
hermes auth reset PROVIDER # 清除耗尽状态

其他命令

hermes insights [--days N] # 使用分析
hermes update # 更新到最新版本
hermes plugins list/install/remove # 插件管理
hermes honcho setup/status # Honcho 内存集成
hermes memory setup/status/off # 内存提供器配置
hermes completion bash|zsh # Shell 自动补全
hermes acp # ACP 服务器 (IDE 集成)
hermes uninstall # 卸载 Hermes

会话内斜杠命令(运行时配置)

/model [name] # 查看或更改模型
/provider # 显示提供商信息
/personality [name] # 设置个性
/reasoning [level] # 设置推理级别 (none|minimal|low|medium|high|xhigh|show|hide)
/verbose # 循环：off → new → all → verbose
/voice [on|off|tts] # 语音模式
/tools # 管理工具
/skills # 搜索/安装技能
/config # 显示配置
/yolo # 切换批准绕过
/skin [name] # 更改主题 (CLI)
/new 或 /reset # 新会话
/clear # 清屏 + 新会话
/quit 或 /exit 或 /q # 退出 CLI

配置文件位置

主配置： ~/.hermes/config.yaml
API 密钥： ~/.hermes/.env
技能目录： ~/.hermes/skills/
会话记录： ~/.hermes/sessions/
日志： ~/.hermes/logs/
OAuth 令牌： ~/.hermes/auth.json

常用提供商及环境变量

OpenRouter: OPENROUTER_API_KEY
Anthropic: ANTHROPIC_API_KEY
DeepSeek: DEEPSEEK_API_KEY
Google Gemini: GOOGLE_API_KEY 或 GEMINI_API_KEY
xAI/Grok: XAI_API_KEY
Hugging Face: HF_TOKEN
Alibaba: DASHSCOPE_API_KEY

LLM大模型

主要是修改配置文件config.yaml：

gedit ~/.hermes/config.yaml

如果要配置三方大模型，在文件末尾按照如下格式配置：

custom_providers:
- name: myllm-glm5
  base_url: https://abc.xyz.com/v1
  api_key: sk-your-key
  api_mode: chat_completions
  model: kimi-k2.5
- name: myllm-k2.5
  base_url: https://abc.xyz.com/v1
  api_key: sk-your-key
  api_mode: chat_completions
  model: kimi-k2.5

然后使用hermes model命令来选择配置的模型即可。

渠道

执行如下命令开启配置向导：

hermes gateway setup

飞书

  • 执行命令：hermes gateway setup 后进入配置向导；
  • 在应用列表中选择：Feishu / Lark。
  • 根据提示输入App ID 回车，根据提示输入App Secret（注意：这里默认不会显示你输入的文本内容，直接复制粘贴过来回车即可）。
  • 绑定hermes pairing approve feishu RUEMXXX

参考

文档信息

Search

    Table of Contents