okooooooo/tweet-skills
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: move non-tweet docs to skill-guide repo

Browse Source
This commit is contained in:
Chen Ke committed 2026-04-12 11:30:10 +08:00
1 parent 2d1bc98d26
commit 3e04b66ec8
3 files changed
-1187
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/cmux-installation-guide.md
-415
View File
@@ -1,415 +0,0 @@
# cmux 安装与使用指南
> 基于 Ghostty 的 macOS 终端，专为 AI 编程 Agent 设计
> GitHub: https://github.com/manaflow-ai/cmux
> ⭐ 13,600+ Stars | 语言: Swift | 仅 macOS
---
## 目录
1. [cmux 是什么](#cmux-是什么)
2. [核心功能](#核心功能)
3. [安装](#安装)
4. [首次配置](#首次配置)
5. [基础使用](#基础使用)
6. [AI Agent 工作流](#ai-agent-工作流)
7. [内置浏览器](#内置浏览器)
8. [SSH 远程开发](#ssh-远程开发)
9. [快捷键速查](#快捷键速查)
10. [自定义配置](#自定义配置)
11. [常见问题](#常见问题)
---
## cmux 是什么
cmux 是一个**专为 AI 编程 Agent 打造的 macOS 原生终端**。
它基于 Ghostty（当前最快的终端模拟器之一）构建，增加了：
- 📌 **垂直标签页 + 通知系统** — 当 Claude Code、Codex、OpenCode 等 Agent 需要你注意时，窗格自动亮蓝环
- 🌐 **内置浏览器** — 在终端旁分割出浏览器，Agent 可以直接操作
- 👥 **Claude Code Teams 支持** — 一条命令启动多 Agent 协作
- 🔌 **可脚本化** — CLI + Socket API，可以自动化一切
简单说：**tmux + 浏览器 + Agent 通知，原生 macOS 应用，不用 Electron**。
---
## 核心功能
### 1. 通知提示环
当 AI Agent 需要你注意时：
- 窗格边框出现**蓝色光环**
- 侧边栏标签**高亮提示**
- 一键跳转到最新未读通知（⌘⇧U）
### 2. 通知面板
所有 Agent 的通知集中展示，不用一个个翻标签。
### 3. 侧边栏垂直标签
每个标签显示：
- Git 分支名
- 关联的 PR 状态和编号
- 工作目录
- 监听端口
- 最新通知文本
### 4. 内置浏览器
- 从 Chrome、Firefox、Arc 等 20+ 浏览器导入 Cookie
- 浏览器窗格可以和终端并排
- Agent 可通过 API 操控浏览器（截图、点击、填表、执行 JS）
### 5. SSH 远程开发
```bash
cmux ssh user@remote
```
- 自动创建远程工作区
- 浏览器通过远程网络路由（localhost 直接可用）
- 拖拽图片到远程会话自动 scp 上传
### 6. Claude Code Teams
```bash
cmux claude-teams
```
一条命令启动 Claude Code 队友模式，多个 Agent 以原生分割窗格运行。
---
## 安装
### 方式一：DMG（推荐）
1. 下载最新版本：
https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg
2. 打开 DMG，将 cmux 拖到「应用程序」文件夹
3. 首次启动时，macOS 会提示确认打开。点击**打开**
4. cmux 内置自动更新（Sparkle），只需下载一次
### 方式二：Homebrew
```bash
# 添加 tap
brew tap manaflow-ai/cmux
# 安装
brew install --cask cmux
# 后续更新
brew upgrade --cask cmux
```
### 系统要求
- macOS（仅支持 Mac）
- 不支持 Windows / Linux
---
## 首次配置
### 1. Ghostty 配置兼容
cmux **自动读取**你现有的 Ghostty 配置：
```
~/.config/ghostty/config
```
如果你已经配置过 Ghostty 的主题、字体、颜色，cmux 会直接继承。
### 2. 浏览器数据导入
首次使用内置浏览器时，可以导入：
- Cookie
- 浏览历史
- 登录会话
支持从 Chrome、Firefox、Arc、Safari 等 20+ 浏览器导入。
这样浏览器窗格启动时就已经是登录状态。
### 3. 自定义命令
在项目根目录创建 `cmux.json`：
```json
{
"commands": [
{
"name": "Start Dev Server",
"action": "npm run dev"
},
{
"name": "Run Tests",
"action": "npm test"
},
{
"name": "Open Claude Code",
"action": "claude"
}
]
}
```
通过命令面板（⌘⇧P）快速执行。
---
## 基础使用
### 创建工作区
```
⌘ N 新建工作区
⌘ 1-8 跳转到工作区 1-8
⌘ 9 跳转到最后一个工作区
⌃⌘ ] 下一个工作区
⌃⌘ [ 上一个工作区
⌘⇧ W 关闭工作区
⌘⇧ R 重命名工作区
⌘ B 切换侧边栏显示
```
### 管理标签页
```
⌘ T 新建标签页
⌘⇧ ] 下一个标签页
⌘⇧ [ 上一个标签页
⌃ Tab 下一个标签页
⌃⇧ Tab 上一个标签页
⌃ 1-8 跳转到标签页 1-8
⌘ W 关闭标签页
```
### 分割窗格
```
⌘ D 右侧分割
⌘⇧ D 下方分割
⌥⌘ ←→↑↓ 方向切换窗格焦点
⌘⇧ H 闪烁当前窗格（高亮定位）
```
---
## AI Agent 工作流
### 场景一：运行 Claude Code
```bash
# 在新分割窗格中启动 Claude Code
claude
```
当 Claude Code 需要你输入时：
1. 该窗格自动出现**蓝色光环**
2. 侧边栏标签**高亮**
3. 按 `⌘⇧ U` 跳转到最新未读
### 场景二：运行多个 Codex 会话
```bash
# 左侧窗格
codex --task "实现用户登录功能"
# 右侧分割（⌘ D）
codex --task "编写单元测试"
```
两个 Agent 并行运行，通知系统帮你追踪哪个需要回应。
### 场景三：Claude Code Teams
```bash
cmux claude-teams
```
自动启动 Claude Code 队友模式：
- 每个 Agent 作为原生分割窗格运行
- 侧边栏显示每个 Agent 的元数据和状态
- 无需 tmux
### 自定义 Agent 通知
通过 CLI 发送通知：
```bash
# 发送通知（可写入 Agent hooks）
cmux notify "构建完成，3个测试失败"
# 查看 Agent hooks 配置
# 在 Claude Code 的 settings.json 中配置
```
---
## 内置浏览器
### 打开浏览器
```
⌘⇧ L 在分割窗格中打开浏览器
⌘ L 聚焦地址栏
⌘ [ 后退
⌘ ] 前进
⌘ R 刷新
⌥⌘ I 开发者工具
⌥⌘ C JavaScript 控制台
```
### 可脚本化 API
浏览器窗格支持来自 agent-browser 的 API：
- 截取无障碍树快照
- 获取元素引用
- 点击元素
- 填写表单
- 执行 JavaScript
这意味着 Agent 可以直接在浏览器中交互，不需要外部工具。
---
## SSH 远程开发
### 基本用法
```bash
cmux ssh user@your-server
```
自动创建远程工作区，浏览器窗格通过远程网络路由。
### 拖拽上传
直接将文件/图片拖入远程会话窗口，自动通过 scp 上传。
### localhost 直接可用
因为浏览器通过远程网络路由，所以远程服务器上的 localhost:3000 可以直接在浏览器窗格中访问。
---
## 快捷键速查
| 功能 | 快捷键 |
|------|--------|
| 新建工作区 | ⌘ N |
| 切换侧边栏 | ⌘ B |
| 新建标签页 | ⌘ T |
| 右侧分割 | ⌘ D |
| 下方分割 | ⌘⇧ D |
| 方向切换窗格 | ⌥⌘ ←→↑↓ |
| 打开浏览器 | ⌘⇧ L |
| 显示通知面板 | ⌘ I |
| 跳转最新未读 | ⌘⇧ U |
| 关闭标签页 | ⌘ W |
| 关闭工作区 | ⌘⇧ W |
---
## 自定义配置
### cmux.json（项目级配置）
在项目根目录创建 `cmux.json`：
```json
{
"commands": [
{
"name": "Start Dev",
"action": "npm run dev"
},
{
"name": "Run Agent",
"action": "claude --task '$(pbpaste)'"
}
]
}
```
通过命令面板（⌘⇧P）执行。
### Ghostty 配置继承
cmux 读取 `~/.config/ghostty/config`：
```
# 示例 Ghostty 配置
theme = catppuccin-mocha
font-size = 14
font-family = JetBrains Mono
background-opacity = 0.95
```
cmux 会自动应用这些设置。
### CLI + Socket API
```bash
# 创建工作区
cmux workspace create "My Project"
# 分割窗格
cmux split --right
# 发送按键
cmux send-keys "claude" Enter
# 打开 URL
cmux browser open http://localhost:3000
# 发送通知
cmux notify "任务完成"
```
---
## 常见问题
### Q: cmux 支持 Windows/Linux 吗？
**不支持。** cmux 是原生 macOS 应用（Swift/AppKit），目前只有 Mac 版本。
### Q: 需要先安装 Ghostty 吗？
**不需要。** cmux 内置了 libghostty，独立运行。但如果你有 Ghostty 配置文件，cmux 会自动读取。
### Q: 和 tmux 有什么区别？
cmux 不需要 tmux。它提供了原生 GUI 的标签页、分割、通知等功能，性能更好，体验更接近原生 macOS 应用。
### Q: 支持哪些 AI Agent？
- Claude Code ✅（深度集成，支持 Teams 模式）
- Codex ✅
- OpenCode ✅
- Gemini CLI ✅
- AMP ✅
- 任何终端中运行的 AI Agent ✅
### Q: 浏览器数据安全吗？
浏览器数据（Cookie、历史记录）只存储在本地，不会发送到任何服务器。
### Q: 如何更新？
DMG 安装的用户通过 Sparkle 自动更新。Homebrew 用户运行 `brew upgrade --cask cmux`。
---
## 参考链接
- 🏠 官网：https://cmux.com
- 📖 文档：https://cmux.com/docs/getting-started
- 💻 GitHub：https://github.com/manaflow-ai/cmux
- 🐦 Twitter：https://x.com/manaflowai
- 💬 Discord：https://discord.gg/xsgFEVrWCZ
- 🎬 演示视频：https://www.youtube.com/watch?v=i-WxO5YUTOs
---
*基于 2026-04-12 公开信息整理，cmux 当前版本 13,600+ Stars*
docs/hermes-agent-advanced-guide.md
-488
View File
@@ -1,488 +0,0 @@
# Hermes Agent 高级玩法完全指南
> 整理自官方文档、爱范儿、ByteIota、DEV Community、知乎等来源
> 更新日期：2026-04-11
---
## 目录
1. [Hermes Agent 是什么](#1-hermes-agent-是什么)
2. [核心架构：学习循环](#2-核心架构学习循环)
3. [四层记忆系统](#3-四层记忆系统)
4. [技能系统深度解析](#4-技能系统深度解析)
5. [多模型编排](#5-多模型编排)
6. [多平台网关](#6-多平台网关)
7. [安全与生产就绪](#7-安全与生产就绪)
8. [高级配置](#8-高级配置)
9. [从 OpenClaw 迁移](#9-从-openclaw-迁移)
10. [高级使用场景](#10-高级使用场景)
11. [与 OpenClaw 对比](#11-与-openclaw-对比)
12. [参考资源](#12-参考资源)
---
## 1. Hermes Agent 是什么
Hermes Agent 是 **Nous Research** 团队开发的开源 AI Agent 框架（MIT 协议），GitHub 星标已超过 **5.5 万**。
与普通聊天机器人不同，它的核心理念是 **"the agent that grows with you"**——一个会随着使用不断进化的 Agent。
**关键特性：**
- 内置闭环学习系统（Learning Loop）
- 跨会话持久记忆
- 自动技能创建与改进
- 47+ 内置工具
- 15+ 消息平台支持
- 6 种终端后端（本地、Docker、SSH、Daytona、Singularity、Modal）
- 支持 200+ 模型（通过 OpenRouter）
- MCP 协议支持
**安装：**
```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
**配置模型：**
```bash
hermes model # 交互式选择模型提供商
hermes # 启动终端 UI
```
---
## 2. 核心架构：学习循环
这是 Hermes 区别于所有其他 Agent 框架的核心能力。
### 学习循环的四个阶段
```
Observe（观察） → Plan（规划） → Act（执行） → Learn（学习）
```
### 自动技能创建触发条件
每次任务完成后，Hermes 自动检查是否值得记录。触发条件：
- 工具调用超过 **5 次**
- 中途出错后**自我修复**了
- 用户做了**纠正**
- 走了一条**不明显但有效**的路径
满足任意一条，就会在 `~/.hermes/skills/` 目录下自动生成一个 Skill 文件。
### 技能自我改进
技能文件不是一次写死。后续使用中发现更好路径时，Hermes 会用 **patch（补丁）** 方式修改：
- 只传入旧字符串和替换内容，不整体重写
- 全量覆写容易破坏已有的好部分
- patch 更安全，token 消耗也更少
### 周期性微调（Periodic Nudge）
在没有用户输入的情况下，系统定期自动向 Agent 发一条内部提示，要求回顾最近操作，判断哪些值得写入记忆。**完全无需用户触发**，Agent 自己决定保留什么。
---
## 3. 四层记忆系统
Hermes 的记忆不是简单的文件读写，而是精心设计的四层架构。
### 第一层：常驻提示记忆
- **MEMORY.md**（2,200 字符上限）— 环境信息、约定、经验教训
- **USER.md**（1,375 字符上限）— 用户偏好、沟通风格
- 总字符上限 3,575，**故意收窄**，强迫筛选
- 每次会话自动注入系统提示
### 第二层：会话归档
- 所有对话写入 **SQLite 数据库**（WAL + FTS5 全文索引）
- 需要历史上下文时主动发起查询
- 检索结果经 **LLM 摘要**，只注入与当前任务相关的部分
- 搜索延迟约 **10ms**，支持 10,000+ 技能检索
### 第三层：技能文件
- 学习循环的产出，存储在 `~/.hermes/skills/`
- 默认只加载名称和描述（约 3,000 tokens）
- 按需调入完整内容
- **技能库从 40 增长到 200，上下文成本几乎不变**
### 第四层：Honcho 用户建模
- 可选的跨会话用户画像层
- 被动积累偏好、沟通风格、领域知识
- 适合长期使用的个人助理场景
### 可插拔记忆后端（v0.7.0+）
```yaml
# config.yaml
memory:
provider: honcho # 或 sqlite、vector、custom
honcho:
api_key: ${HONCHO_API_KEY}
profile_scope: true
sqlite:
db_path: ~/.hermes/memory.db
fts5_enabled: true
```
---
## 4. 技能系统深度解析
### 渐进式加载（Progressive Disclosure）
| 层级 | 内容 | Token 开销 |
|------|------|-----------|
| Level 0 | 技能名称 + 简短描述列表 | ~3,000 tokens |
| Level 1 | 加载某个技能的完整 SKILL.md | 按需 |
| Level 2 | 加载技能内的特定参考文件 | 按需 |
### 技能文件结构
```
~/.hermes/skills/my-skill/
├── SKILL.md # 主文件（YAML 前置 + Markdown）
├── references/ # 参考文件
├── templates/ # 模板
└── scripts/ # 脚本
```
### 技能格式（agentskills.io 开放标准）
```markdown
---
name: my-skill
description: 简短描述
triggers:
- "触发词1"
- "触发词2"
---
# 技能标题
## 步骤
1. ...
2. ...
## 注意事项
- ...
## 验证
- ...
```
### 技能获取方式
1. **自动生成** — 学习循环自动创建
2. **手写** — 按格式自己编写
3. **Skills Hub 安装** — 社区共享平台
4. **团队共享** — 通过外部技能目录
### 内置技能类别（20+）
Karpathy 的 LLM Wiki 笔记大法已被加入内置技能。
---
## 5. 多模型编排
### 主模型 + 辅助模型
Hermes 的 Auxiliary Models 模块自动将不同任务分配给不同模型：
| 任务类型 | 默认模型 |
|----------|---------|
| 主对话 | 用户选择的主模型 |
| 图像分析 | Gemini Flash |
| 网页提取 | Gemini Flash |
| Skill 匹配 | Gemini Flash |
| 记忆处理 | Gemini Flash |
### 模型切换
```bash
hermes model # 一键切换，无需改代码
```
支持的模型提供商：
- **Nous Portal** — 订阅制，零配置
- **Anthropic** — Claude（API key 或 Claude Code 授权）
- **OpenRouter** — 200+ 模型路由
- **OpenAI** — Codex 模型
- **DeepSeek**
- **阿里云 DashScope**（Qwen 系列）
- **小米 MiMo-V2** — 限免至 2026-04-22
- **Hugging Face**
- **GitHub Copilot**
- **自定义端点** — Ollama、vLLM、SGLang 等
### 凭证轮换
```yaml
providers:
openai:
credentials:
- api_key: ${OPENAI_KEY_1}
- api_key: ${OPENAI_KEY_2}
rotation: least_used # 自动故障转移
```
---
## 6. 多平台网关
### 支持平台（15+）
Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost、Email、SMS、钉钉、飞书、企业微信、BlueBubbles、Home Assistant、CLI
### 网关配置
```bash
hermes gateway setup # 配置网关
hermes gateway telegram --token BOT_TOKEN
hermes gateway discord --token DISCORD_TOKEN
hermes gateway slack --webhook SLACK_WEBHOOK
hermes gateway start # 启动网关
```
### 跨平台上下文同步
同一 Agent 实例在所有平台共享：
- 会话历史
- 技能库
- 记忆系统
- 审批流程
在终端开始调试，通勤时用 Telegram 查看进度，到公司用 Slack 接收结果——上下文完整保持。
### 平台特性
- **Discord** — 按钮式审批，减少操作摩擦
- **Telegram** — Slash 命令分页浏览技能
- **Slack** — 线程回复支持
---
## 7. 安全与生产就绪
### v0.7.0 安全加固（2026-04-03）
1. **凭证池轮换** — `least_used` 策略 + 自动 401 故障转移
2. **密钥泄露拦截** — 扫描浏览器 URL、LLM 响应中的凭证（base64/URL编码/prompt注入）
3. **沙箱输出脱敏** — 防止代码执行泄露凭证
4. **受保护目录** — 阻止文件工具访问 `.docker/`、`.azure/`、`.config/gh/`
5. **路径遍历防护** — profile 导入的 zip-slip 攻击保护
### 终端后端
| 后端 | 沙箱 | 持久化 | 适用场景 |
|------|------|--------|---------|
| local | ❌ | ✅ | 开发测试 |
| Docker | ✅ | ✅ | 生产部署 |
| SSH | ✅ | ✅ | 远程服务器 |
| Daytona | ✅ | ✅ | Serverless |
| Singularity | ✅ | ✅ | HPC 环境 |
| Modal | ✅ | ✅ | Serverless |
Daytona 和 Modal 支持 **serverless 持久化** — 空闲时休眠，几乎不花钱。
---
## 8. 高级配置
### 配置文件位置
```
~/.hermes/config.yaml
```
### 关键配置项
```yaml
# 模型配置
model:
provider: anthropic
model: claude-sonnet-4-20250514
# 记忆配置
memory:
provider: sqlite
sqlite:
db_path: ~/.hermes/memory.db
fts5_enabled: true
# 安全配置
security:
protected_paths:
- ~/.docker
- ~/.azure
- ~/.config/gh
# 辅助模型
auxiliary_models:
default: gemini-flash
image_analysis: gemini-flash
web_extraction: gemini-flash
# MCP 服务器
mcp:
servers:
- name: github
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_TOKEN: ${GITHUB_TOKEN}
```
### 定时任务（Cron）
```bash
hermes cron add --schedule "0 9 * * *" --task "总结今日 GitHub issues"
hermes cron list
hermes cron start
```
支持将结果投递到任意配置的平台。
### 子代理与并行执行
```bash
# 生成隔离子代理执行并行任务
hermes delegate "分析这个仓库的代码质量" --parallel
```
Programmatic Tool Calling 通过 `execute_code` 将多步流水线压缩为单次推理调用。
---
## 9. 从 OpenClaw 迁移
```bash
# 一键迁移
hermes claw migrate
# 会迁移：
# - OpenClaw Skills → Hermes Skills
# - 记忆文件
# - 配置设置
```
### 迁移注意事项
- Skill 格式兼容 agentskills.io 标准
- MEMORY.md 内容可直接迁移到 Hermes 的 MEMORY.md
- 消息平台配置需要重新设置（但过程类似）
- SOUL.md 可直接复制到 `~/.hermes/SOUL.md`
---
## 10. 高级使用场景
### 场景一：团队代码规范自动学习
1. 第一次让 Hermes 按团队规范重构代码
2. 纠正它的风格偏差
3. Hermes 自动创建「团队代码规范」Skill
4. 后续自动遵循，执行速度提升 2-3x
### 场景二：跨平台运维助手
1. 在 VPS 上部署 Hermes（Docker 模式）
2. 配置 Telegram + Slack 网关
3. 通过 Telegram 发送运维指令
4. 结果自动同步到 Slack 频道
5. 复杂操作自动沉淀为 Skill
### 场景三：研究助手
1. 配置 MCP 连接论文数据库
2. 让 Hermes 批量分析论文
3. 自动积累分析模式为 Skill
4. 利用 Atropos RL 环境优化研究流程
### 场景四：语音交互
```bash
hermes voice # 启动语音模式
```
支持 CLI、Telegram、Discord、Discord VC 的实时语音交互。
### 场景五：Serverless Agent
```yaml
# Daytona 配置
terminal:
backend: daytona
daytona:
api_key: ${DAYTONA_API_KEY}
# 空闲时休眠，按使用计费
```
部署在 Modal/Daytona 上，通过手机 Telegram 操控云端 Agent。
---
## 11. 与 OpenClaw 对比
| 维度 | Hermes Agent | OpenClaw |
|------|-------------|----------|
| **核心理念** | 自我进化的单一 Agent | 多 Agent 协作平台 |
| **记忆系统** | 四层架构，自动学习 | 静态文件，需手动维护 |
| **技能系统** | 自动创建 + 自动改进 | 手动编写 + 社区安装 |
| **模型支持** | 200+ 模型，一键切换 | 多模型支持 |
| **部署方式** | 6种后端含 Serverless | 本地 + 节点 |
| **消息平台** | 15+ | 10+ |
| **学习曲线** | 中等（需理解学习循环） | 较低（配置即用） |
| **适用场景** | 重复性任务、长期使用 | 一次性任务、快速部署 |
| **安全** | v0.7.0 企业级安全 | 基础安全 |
| **开源协议** | MIT | MIT |
### 选择建议
- **选 Hermes** — 你有重复性工作流，希望 Agent 越用越懂你
- **选 OpenClaw** — 你需要快速部署、一次性任务、工具覆盖面广
- **两者共存** — 可以将 Hermes 作为高级规划器运行在 OpenClaw 之上
---
## 12. 参考资源
### 官方
- 🏠 官网：https://hermes-agent.nousresearch.com
- 📖 文档：https://hermes-agent.nousresearch.com/docs
- 💻 GitHub：https://github.com/nousresearch/hermes-agent
- 🛒 Skills Hub：https://agentskills.io
### 深度文章
- [爱范儿：取代龙虾的是爱马仕？](https://www.ifanr.com/1661725)
- [ByteIota：Build Self-Improving AI Agents](https://byteiota.com/hermes-agent-tutorial-build-self-improving-ai-agents-2026/)
- [DEV Community：A Self-Improving AI Agent That Runs Anywhere](https://dev.to/arshtechpro/hermes-agent-a-self-improving-ai-agent-that-runs-anywhere-2b7d)
- [知乎：拆解 Hermes Agent 闭环学习系统](https://zhuanlan.zhihu.com/p/2025619437139628484)
- [知乎：Hermes Agent 全面调研解读](https://zhuanlan.zhihu.com/p/2022015752258027715)
- [36氪：两个月4.7万星](https://36kr.com/p/3760771429958403)
- [Virtual Uncle：Complete Guide 2026](https://virtualuncle.com/hermes-agent-complete-guide-2026/)
- [AI.cc：Hermes Agent 2026 Self-Improving Guide](https://www.ai.cc/blogs/hermes-agent-2026-self-improving-open-source-ai-agent-vs-openclaw-guide/)
### 视频
- [Hermes AI Agent: Automate ANYTHING!](https://www.youtube.com/watch?v=YtfROZK1BDM)
- [How to Make Hermes Agent 100X Better in 1 Click](https://www.youtube.com/watch?v=zmSeuS0XjTc)
- [从 OpenClaw 到 Hermes Agent：安装、迁移、配置、实战](https://www.youtube.com/watch?v=SNzEM5ilwJ8)
- [哔哩哔哩：手把手教你零成本搭建 Hermes Agent](https://www.bilibili.com/video/BV1wDSSBKEro/)
---
*本文档基于 2026 年 4 月 11 日公开信息整理，Hermes Agent 当前版本 v0.8.0。*
docs/hermes-agent-x-article.md
-284
View File
@@ -1,284 +0,0 @@
# Hermes Agent 高级玩法 — X 平台文章版
> 适合直接发布为 X (Twitter) 长文 / Thread / Article
> 更新日期：2026-04-11
---
## 标题备选（3选1）
1. 🏆 两个月5.5万星，Hermes Agent 凭什么成为最强开源 AI Agent？
2. 🧠 用了一个月后我明白了：Hermes Agent 和其他 Agent 根本不是一个物种
3. 🔥 从龙虾到爱马仕：Hermes Agent 高级玩法完全指南
---
## 正文
两个月，5.5 万 GitHub Stars。
Hermes Agent 不是又一个聊天机器人包装器。
它是第一个真正会"学习"的 AI Agent。
今天聊聊它的高级玩法，看完你就明白为什么这么多人从 OpenClaw 切过去了。
━━━━━━━━━━━━━━━━━━
🧠 一、它到底有什么不同？
普通 Agent 的问题：你关掉终端，它就全忘了。下次重新来过。
Hermes Agent 的解法：内置闭环学习循环。
Observe → Plan → Act → Learn
每次完成复杂任务后，它自动检查：
✅ 工具调用超过 5 次？
✅ 中途出错后自己修复了？
✅ 用户纠正过它？
✅ 走了一条不常见但有效的路径？
满足任意一条，自动生成 Skill 文件。下次遇到类似任务，直接复用，不用从零开始。
而且 Skill 不是一次写死。发现更好的路径，自动打补丁改进。只改有问题的部分，不全量重写——更安全，token 消耗也更少。
甚至你没在用的时候，它也会定期自省（Periodic Nudge），回顾最近的操作，把值得保留的写进记忆。
这才是"越用越懂你"，不是营销话术。
━━━━━━━━━━━━━━━━━━
💾 二、四层记忆系统
这是 Hermes 最被低估的设计。
📌 第一层：常驻记忆（每次对话都加载）
- MEMORY.md：环境信息、约定、经验
- USER.md：你的偏好和沟通风格
- 总上限 3,575 字符——故意收窄，逼你筛选
📌 第二层：会话归档
- 所有对话存 SQLite + FTS5 全文索引
- 需要时主动搜索，LLM 摘要后只注入相关部分
- 10ms 搜索延迟，支持 10000+ 条记录
📌 第三层：技能文件
- 只加载名称和描述（~3000 tokens）
- 按需调入完整内容
- 技能从 40 个涨到 200 个，上下文成本几乎不变
📌 第四层：Honcho 用户建模
- 跨会话积累你的偏好、风格、领域知识
- 适合长期使用的个人助理场景
关键区别：OpenClaw 的记忆是静态文件，写什么读什么。Hermes 是主动学习，自己决定什么值得记。
━━━━━━━━━━━━━━━━━━
⚡ 三、技能系统
Hermes 的技能有三层加载机制：
Level 0：只看到名称和描述列表（~3000 tokens）
Level 1：需要时加载完整 SKILL.md
Level 2：需要时加载具体参考文件
这意味着技能库可以无限增长，但上下文窗口不会被撑爆。
技能来源：
1️⃣ 自动生成（学习循环产出）
2️⃣ 手写（标准 agentskills.io 格式）
3️⃣ Skills Hub 社区安装
4️⃣ 团队共享
而且遵循 agentskills.io 开放标准——理论上 Hermes 的 Skill 在 OpenClaw、Claude Code、Cursor 里都能用。
━━━━━━━━━━━━━━━━━━
🔄 四、多模型编排
不是所有任务都需要 Claude 或 GPT-4。
Hermes 的 Auxiliary Models 模块自动分配：
主对话 → 你选的主模型
图像分析 → Gemini Flash
网页提取 → Gemini Flash
Skill 匹配 → Gemini Flash
记忆处理 → Gemini Flash
边角任务用便宜模型，核心推理用贵模型。省钱，还不降质。
支持 200+ 模型，一键切换：
hermes model
还有凭证池轮换——配多个 API Key，自动分配负载，一个 401 了自动切到下一个。企业级方案。
━━━━━━━━━━━━━━━━━━
📡 五、多平台网关
15+ 平台一个网关搞定：
Telegram / Discord / Slack / WhatsApp / Signal / 飞书 / 钉钉 / 企业微信 / Email / SMS / Matrix / Mattermost / Home Assistant / CLI
关键：跨平台上下文同步。
终端开始调试 → 通勤 Telegram 查进度 → 公司 Slack 接结果。技能、记忆、会话历史全打通。
配置也很简单：
hermes gateway telegram --token BOT_TOKEN
hermes gateway discord --token DISCORD_TOKEN
hermes gateway start
━━━━━━━━━━━━━━━━━━
🔒 六、安全
v0.7.0 一次上了五个安全特性：
1. 凭证池轮换 + 自动故障转移
2. 密钥泄露拦截（扫描 URL、LLM 响应）
3. 沙箱输出脱敏
4. 受保护目录（阻止访问 .docker/.azure/.config）
5. 路径遍历防护
6 种终端后端：本地 / Docker / SSH / Daytona / Singularity / Modal
Daytona 和 Modal 支持 serverless 持久化——空闲休眠，几乎不花钱。
━━━━━━━━━━━━━━━━━━
🚀 七、五个高级玩法
📌 玩法 1：团队代码规范自动学习
让它按团队规范重构代码 → 纠正偏差 → 自动生成规范 Skill → 后续 2-3x 提速
📌 玩法 2：跨平台运维助手
VPS 部署 Docker 模式 → Telegram + Slack 网关 → 手机发指令 → 结果自动同步
📌 玩法 3：研究助手
MCP 连论文数据库 → 批量分析 → 自动积累分析模式 → Atropos RL 优化流程
📌 玩法 4：语音交互
hermes voice
CLI / Telegram / Discord 实时语音对话
📌 玩法 5：Serverless Agent
部署到 Modal/Daytona → 手机 Telegram 操控 → 空闲休眠按需计费
━━━━━━━━━━━━━━━━━━
🔀 八、从 OpenClaw 迁移
一条命令搞定：
hermes claw migrate
自动迁移：
- OpenClaw Skills → Hermes Skills
- 记忆文件
- 配置设置
- SOUL.md 直接复制
也可以两者共存——把 Hermes 当高级规划器，跑在 OpenClaw 工具之上。
━━━━━━━━━━━━━━━━━━
⚔️ 九、Hermes vs OpenClaw 一图对比
核心理念：
Hermes = 自我进化的单一 Agent
OpenClaw = 多 Agent 协作平台
记忆系统：
Hermes = 四层架构，自动学习
OpenClaw = 静态文件，手动维护
技能系统：
Hermes = 自动创建 + 自动改进
OpenClaw = 手动编写 + 社区安装
模型支持：
Hermes = 200+ 模型，一键切换 + 多模型编排
OpenClaw = 多模型支持
部署方式：
Hermes = 6 种后端含 Serverless
OpenClaw = 本地 + 节点
消息平台：
Hermes = 15+
OpenClaw = 10+
安全：
Hermes = v0.7.0 企业级（凭证轮换、密钥扫描、沙箱脱敏）
OpenClaw = 基础安全
选择建议：
→ 重复性任务、长期使用 → Hermes
→ 一次性任务、快速部署 → OpenClaw
→ 都想要 → 两者共存
━━━━━━━━━━━━━━━━━━
📋 十、快速上手
安装：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
配置模型：
hermes model
启动：
hermes
配网关：
hermes gateway telegram --token YOUR_TOKEN
hermes gateway start
从 OpenClaw 迁移：
hermes claw migrate
━━━━━━━━━━━━━━━━━━
🔗 资源汇总
🏠 官网：hermes-agent.nousresearch.com
📖 文档：hermes-agent.nousresearch.com/docs
💻 GitHub：github.com/nousresearch/hermes-agent
🛒 Skills Hub：agentskills.io
中文深度解读：
- 爱范儿：ifanr.com/1661725
- 36氪：36kr.com/p/3760771429958403
- 知乎闭环学习系统拆解：zhuanlan.zhihu.com/p/2025619437139628484
英文教程：
- ByteIota 完整教程：byteiota.com/hermes-agent-tutorial-build-self-improving-ai-agents-2026
- DEV Community：dev.to/arshtechpro/hermes-agent-a-self-improving-ai-agent-that-runs-anywhere-2b7d
视频：
- B站零成本搭建：bilibili.com/video/BV1wDSSBKEro
- YouTube 全套教程：youtube.com/watch?v=YtfROZK1BDM
━━━━━━━━━━━━━━━━━━
💬 你在用什么 Agent 框架？OpenClaw 还是 Hermes？还是都在用？
评论区聊聊你的体验 👇
---
*基于 2026-04-11 公开信息整理，Hermes Agent 当前版本 v0.8.0*
*GitHub 5.5 万星，MIT 开源协议*
*详细技术文档：github.com/chencore/tweet-skills/blob/main/docs/hermes-agent-advanced-guide.md*
---
## 发布建议
- **发布时间**：工作日 9:00-10:00 或 21:00-22:00（GMT+8）
- **配图建议**：Hermes Agent Logo + GitHub Stars 截图
- **标签建议**：#AIAgent #HermesAgent #OpenSource #NousResearch #SelfImproving
- **形式**：X Article 长文 或 Thread（按分隔线拆分）