Hermes_学习笔记
此文档来源于B站"编程不良人"博主的视频资料汇总，发布此平台的目的主要是为个人笔记所用。
1 windows安装
shell
# 了解自己的wsl
wsl --list --all
wsl
cat /etc/os-release | head -3
uname -a
# 如果是 docker-desktop 则建议安装单独的wsl环境，不要和 docker desktop 共用
wsl --install -d Ubuntu
# 少华说安装不了情况下，需要指定版本，安装不了的情况可以试试
wsl --install -d Ubuntu-22.04
# 设为默认 WSL 发行版（以后直接 wsl 进入）：
wsl --set-default Ubuntu
# windows环境终端开启代理
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1"
# 写入镜像网络配置，让wsl环境可以访问windows的代理
echo [wsl2]> %USERPROFILE%\.wslconfig
echo networkingMode=mirrored>> %USERPROFILE%\.wslconfig
# 重启 wsl 使其配置生效
wsl --shutdown
# 重新进入wsl
wsl
# 执行安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 根据提示配置提供商，message 可以参考飞书/微信接入方法
# 安装完成后退出快速配置后 hermes 命令不可用，需要加载环境变量，或者重新开一个窗口
source ~/.bashrc验证、更新hermes
shell
hermes version
# 更新命令后续可周期性执行更新，初次安装不需要做
hermes update消息网关 Gateway 概览
启动Gateway
shell
hermes gateway # 前台运行
hermes gateway --daemon # 后台守护进程运行2 配置向导
shell
hermes gateway setup查看各平台状态
shell
hermes gateway status3 接入飞书
3.1 自动配置飞书
官方适配，入门很快，建议使用
markdown
hermes setup gateway
# Feishu/Lark 空格选中 -> Scan QR code -> 打开链接登录自己的飞书小号 -> Use DM pairing approval (recommended) -> Disable group chats（个人电脑推荐禁止群聊）-> 回车 -> y > User service -> y
hermes gateway restart
# 在小号的飞书机器人进行对话，机器人收到消息后会要求在hermes命令行执行命令
hermes pairing approve feishu code命令行响应配置成功，此时就可以在飞书平台和机器人发起对话了，第一次对话机器人会要求 hermes 配置下密钥
hermes pairing approve feishu ***和飞书机器人对话，成功实现飞书接入 hermes
3.2 手动配置飞书
官方支持，自由度高，后续可以尝试
前往飞书开发者平台
https://open.feishu.cn/app?lang=zh-CN创建企业自建应用 -> 添加应用能力 -> 机器人 -> 左侧权限管理 -> 开通权限 -> 批量导入权限 -> 确认
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:read",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"event:ip_list",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}飞书开放平台：凭证与基础信息 -> 获取App ID 和 App Secret，前往openclaw绑定飞书
shell
hermes setup gateway
# Feishu/Lark 空格选中 -> Enter -> Enter existing App ID and App Secret manually -> 录入飞书的 App ID 和 App Secret -> websocket -> Use DM pairing approval (recommended) -> Disable group chats（个人电脑推荐禁止群聊）-> 回车 -> y > User service -> y
hermes gateway restart飞书开放平台： 事件与回调 -> 事件配置 -> 订阅方式 -> 长连接 -> 验证长连接成功 -> 保存
飞书开放平台：添加事件 -> im.chat(机器人进群、机器人退群) -> im.message(消息已读、消息撤回、接收消息) -> 版本管理与发布 -> 保存
飞书开放平台： 事件与回调 -> 回调配置-> 订阅方式 -> 长连接 -> 验证长连接成功 -> 保存
飞书开放平台：事件与回调 -> 回调配置 -> 卡片回传交互
此时就可以在飞书平台和机器人发起对话了，第一次对话机器人会要求 hermes 配置下密钥
hermes pairing approve feishu ***和飞书机器人对话，成功实现飞书接入 hermes
4 接入微信
4.1 在平台列表中选择 Wexin（微信），向导会：
1.QR生成二维码 --> 微信扫描登陆
2.自动保存 account_id 、token、base_url
3.询问访问权限控制策略
4.2 或者手动写入.env（建议用二维码）
# ~/.hermes/.env
WEIXIN_ACCOUNT_ID=your-account-id
# 可选: 限制可交互的用户
WEIXIN_DM_POLICY=open
WEIXIN_ALLOWED_USERS=user_id_1,user_id_2
# 可选: 设置默认推送通道 (用于定时任务通知)
WEIXIN_HOME_CHANNEL=chat_id
WEIXIN_HOME_CHANNEL_NAME=Home4.3 支持的消息类型
| 类型 | 支持情况 |
|---|---|
| 私聊文字 | ✅ |
| 群聊文字 | ✅ |
| 图片 | ✅ 自动下载解密 |
| 视频 | ✅ |
| 文件 | ✅ |
| 语音消息 | ✅ |
| 引用回复消息 | ✅ 自动提取上下文 |
微信原生不支持markdown，hermes会自动转换
启动并测试
shell
hermes gateway restart
# 在微信机器人中发送消息群聊配置（默认关闭）个人微信群聊默认禁用（防止被拉入大量群组响应），需手动开启(个人电脑不建议开启)
yaml
~/.hermes/config.yaml
platforms:
weixin:
enabled: true
group_policy: "open" # 开启群聊响应5 目录结构详解
官方文档: https://hermes-agent.nousresearch.com/docs/user-guide/configuration
5.1 完整目录结构
~/.hermes/
├── config.yaml # 存放所有非密钥的配置：模型、平台、代理、工具、安全策略、上下文压缩等。
├── .env # API 密钥和敏感信息
├── auth.json # OAuth provider credentials (Nous Portal, etc.)
├── SOUL.md # 主Agent人格设定，决定 Agent 的"身份"和"说话风格"，对所有项目生效。
├── memories/ # 持久化记忆 (MEMORY.md, USER.md)
├── skills/ # hermes 技能目录
├── cron/ # hermes 定时任务
├── sessions/ # 用来管理回话的目录
└── logs/ # 日志目录5.2 管理配置
shell
hermes config # 查看配置
hermes config edit # 打开配置
hermes config set KEY VAL # 设置一个指定的值
hermes config check # 检查配置
hermes config migrate # 交互式配置检查
# 列如:
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-... # Saves to .en5.3 核心文件分类详解
A. 用户编辑区
⚙️ config.yaml --- 主配置文件
存放所有非密钥的配置：模型、平台、代理、工具、安全策略、上下文压缩等。
典型结构：
yaml
# 模型配置
model:
provider: deepseek
default: deepseek-chat
....🔑 .env --- API 密钥和敏感信息
bash
# ~/.hermes/.env
# LLM 提供商（至少配一个）
OPENROUTER_API_KEY=sk-or-v1-xxx
DEEPSEEK_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-ant-xxx
KIMI_API_KEY=sk-xxx
# 工具增强
FIRECRAWL_API_KEY=fc-xxx # 网页搜索⚠️ 安全建议：
- 绝对不要 提交
.env到 Git - 在
.gitignore中添加.env和整个.hermes/目录 - 团队共享配置时，导出脱敏版本：
hermes dump --redact
🎭 SOUL.md --- 全局人格设定
Hermes 系统提示中的 第 #1 位置，决定 Agent 的"身份"和"说话风格"，对所有项目生效。
该写什么：
示例：
markdown
---
name: 严谨型架构师
version: 2.0
---
# 🧠 思考方式
- **回答前先验证**：不确定的 API、配置、路径，先用工具检查，不猜
- **执行前先规划**：3 步以上的任务，先列方案和风险，确认后再执行
- **交付带验证**：完成后主动说明如何确认效果
# 💬 沟通风格
- 简洁直接，不写"当然可以""好的"开场
- 中文回复，专业术语保留英文
- 代码示例优先，长篇解释往后放实战技巧：
-
先用 Hermes 聊两天日常，再让它："根据你了解的我，帮我生成一份 SOUL.md"
-
SOUL.md 不存在时 Hermes 会自动种子一份，可以直接编辑
-
临时改风格用
/personality codereviewer，不需要改 SOUL.md (内置N多种风格选择)markdown• none：无人格（默认普通模式） • helpful：有帮助、友好的助手 • concise：简洁风格（少废话） • technical：技术专家（更专业、更细节） • creative：更有创意、发散思维 • teacher：老师风格（耐心讲解） • kawaii：可爱风（偏二次元萌系说话） • catgirl：猫娘风格（更强的二次元角色扮演） • pirate：海盗风（说话像加勒比海盗那种 😄） • shakespeare：莎士比亚风格（古英语、文学感） • surfer：冲浪少年风（很随意、很chill） • noir：黑色电影风（偏侦探、阴暗叙述）
B. Agent 自动维护区（你只需查看，不要随意改）
🧠 memories /MEMORY.md --- 项目记忆
bash
cat ~/.hermes/memories/MEMORY.md- 容量上限：~2,200 字符（强制约束，迫使 Agent 只存最重要的）
- 存什么： 项目细节、踩过的坑、技术栈选择、完成的工作
- 谁维护： Agent 自动判断什么值得记，会话中你也可以强化："记住这个：XXX"
实战建议：
- 不要直接编辑（Agent 下次会按它的逻辑覆盖）
- 如果发现 Agent "记错了"，对话中明确纠正："忘掉之前说的 X，应该是 Y"
- 长期使用建议每月翻一次，删掉过时项目的记忆
🧠 memories /USER.md --- 用户画像
bash
cat ~/.hermes/memories/USER.md- 容量上限：~1,375 字符
- 存什么： 你的角色、技术栈、沟通偏好、工作时间习惯
- 特别价值： 跨所有项目共享，新项目立刻"懂你"
实战建议：
- 第一周让 Agent 多观察你的工作模式，USER.md 会自动越来越准
- 角色变化时（比如换工作）主动告诉它："我现在主要做 X，不再做 Y 了"
🗄️ state.db --- SQLite 状态数据库
存所有会话历史，FTS5 全文检索，按需检索，几个月对话也不会卡。
数据库结构（懂 SQL 的可以直接查）：
messages # 所有消息记录
messages_fts # FTS5 虚拟表（核心！）
sessions # 会话元数据
schema_version # 数据库版本⚠️ 配置建议：
- 不要手动改 state.db
- 备份必须包含此文件，否则历史全失
- 单机用户长期使用文件可能到 GB 级，定期
hermes sessions archive --before "2026-01-01"
C. Skills 详解（核心目录）
📚 skills/ 目录结构
~/.hermes/skills/ # 单一事实来源
│
├── bundled/ # 内置 40+ 技能（安装时种子）
│ ├── plan/ # /plan 命令（生成实施计划不执行）
│ ├── git-pr-workflow/ # GitHub PR 完整流程
│ ├── duckduckgo-search/ # 后备搜索（无 Firecrawl 时）
│ ├── openclaw-migration/ # 从 OpenClaw 一键迁移
│ ├── excalidraw/ # 画图技能
│ ├── gif-search/ # GIF 搜索
│ └── axolotl/ # 模型微调
│
├── .hub/ # Skills Hub 状态
│ ├── lock.json # 已安装技能版本锁定
│ ├── quarantine/ # 安全扫描隔离区
│ └── audit.log # 安装审计日志
│
└── .bundled_manifest # 跟踪内置技能（更新时检测）Skills 管理命令
bash
# 查看
hermes skills list # 列出所有已装技能
/skills # 对话内查看
/insights --days 7 # 看 Agent 过去 7 天学了什么
# 安装
hermes skills install official/security/1password
hermes skills install openai/skills/k8s
# 检查更新
hermes skills check # 哪些技能上游有更新
hermes skills update # 一键更新所有
# 安全
hermes skills inspect <name> # 查看安全扫描结果⚠️ 重点配置建议：
- 任何 Hub 安装都会自动安全扫描（数据外泄、注入、危险命令、供应链威胁）
- 检测到危险默认拒绝安装，除非加
--force - 用一段时间后建议
ls ~/.hermes/skills/翻一遍，删掉过时或冲突的技能 - 两个 Skill 触发条件重叠会冲突，Agent 行为反常时先排查这里
🛡️ Skills 安全扫描机制 （Hub 安装时自动）
| 检查项 | 限制 | 触发后果 |
|---|---|---|
| 文件总数 | ≤ 50 个 | 拒绝安装 |
| 总大小 | ≤ 1 MB | 拒绝安装 |
| 单文件大小 | ≤ 256 KB | 拒绝安装 |
| 二进制扩展名 | 拒绝 .exe / .dll / .so 等 |
拒绝安装 |
| 符号链接 | 不允许指向技能目录外 | 拒绝安装 |
| 内容扫描 | 检测 prompt 注入、密钥外泄模式 | 拒绝或隔离 |
来源说明： 安全扫描由
skills_guard.py实现，所有从 GitHub / Hub 安装的技能都会经过这一层，自己手写或 Agent 自动生成的技能不会触发扫描。
D. 运行时数据区
⏰ cron/ --- 定时任务
~/.hermes/cron/
└── jobs/
├── 61a5eb0baeb9.json # 每个任务一个 JSON
└── ...实战命令：
bash
hermes cron list # 列出所有任务
hermes cron remove <id> # 删除
/cron list # 对话内查看💬 sessions/ --- 消息平台会话
每个平台的会话状态独立存储：
~/.hermes/sessions/
├── telegram/
├── discord/
├── feishu/
└── wechat/实战建议： 接入新平台前先备份此目录，配错了可以恢复
📋 logs/ --- 日志目录
bash
# 实时看错误
tail -f ~/.hermes/logs/errors.log
# 看主日志
tail -f ~/.hermes/logs/agent.log
# 看网关日志（消息平台问题排查）
tail -f ~/.hermes/logs/gateway.log
# CLI 命令
hermes logs --tail 50 # 最近 50 条
hermes logs --component gateway # 按组件过滤安全特性： 日志中的密钥自动脱敏 （API Key、Token 等会被替换为 ***）
🔐 auth.json --- OAuth 凭证
| 作用 | Nous Portal、GitHub Copilot、Codex、Anthropic OAuth 等 Token |
| 谁维护 | Hermes 自动管理，不要手改 |
| 管理命令 | hermes auth 系列 |
bash
hermes auth login nous-portal # 登录 Nous Portal
hermes auth login github-copilot # 登录 Copilot
hermes auth list # 查看已登录提供方
hermes auth logout # 全部登出
hermes auth refresh # 手动刷新 Token配置建议：
- 安全级别等同
.env，备份时同样要小心 - Token 过期时 Hermes 自动刷新，不需要手动操作
- 多 Profile 用户每个 Profile 有独立的 auth.json
5.4 三种"知识"的边界
Hermes 同时有三个持久化系统，新手最容易混淆。官方明确分工：
| 作用 | 回答 | 谁维护 | |
|---|---|---|---|
| Memory | 存事实、偏好、环境信息 | "是什么" | Agent 自动 |
| Skill | 存可复用的执行流程 | "怎么做" | Agent 自动 + 用户手写 |
| Session | 存对话历史，全文检索 | "说过什么" | Agent 自动 |
何时存什么：
✅ 存到 Memory：用户偏好、环境配置、踩过的坑、完成的工作
✅ 存到 Skill：解决问题的新方法、可复用工作流、调试套路
❌ 不存：单次任务的临时上下文、可以从代码查到的信息、大段数据 dump6 核心功能演示
6.1 本地 Web Dashboard ⭐
是什么： v0.9.0 新增，Hermes 第一次提供浏览器管理面板，不用碰命令行
演示步骤：
- 启动
hermes，注意终端输出的本地端口地址 - 打开浏览器，访问
http://localhost:端口 - 展示会话列表 → 历史所有对话都在这里
- 展示 Skills 管理 → 自动生成的技能可以看到、编辑
- 展示网关状态 → 各平台接入状态一目了然
- 展示配置面板 → 可视化修改配置，不用手动编辑 YAML
6.2 Fast Mode
bash
# 对话中输入
/fast # 开启 → 走 OpenAI / Anthropic 优先队列，低延迟
/fast # 再次输入 → 关闭适用条件： OpenAI 或 Anthropic 用户 + 高峰期等待时间长
不适用： 国产模型（DeepSeek / Kimi / GLM 等）暂不支持
6.3 备份与恢复
bash
# 备份（把 Hermes 的所有状态打包）
hermes backup
# 备份内容：配置 + 会话记录 + Skills + 记忆 + 凭证（可选）
# 恢复（在新机器上一条命令还原）
hermes import典型使用场景：
- 换新电脑 / 换服务器
- 升级前做快照，出问题可以回滚
- 团队共享基础配置（导出后去掉密钥再分发）
7 TUI
7.1 对话过程中的核心差异
| 对比项 | hermes Classic CLI | hermes --tui |
|---|---|---|
| 输入框 | 随输出内容往上推，打字时容易丢失位置 | 粘性固定在底部，不会被输出冲走 |
| 状态栏 | 基础信息 | git 分支 + 每轮耗时秒表（实时显示） |
| bash 命令补全 | 内联下拉 | 浮动面板，带描述文字 |
| 子 Agent 可观测 | ❌ 看不到后台 spawn 了什么 | ✅ 专门面板显示所有子 Agent 状态 |
| 鼠标选择文字 | ❌ | ✅ |
| 图片粘贴 | ❌ | ✅ Cmd+V 直接识别为附件 |
| 主题适配 | 固定样式 | 自动检测终端背景，浅/深色自适应 |
7.2 使用建议
- 本地日常开发 →
hermes --tui，输入框不乱跑、子 Agent 可观测 - SSH 远程服务器 / 脚本自动化 →
hermes，轻量、兼容性好
7.3 TUI 实用快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+G |
将输入内容发送到 $EDITOR 编辑，保存后自动发送（长 prompt 必备） |
Ctrl+C |
中断当前 Agent 执行 |
7.4 续接历史 Session
bash
hermes --tui -c # 续接最近一次 session
hermes --tui -r <id> # 指定 session ID 续接8 多Agent开发
子 Agent 嵌套与并发
子 Agent 现在可以继续生成下级 Agent，形成多层协作结构。
开启嵌套深度
bash
hermes config set agent.max_spawn_depth 3默认是 flat（不嵌套），设置为 3 即允许最多 3 层。
输入一句话触发，启动 hermes --tui，直接在输入框里打：
同时搜索 Hermes Agent、Claude Code、Cursor 三个工具最近一个月的更新动态，每个工具各写一份摘要文件，最后汇总成一份对比报告 comparison.md9 Curator
Autonomous Curator：Agent 自动维护自身的 Skill 库。
9.1 Curator 是什么
随着使用时间增长，Hermes 会自动积累大量 Agent 自建的 Skill 文件。Curator 作为后台辅助 Agent，定期对 Skill 库执行以下操作：
- 评分 --- 基于使用频率和质量 rubric 给每个 Skill 打分
- 整合 --- 将功能重叠的 Skill 合并，去除冗余
- 归档 --- 将长期未使用的 Skill 归档（不是删除，可以恢复）
- 报告 --- 将运行结果写入
REPORT.md
⚠️ 两个重要事实：
- 官方内置 Skill 和从 Hub 安装的 Skill 永远不会被 Curator 触碰
- Curator 不会直接删除任何 Skill，只会归档，且支持随时恢复
默认每 7 天自动运行一次，也可手动触发。
7.2 完整命令速查
bash
hermes curator status # 查看 Curator 当前状态和 Skill 统计
hermes curator run # 立即触发一次审查（手动触发）
hermes curator pause # 暂停自动运行
hermes curator resume # 恢复自动运行查看当前状态
hermes curator status输出示例
Curator status: active
Next run: in 3 days
Skills: 42 agent-created / 30 bundled (not managed)
Archived: 5 skills
Last run: 2026-04-29 consolidated 2, archived 1手动触发审查
shell
hermes curator run终端实时输出进度，运行完毕后查看报告：
shell
cat ~/.hermes/logs/curator/REPORT.md保护重要 Skill（防止被归档）
shell
hermes curator pin my-custom-skill恢复被归档的 Skill
hermes curator restore old-deploy-v1出问题了？一键回滚
hermes curator rollback # 恢复到最近一次 Curator 运行前的快照| 场景 | 命令 |
|---|---|
| 某个 Skill 很重要，不想被自动归档 | hermes curator pin <name> |
| 暂时不想让 Curator 自动跑 | hermes curator pause |
| Skill 被归档了想找回来 | hermes curator restore <name> |
| 整个 Skill 库状态不对，想回滚 | hermes curator rollback |
10 常用命令
── 编辑 ──
hermes setup --- 重新运行完整向导
hermes setup model --- 更改模型/提供商
hermes setup terminal --- 更改终端后端
hermes setup gateway --- 配置消息网关
hermes setup tools --- 配置工具提供商
hermes config --- 查看当前设置
hermes config edit --- 在编辑器中打开配置
hermes config set <键> <值> --- 设置特定值
── 或者编辑文件 ──
vi /Users/jiayuchao/.hermes/config.yaml
vi /Users/jiayuchao/.hermes/.env
── 启动命令 ──
hermes 开始聊天
hermes gateway 启动消息网关
hermes doctor 检查问题
── 会话 ──
/new 开始新会话（新的会话ID和历史记录）
/reset 开始新会话（/new 的别名）
/clear 清屏并开始新会话
/redraw 强制刷新界面（修复终端显示错乱）
/history 显示对话历史
/save 保存当前对话
/retry 重新发送上一条消息
/undo 撤销最后一轮对话
/title 设置当前会话标题（用法：/title [名称]）
/handoff 将会话移交到消息平台（Telegram、Discord 等）
/branch 分叉当前会话（探索不同路径）
/fork 分叉当前会话（/branch 的别名）
/compress 手动压缩对话上下文（用法：/compress [聚焦主题]）
/rollback 列出或恢复文件系统检查点
/snapshot 创建或恢复 Hermes 配置/状态快照
/snap 创建或恢复状态快照（/snapshot 别名）
/stop 终止所有运行中的后台进程
/background 在后台运行一个提示词
/bg 后台运行（/background 别名）
/btw 后台运行（/background 别名）
/agents 显示活跃的代理和运行中的任务
/tasks 显示活跃代理和任务（/agents 别名）
/queue 排队一个提示词等待下一轮执行
/q 排队提示词（/queue 别名）
/steer 在下一次工具调用后注入消息但不打断
/goal 设置持续性目标，跨回合执行直到完成
/subgoal 为当前目标添加或管理子标准
/status 显示会话信息
/resume 恢复之前命名的会话（用法：/resume [名称]）
/sessions 浏览并恢复之前的会话
── 工具 & 技能 ──
/tools 管理工具：启用/禁用/列出
/toolsets 列出可用工具集
/skills 搜索、安装、查看或管理技能
/cron 管理定时任务
/curator 后台技能维护（状态、运行、固定、归档）
/kanban 多配置文件协作看板
/reload 重新加载 .env 环境变量到当前会话
/reload-mcp 从配置重新加载 MCP 服务器
/reload-skills 重新扫描技能目录
/browser 通过 CDP 连接浏览器工具到实时 Chrome
/plugins 列出已安装插件及其状态
── 退出 ──
/quit 退出 CLI
/exit 退出 CLI（/quit 别名）
── 信息 ──
/whoami 显示你的斜杠命令权限（admin / user）
/profile 显示当前配置文件名称和主目录
/gquota 显示 Google Gemini Code Assist 配额用量
/help 显示可用命令
/usage 显示当前会话的 token 用量和速率限制
/insights 显示使用统计和分析
/platforms 显示网关/消息平台状态
/gateway 显示网关/消息平台状态（/platforms 别名）
/copy 复制最后一条助手回复到剪贴板
/paste 从剪贴板粘贴图片
/image 为下一条提示附加本地图片文件
/debug 上传调试报告并获取分享链接
── 配置 ──
/config 显示当前配置
/model 切换当前会话的模型
/provider 切换模型（/model 别名）
/codex-runtime 切换 Codex 应用服务端运行时
/personality 设置预定义的性格
/statusbar 切换上下文/模型状态栏
/sb 切换状态栏（/statusbar 别名）
/verbose 循环切换工具进度显示：关闭→新→全部→详细
/footer 切换网关运行时元数据页脚
/yolo 切换 YOLO 模式（跳过所有危险命令确认）
/reasoning 管理推理深度和显示
/skin 显示或更换界面皮肤/主题
/indicator 选择 TUI 忙碌指示器样式
/voice 切换语音模式
/busy 控制 Hermes 忙碌时回车键的行为
提示：
直接输入消息即可与 Hermes 对话
多行输入：Alt+Enter 换行
草稿编辑器：Ctrl+G（VSCode/Cursor 中为 Alt+G）
粘贴图片：Alt+V（或 /paste）11 Profile 项目隔离的基础
Hermes 用 Profile 隔离不同项目，每个 Profile 拥有独立的：
- 记忆（Memory）
- Skill 库
- 工作目录（
terminal.cwd） - Gateway 配置（Bot Token）
markdown
# 1. 新建空白 profile（最常用）
hermes profile create <名字>
# 示例
hermes profile create eap
hermes profile create knows
hermes profile create os
# 2. 克隆当前 profile（仅配置、.env、SOUL.md）
hermes profile create work --clone
# 3. 完全克隆（配置+记忆+会话+技能全复制）
hermes profile create backup --clone-all
# 4. 从指定已有 profile 克隆
hermes profile create dev --clone-from coder
# 5. 不生成快捷命令（仅创建目录）
hermes profile create test --no-alias
# 查看所有 profile
hermes profile list
# 设为默认 profile
hermes profile use coder
# 用指定 profile 启动聊天
hermes -p coder chat
# 或直接用别名（自动生成）
coder chat11.1 实际应用
markdown
# 系统助手 macOS
# 系统操作、日常运维、知识问答、生活助理、文档整理、思路梳理
hermes profile create os-helper --clone-all
Next steps:
os-helper setup Configure API keys and model
os-helper chat Start chatting
os-helper gateway start Start the messaging gateway
os-helper setup
hermes -p os-helper pairing approve feishu QX2Z2QJK
# 只对接 漏扫 飞书机器人、项目代码、业务逻辑、项目专属配置 / 脚本
hermes profile create vulscan --clone-all
Next steps:
vulscan setup Configure API keys and model
vulscan chat Start chatting
vulscan gateway start Start the messaging gateway
vulscan setup
vulscan pairing approve feishu code
# 只对接 EAP 飞书机器人、项目代码、业务逻辑、项目专属配置 / 脚本
hermes profile create eap
Next steps:
eap setup Configure API keys and model
eap chat Start chatting
eap gateway start Start the messaging gateway
eap setup
eap pairing approve feishu code
# 排查客户问题的机器人12 常用 skill
12.1 /plan 先规划,再执行
适用场景:任务复杂、影响范围不明确时,先让Agent输出执行计划,确认后再动手
计划文档自动保存至.hermes/plans/目录
12.2 /excalidraw 自然语言生成架构
适用场景:技术分享、写文档时需要快速生成系统架构图、流程图图、时序图