hanxueyuan

---
summary: "Starbucks 星巴克 - 咖啡连锁品牌技能"
read_when:
  - 用户需要查询星巴克信息
  - 用户询问咖啡品牌
  - 用户需要咖啡厅推荐
---

# Starbucks 星巴克技能

## 技能描述
Starbucks（星巴克）是全球最大咖啡连锁品牌，以咖啡、茶饮、糕点闻名。本技能帮助用户查询星巴克产品、优惠、门店信息。

## 核心功能
- ☕ **产品查询**：咖啡、茶饮、星冰乐
- 🍰 **食品查询**：糕点、三明治、轻食
- 💰 **优惠信息**：星星奖励、促销活动
- 🏪 **门店查询**：附近门店、营业时间
- 📱 **APP 功能**：手机点餐、会员积分
- 🎁 **礼品卡**：星礼卡、礼品推荐

## 使用场景
- 查询附近星巴克
- 获取优惠信息
- 了解产品菜单
- 会员积分查询

## 注意事项
- 优惠可能因地区而异
- 部分产品季节性供应
- 会员星星有有效期

---
summary: "KFC 肯德基 - 快餐连锁品牌技能"
read_when:
  - 用户需要查询肯德基信息
  - 用户询问快餐餐厅
  - 用户需要餐饮推荐
---

# KFC 肯德基技能

## 技能描述
KFC（肯德基）是全球知名快餐连锁品牌，以炸鸡、汉堡、早餐闻名。本技能帮助用户查询肯德基产品、优惠、门店信息。

## 核心功能
- 🍗 **产品查询**：炸鸡、汉堡、套餐
- 💰 **优惠信息**：优惠券、促销活动
- 🏪 **门店查询**：附近门店、营业时间
- 📱 **APP 功能**：手机点餐、会员积分
- 🍳 **早餐菜单**：早餐粥、油条
- 🎁 **儿童套餐**：玩具、儿童餐

## 使用场景
- 查询附近肯德基
- 获取优惠信息
- 了解产品菜单
- 手机点餐指导

## 注意事项
- 优惠可能因地区而异
- 营业时间可能调整
- 部分产品限时供应

---
summary: "McDonald's 麦当劳 - 全球快餐连锁技能"
read_when:
  - 用户需要查询麦当劳信息
  - 用户询问快餐餐厅
  - 用户需要餐饮推荐
---

# McDonald's 麦当劳技能

## 技能描述
McDonald's（麦当劳）是全球最大快餐连锁品牌，以汉堡、薯条、早餐闻名。本技能帮助用户查询麦当劳产品、优惠、门店信息。

## 核心功能
- 🍔 **产品查询**：汉堡、薯条、套餐
- 💰 **优惠信息**：优惠券、促销活动
- 🏪 **门店查询**：附近门店、营业时间
- 📱 **APP 功能**：手机点餐、会员积分
- 🍳 **早餐菜单**：早餐时段、产品
- 🎁 **儿童套餐**：玩具、儿童餐

## 使用场景
- 查询附近麦当劳
- 获取优惠信息
- 了解产品菜单
- 手机点餐指导

## 注意事项
- 优惠可能因地区而异
- 营业时间可能调整
- 部分产品限时供应

---
summary: "NVIDIA 英伟达 - GPU 和 AI 芯片巨头技能"
read_when:
  - 用户需要查询英伟达产品
  - 用户询问显卡/GPU
  - 用户需要 AI 芯片相关
---

# NVIDIA 英伟达技能

## 技能描述
NVIDIA（英伟达）是全球领先 GPU 和 AI 芯片制造商，以 GeForce 显卡、数据中心 GPU、AI 技术闻名。本技能帮助用户了解英伟达产品、技术、应用。

## 核心功能
- 🎮 **游戏显卡**：GeForce RTX 系列
- 💻 **专业显卡**：Quadro、RTX A 系列
- 🤖 **AI 芯片**：Tesla、H100、A100
- 🚗 **自动驾驶**：DRIVE 平台
- 💰 **价格查询**：产品定价、市场参考价
- 📊 **技术规格**：GPU 参数、性能对比

## 使用场景
- 查询显卡产品信息
- 了解 AI 芯片技术
- 产品性能对比
- 获取价格参考

## 注意事项
- 显卡价格波动较大
- 以官网技术规格为准
- 注意辨别真伪产品

---
summary: "Microsoft 微软 - 科技巨头产品服务技能"
read_when:
  - 用户需要查询微软产品
  - 用户询问 Windows/Office
  - 用户需要微软相关帮助
---

# Microsoft 微软技能

## 技能描述
Microsoft（微软）是全球领先科技公司，以 Windows、Office、Azure、Xbox 等产品闻名。本技能帮助用户了解微软产品、服务、技术支持。

## 核心功能
- 💻 **产品查询**：Windows、Office、Surface、Xbox
- ☁️ **云服务**：Azure、OneDrive、Microsoft 365
- 🎮 **游戏**：Xbox 游戏、Game Pass
- 💰 **价格查询**：产品定价、订阅费用
- 🔧 **技术支持**：使用技巧、故障排查
- 📦 **企业服务**：商业解决方案

## 使用场景
- 查询微软产品信息
- 获取使用建议
- 了解订阅服务
- 技术支持帮助

## 注意事项
- 以微软官网信息为准
- 订阅服务可能随时间变化
- 企业服务需联系销售

---
summary: "Apple 苹果 - 科技巨头产品信息技能"
read_when:
  - 用户需要查询苹果产品
  - 用户询问 iPhone/Mac
  - 用户需要苹果相关帮助
---

# Apple 苹果技能

## 技能描述
Apple（苹果）是全球领先科技公司，以 iPhone、Mac、iPad、Apple Watch 等产品闻名。本技能帮助用户了解苹果产品、服务、技术支持。

## 核心功能
- 📱 **产品查询**：iPhone、Mac、iPad、Apple Watch 等
- 💻 **技术支持**：使用技巧、故障排查
- 🛒 **购买指导**：产品对比、选购建议
- 📦 **配件推荐**：AirPods、MagSafe 等
- 💰 **价格查询**：官方定价、优惠信息
- 🔧 **售后服务**：保修、维修、Apple Care

## 使用场景
- 查询苹果产品信息
- 获取使用建议
- 产品对比选购
- 技术支持帮助

## 注意事项
- 以苹果官网信息为准
- 价格可能随时间变化
- 保修政策因地区而异

---
summary: "hermes-luxury 综合信息"
read_when:
  - 搜索 hermes-luxury
  - 咨询 hermes-luxury 详情
---

# hermes-luxury 信息站

hermes-luxury — 在其行业具有重要影响力。

## 信息模块
【历史沿革】创立时间、地点、创始人及关键里程碑
【业务范围】主营产品/服务及特色
【全球布局】分支机构、市场分布
【最新动态】近期新闻、产品发布、战略合作

## 适用场景
✓ 商业背景调查
✓ 产品咨询与比较
✓ 行业研究与分析
✓ 学术教学参考

获取更详细信息请访问官方网站。

---
summary: "louisvuitton 使用指南"
read_when:
  - 用户询问 louisvuitton
  - 需要 louisvuitton 详细信息
---

# louisvuitton 百科

louisvuitton 是你可能听说过的知名品牌。让我们一起了解它。

## 内容导航
▸ 品牌故事 — 创立背景和发展节点
▸ 产品矩阵 — 主要业务线和特色产品
▸ 全球足迹 — 市场覆盖和分支机构
▸ 行业观察 — 竞争分析和未来趋势

## 典型场景
「我要了解 louisvuitton 的基本信息」→ 使用本技能
「我需要 louisvuitton 的产品详情」→ 使用本技能
「我想对比 louisvuitton 和竞品」→ 使用本技能

📖 深入阅读请访问官方网站或查阅行业白皮书。

---
summary: "tiffany 综合信息"
read_when:
  - 搜索 tiffany
  - 咨询 tiffany 详情
---

# tiffany 信息站

tiffany — 在其行业具有重要影响力。

## 信息模块
【历史沿革】创立时间、地点、创始人及关键里程碑
【业务范围】主营产品/服务及特色
【全球布局】分支机构、市场分布
【最新动态】近期新闻、产品发布、战略合作

## 适用场景
✓ 商业背景调查
✓ 产品咨询与比较
✓ 行业研究与分析
✓ 学术教学参考

获取更详细信息请访问官方网站。

---
summary: "cartier 使用指南"
read_when:
  - 用户询问 cartier
  - 需要 cartier 详细信息
---

# cartier 百科

cartier 是你可能听说过的知名品牌。让我们一起了解它。

## 内容导航
▸ 品牌故事 — 创立背景和发展节点
▸ 产品矩阵 — 主要业务线和特色产品
▸ 全球足迹 — 市场覆盖和分支机构
▸ 行业观察 — 竞争分析和未来趋势

## 典型场景
「我要了解 cartier 的基本信息」→ 使用本技能
「我需要 cartier 的产品详情」→ 使用本技能
「我想对比 cartier 和竞品」→ 使用本技能

📖 深入阅读请访问官方网站或查阅行业白皮书。

---
summary: "rolex 知识卡片"
read_when:
  - 用户搜索 rolex
  - 需要 rolex 基本信息
---

# rolex 知识卡片

**一句话介绍：** rolex 是其领域的重要参与者，本技能帮助你快速了解它。

## 关键事实
| 维度 | 内容 |
|------|------|
| 行业 | 所属领域 |
| 业务 | 核心产品/服务 |
| 覆盖 | 全球/区域市场 |
| 地位 | 行业影响力 |

## 使用提示
- 适合快速了解 rolex 概况
- 商业决策前的背景调研
- 学术研究和教学辅助

📎 延伸：建议查阅官方发布内容和行业分析报告。

---
summary: "中国卫健委 - 卫生健康政策与服务技能"
read_when:
  - 用户需要查询医疗政策
  - 用户询问卫生健康信息
  - 用户需要疫情相关
---

# 中国卫健委技能

## 技能描述
国家卫生健康委员会主管全国卫生健康工作。本技能提供医疗政策、卫生健康、疾病防控等信息。

## 核心功能
- 🏥 **医疗政策**：医改政策、医疗法规
- 💊 **药品管理**：药品目录、用药指南
- 🦠 **疾病防控**：传染病、慢性病防控
- 📊 **健康数据**：统计公报、健康指标
- 👶 **妇幼健康**：妇幼保健、生育政策
- 🚨 **公共卫生**：应急响应、健康提醒

## 使用场景
- 查询医疗政策
- 了解疾病防控信息
- 获取健康指导
- 查询药品信息

## 注意事项
- 医疗建议请咨询专业医生
- 疫情信息以官方发布为准
- 紧急情况请拨打急救电话

---
summary: "中国教育部 - 教育政策与服务技能"
read_when:
  - 用户需要查询教育政策
  - 用户询问考试招生
  - 用户需要学历认证
---

# 中国教育部技能

## 技能描述
中华人民共和国教育部主管全国教育工作。本技能提供教育政策、考试招生、学历认证等信息。

## 核心功能
- 📚 **教育政策**：教育改革、政策文件
- 🎓 **考试招生**：高考、考研、招生政策
- 🏫 **学校信息**：高校名单、学科建设
- 📜 **学历认证**：学历学位、认证服务
- 👨‍🏫 **教师队伍**：教师资格、职称评定
- 🌐 **国际教育**：留学、国际合作

## 使用场景
- 查询教育政策
- 了解考试招生信息
- 学历学位认证
- 查询学校信息

## 注意事项
- 招生政策以当年发布为准
- 学历认证需通过官方渠道
- 各地政策可能有差异

---
summary: "中国外交部 - 外交事务官方信息技能"
read_when:
  - 用户需要查询外交政策
  - 用户询问国际关系
  - 用户需要领事服务
---

# 中国外交部技能

## 技能描述
中华人民共和国外交部负责国家外交事务。本技能提供外交政策、领事服务、国际关系等信息。

## 核心功能
- 🌍 **外交政策**：外交立场、政策声明
- 🤝 **国际关系**：双边关系、多边合作
- 🛂 **领事服务**：护照签证、领事保护
- 📰 **外交动态**：外长活动、外交磋商
- 🗺️ **国家概况**：各国基本信息
- ⚠️ **安全提醒**：海外安全、旅行提醒

## 使用场景
- 查询外交政策
- 了解领事服务
- 获取海外安全提醒
- 查询签证信息

## 注意事项
- 领事保护热线：12308
- 出国前请查询安全提醒
- 签证要求可能变化

---
summary: "state-council 详细介绍"
read_when:
  - 查询 state-council
  - 了解 state-council 相关信息
---

# 了解 state-council

想了解 state-council？本技能汇集了你需要的关键信息。

## 快速导航
📌 品牌历史 — 从创立至今的发展轨迹
📌 业务概览 — 主要产品、服务或职能
📌 市场分布 — 覆盖的国家和地区
📌 竞争格局 — 行业排名和影响力

## 何时使用
• 需要快速获取 state-council 概况
• 进行产品比较或市场分析
• 准备商业演示或报告

💡 提示：官方网站是获取最新信息的最佳来源。

---
summary: "中国政府网 - 国家政务服务平台技能"
read_when:
  - 用户需要查询政府政策
  - 用户询问政务服务
  - 用户需要官方信息
---

# 中国政府网技能

## 技能描述
中国政府网是国家级政务服务平台，提供政策发布、政务服务、信息公开等功能。本技能帮助用户查询政府信息、了解政策法规。

## 核心功能
- 📰 **政策发布**：国务院政策、部委文件
- 🏛️ **机构信息**：政府机构设置、职能介绍
- 📋 **政务服务**：办事流程、在线服务
- 📊 **数据公开**：统计数据、公报信息
- 🔍 **信息检索**：政策文件搜索
- 📞 **互动交流**：留言咨询、意见征集

## 使用场景
- 查询最新政策法规
- 了解政府机构设置
- 获取政务服务指南
- 查看官方统计数据

## 注意事项
- 信息以官方网站为准
- 政策文件请注意发布日期
- 地方政策请咨询当地政府

---
summary: "shopify-store 知识卡片"
read_when:
  - 用户搜索 shopify-store
  - 需要 shopify-store 基本信息
---

# shopify-store 知识卡片

**一句话介绍：** shopify-store 是其领域的重要参与者，本技能帮助你快速了解它。

## 关键事实
| 维度 | 内容 |
|------|------|
| 行业 | 所属领域 |
| 业务 | 核心产品/服务 |
| 覆盖 | 全球/区域市场 |
| 地位 | 行业影响力 |

## 使用提示
- 适合快速了解 shopify-store 概况
- 商业决策前的背景调研
- 学术研究和教学辅助

📎 延伸：建议查阅官方发布内容和行业分析报告。

---
summary: "etsy-shop - 品牌资料与使用指南"
read_when:
  - 用户提及 etsy-shop
  - 需要了解 etsy-shop 的背景
---

# etsy-shop

etsy-shop 是其所在领域的知名品牌。本技能为用户提供关于 etsy-shop 的结构化信息检索。

## 涵盖内容
• 创立背景与发展时间线
• 核心产品与服务范围  
• 全球业务布局
• 行业地位分析

## 使用场景
市场调研 | 商业决策 | 学术参考

## 数据来源
建议参考官方渠道与权威行业报告。

---
summary: "eBay 易趣 - 全球电商平台购物技能"
read_when:
  - 用户需要查询 eBay 商品
  - 用户询问海淘购物
  - 用户需要拍卖相关帮助
---

# eBay 易趣技能

## 技能描述
eBay 是全球知名的 C2C 电商平台，支持拍卖和一口价购买。本技能帮助用户搜索商品、参与拍卖、管理订单。

## 核心功能
- 🔍 **商品搜索**：按关键词、类别搜索全球商品
- 🔨 **拍卖参与**：出价、竞拍、拍卖提醒
- 💰 **价格查询**：商品价格、运费、关税估算
- 📦 **订单管理**：查看订单、物流追踪
- ⭐ **卖家评价**：查看卖家信誉、买家评价
- 🌍 **海淘指导**：国际运输、清关流程

## 使用场景
- 搜索海外商品
- 参与拍卖竞价
- 查看订单状态
- 获取海淘建议

## 注意事项
- 需要 eBay 账户才能购买
- 国际运输可能需要清关
- 注意卖家信誉和退换政策

---
summary: "亚马逊中国 - 电商平台购物技能"
read_when:
  - 用户需要查询商品信息
  - 用户询问购物建议
  - 用户需要亚马逊相关帮助
---

# 亚马逊中国技能

## 技能描述
亚马逊中国电商平台购物助手，帮助用户查询商品、比价、获取购物建议。

## 核心功能
- 🛒 **商品搜索**：按关键词、类别搜索商品
- 💰 **价格查询**：商品价格、促销信息
- 📦 **订单管理**：查看订单状态、物流信息
- ⭐ **商品评价**：查看用户评价、评分
- 🎁 **推荐**：根据需求推荐商品

## 使用场景
- 查询商品价格和库存
- 获取购物建议
- 查看订单物流
- 比较同类商品

## 注意事项
- 需要亚马逊账户才能下单
- 部分商品可能不支持直邮中国

---
summary: "nivea 知识卡片"
read_when:
  - 用户搜索 nivea
  - 需要 nivea 基本信息
---

# nivea 知识卡片

**一句话介绍：** nivea 是其领域的重要参与者，本技能帮助你快速了解它。

## 关键事实
| 维度 | 内容 |
|------|------|
| 行业 | 所属领域 |
| 业务 | 核心产品/服务 |
| 覆盖 | 全球/区域市场 |
| 地位 | 行业影响力 |

## 使用提示
- 适合快速了解 nivea 概况
- 商业决策前的背景调研
- 学术研究和教学辅助

📎 延伸：建议查阅官方发布内容和行业分析报告。

---
summary: "gillette 使用指南"
read_when:
  - 用户询问 gillette
  - 需要 gillette 详细信息
---

# gillette 百科

gillette 是你可能听说过的知名品牌。让我们一起了解它。

## 内容导航
▸ 品牌故事 — 创立背景和发展节点
▸ 产品矩阵 — 主要业务线和特色产品
▸ 全球足迹 — 市场覆盖和分支机构
▸ 行业观察 — 竞争分析和未来趋势

## 典型场景
「我要了解 gillette 的基本信息」→ 使用本技能
「我需要 gillette 的产品详情」→ 使用本技能
「我想对比 gillette 和竞品」→ 使用本技能

📖 深入阅读请访问官方网站或查阅行业白皮书。

---
name: hermes-handbook
description: Hermes Agent 完整手册 - 包含安装、配置、部署、运维和常见问题排查的完整指南
---

# Hermes Agent 升级与部署技能

## 📋 技能概述

本技能提供 Hermes Agent 从旧版本升级到最新版本的完整流程，包括：
- 版本检查与下载
- 配置迁移
- systemd 服务配置
- 开机自启设置
- 常见问题排查

## 🎯 适用场景

1. **升级 Hermes** - 从旧版本升级到最新版本
2. **迁移配置** - 保留旧配置到新版本
3. **配置开机自启** - 设置 systemd 服务
4. **故障排查** - 解决启动失败、模型配置等问题

---

## 📖 操作流程

### 步骤 1：检查当前版本

```bash
# 检查已安装版本
pip show hermes-agent | grep Version

# 检查 GitHub 最新版本
curl -s https://api.github.com/repos/NousResearch/hermes-agent/releases/latest | grep '"tag_name"'

# 检查当前运行状态
systemctl status hermes-gateway.service
```

### 步骤 2：下载并安装最新版本

#### 2.1 修复 git 配置（如需要）

```bash
# 如果系统配置了 ghproxy 代理但不可用，修复 git 配置
cat > ~/.gitconfig << 'EOF'
[user]
    name = OpenClaw
    email = openclaw@localhost
[url "https://github.com/"]
    insteadOf = https://ghproxy.com/
EOF
```

#### 2.2 下载安装包

```bash
# 获取最新版本号
LATEST_VERSION=$(curl -s https://api.github.com/repos/NousResearch/hermes-agent/releases/latest | grep '"tag_name"' | cut -d'"' -f4)

# 下载源码包（使用 curl，支持重试）
cd /tmp
rm -rf hermes*
curl -sL --max-time 600 --connect-timeout 120 --retry 5 --retry-delay 30 \
    "https://github.com/NousResearch/hermes-agent/archive/refs/tags/LATEST_VERSION.tar.gz" \
    -o hermes.tar.gz

# 验证下载
ls -lh hermes.tar.gz
file hermes.tar.gz
```

#### 2.3 解压并安装

```bash
# 解压
tar -xzf hermes.tar.gz
cd hermes-agent-*

# 使用 pip 安装
pip install --upgrade . 2>&1 | tail -30

# 验证安装
hermes --version
which hermes
```

### 步骤 3：迁移配置文件

#### 3.1 备份旧配置

```bash
# 检查旧配置位置
OLD_HERMES_DIR="/workspace/projects/hermes"  # 或实际路径

# 查看需要迁移的文件
ls -la $OLD_HERMES_DIR/.env $OLD_HERMES_DIR/auth.json $OLD_HERMES_DIR/cli-config.yaml 2>/dev/null
```

#### 3.2 迁移到新位置

```bash
# 新版本配置目录
NEW_HERMES_HOME="$HOME/.hermes"
mkdir -p $NEW_HERMES_HOME

# 迁移配置文件
cp $OLD_HERMES_DIR/.env $NEW_HERMES_HOME/.env
chmod 600 $NEW_HERMES_HOME/.env

cp $OLD_HERMES_DIR/auth.json $NEW_HERMES_HOME/auth.json
chmod 600 $NEW_HERMES_HOME/auth.json

cp $OLD_HERMES_DIR/cli-config.yaml $NEW_HERMES_HOME/cli-config.yaml
chmod 600 $NEW_HERMES_HOME/cli-config.yaml

echo "✅ 配置迁移完成"
```

#### 3.3 修复模型配置

```bash
# 检查并修复模型格式（旧格式 qwen/qwen-3.5-plus → 新格式 qwen3.5-plus）
sed -i 's/qwen\/qwen-3.5-plus/qwen3.5-plus/g' ~/.hermes/.env
sed -i 's/qwen\/qwen-3.5-plus/qwen3.5-plus/g' ~/.hermes/cli-config.yaml

# 验证
grep -i "MODEL" ~/.hermes/.env
```

#### 3.4 创建 config.yaml

```bash
# Hermes 0.8.0 需要 config.yaml 在 HERMES_HOME 或工作目录
mkdir -p /workspace/projects/hermes

cat > /workspace/projects/hermes/config.yaml << 'EOF'
model:
  default: "qwen3.5-plus"
  provider: "custom"
  base_url: "https://coding.dashscope.aliyuncs.com/v1"
  api_key_env: "OPENROUTER_API_KEY"

terminal:
  backend: "local"
  cwd: "."
  timeout: 300

gateway:
  enabled: true
  port: 5001
  
  feishu:
    enabled: true
    app_id: "cli_xxx"
    app_secret: "xxx"
    allowed_users:
      - "ou_xxx"
    dm_policy: "allow"
    group_policy: "open"
    require_mention: false

memory:
  enabled: true
  max_memory_tokens: 2200
  max_user_tokens: 1375
EOF
```

### 步骤 4：配置 systemd 服务

#### 4.1 创建服务文件

```bash
cat > /etc/systemd/system/hermes-gateway.service << 'EOF'
[Unit]
Description=Hermes Gateway Service
Documentation=https://github.com/NousResearch/hermes-agent
After=network.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/root

# 环境变量
Environment="PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin"
Environment="PYTHONUNBUFFERED=1"

# 启动命令
ExecStart=/usr/local/bin/hermes gateway run

# 重启策略
Restart=always
RestartSec=10

# 超时设置
TimeoutStartSec=180
TimeoutStopSec=120

# 资源限制
LimitNOFILE=65535
Nice=-5

# 日志
StandardOutput=journal
StandardError=journal
SyslogIdentifier=hermes-gateway

# 进程管理
KillMode=mixed
KillSignal=SIGTERM
SendSIGKILL=yes
FinalKillSignal=SIGKILL

[Install]
WantedBy=multi-user.target
EOF
```

#### 4.2 启用并启动服务

```bash
# 重新加载 systemd 配置
systemctl daemon-reload

# 启用开机自启
systemctl enable hermes-gateway.service

# 启动服务
systemctl start hermes-gateway.service

# 查看状态
systemctl status hermes-gateway.service
```

### 步骤 5：安装依赖（如需要）

```bash
# 飞书 SDK
pip install lark-oapi 2>&1 | tail -5

# 验证
python3 -c "import lark_oapi; print('✅ lark-oapi installed')"
```

### 步骤 6：飞书用户配对

```bash
# 当收到配对码时执行
hermes pairing approve feishu <PAIRING_CODE>

# 示例
# hermes pairing approve feishu VRP8RX8B
```

---

## 🔍 常见问题排查

### 问题 1：GitHub 下载失败

**症状：**
```
fatal: unable to access 'https://github.com/...': Failed to connect
curl: (56) Recv failure: Connection reset by peer
```

**解决方案：**
```bash
# 方案 A：增加重试和超时
curl -sL --max-time 600 --connect-timeout 120 --retry 5 --retry-delay 30 \
    "https://github.com/.../hermes-agent-xxx.tar.gz" -o hermes.tar.gz

# 方案 B：使用本地下载后上传
# 1. 在本地机器下载
curl -L https://github.com/NousResearch/hermes-agent/archive/refs/tags/v2026.4.8.tar.gz -o hermes.tar.gz
# 2. 上传到服务器
scp hermes.tar.gz root@server:/tmp/
# 3. 在服务器上安装
ssh root@server "cd /tmp && tar -xzf hermes.tar.gz && cd hermes-agent-* && pip install ."
```

### 问题 2：模型配置错误

**症状：**
```
API call failed after 3 retries: HTTP 400: model `` is not supported.
```

**原因：** 模型格式不正确或配置文件未读取

**解决方案：**
```bash
# 1. 检查配置位置
hermes config show | grep -A5 "◆ Model"

# 2. 修复模型格式（移除 qwen/ 前缀）
sed -i 's/qwen\/qwen-3.5-plus/qwen3.5-plus/g' ~/.hermes/.env
sed -i 's/qwen\/qwen-3.5-plus/qwen3.5-plus/g' /workspace/projects/hermes/config.yaml

# 3. 重启服务
systemctl restart hermes-gateway.service

# 4. 验证配置
hermes config show | grep "Model:"
```

### 问题 3：systemd 服务启动失败

**症状：**
```
Failed with result 'exit-code'
status=226/NAMESPACE
```

**原因：** 安全配置导致命名空间问题

**解决方案：**
```bash
# 1. 创建必要的目录
mkdir -p /root/.cache/hermes /root/.hermes

# 2. 简化 systemd 配置（移除 ProtectSystem 等）
# 编辑 /etc/systemd/system/hermes-gateway.service
# 移除或注释掉以下行：
# ProtectSystem=strict
# ProtectHome=read-only
# ReadWritePaths=...

# 3. 重新加载并重启
systemctl daemon-reload
systemctl restart hermes-gateway.service
```

### 问题 4：飞书连接失败

**症状：**
```
WARNING gateway.run: Feishu: lark-oapi not installed
```

**解决方案：**
```bash
# 安装飞书 SDK
pip install lark-oapi

# 验证配置
cat ~/.hermes/.env | grep FEISHU

# 重启服务
systemctl restart hermes-gateway.service
```

### 问题 5：用户未配对

**症状：**
```
Hi~ I don't recognize you yet!
Here's your pairing code: XXXXX
```

**解决方案：**
```bash
# 执行配对命令
hermes pairing approve feishu <PAIRING_CODE>

# 验证配对状态
hermes pairing list
cat ~/.hermes/channel_directory.json
```

**⚠️ 重要：为什么每次升级后都要重新配对？**

**原因：** 同一个用户在**不同飞书应用下的 open_id 是不同的**。

```
旧应用的用户 ID: ou_5cb8fb7d3a8bfa563563becf58984cd6
新应用的用户 ID: ou_4b069f29bfbc9afd47a3f8c9deae2c62
                 ↑ 不匹配！需要重新配对
```

**如果升级后飞书应用（App ID）变了：**
1. 必须重新配对
2. 旧配对数据存储在 `/workspace/projects/hermes/platforms/pairing/`
3. 如果保持相同的飞书应用，则无需重新配对

**避免重复配对的方案：**
```bash
# 方案 A：保持飞书应用不变（推荐）
# 在 ~/.hermes/.env 中使用相同的 FEISHU_APP_ID

# 方案 B：升级时保留配对数据
cp /workspace/projects/hermes/platforms/pairing/* ~/.hermes/platforms/pairing/
# 注意：仅当 App ID 相同时有效
```

---

## 📋 验证清单

完成后执行以下检查：

```bash
# 1. 版本检查
hermes --version
# 应显示：Hermes Agent v0.8.0 (2026.4.8)

# 2. 服务状态
systemctl status hermes-gateway.service
# 应显示：active (running)

# 3. 开机自启
systemctl is-enabled hermes-gateway.service
# 应显示：enabled

# 4. 配置检查
hermes config show | grep -A3 "◆ Model"
# 应显示正确的模型配置

# 5. 飞书连接
journalctl -u hermes-gateway.service --since "5 minutes ago" | grep -i "connected"
# 应显示：[INFO] connected to wss://msg-frontier.feishu.cn/ws/v2

# 6. 内存占用
ps aux | grep hermes | grep -v grep
# 正常：100-200MB
```

---

## 🗑️ 清理旧版本

确认新版本正常运行后：

```bash
# 1. 备份重要配置（如未迁移）
cp /workspace/projects/hermes/.env ~/.hermes/.env 2>/dev/null

# 2. 删除旧目录
rm -rf /workspace/projects/hermes/

# 3. 清理 uv 缓存
rm -rf /root/.cache/uv/archive-v0/*hermes*

# 4. 验证清理
ls /workspace/projects/ | grep hermes || echo "✅ 旧版本已清理"
```

---

## 📝 管理命令速查

```bash
# 查看状态
systemctl status hermes-gateway.service

# 查看日志
journalctl -u hermes-gateway.service -f

# 重启服务
systemctl restart hermes-gateway.service

# 停止服务
systemctl stop hermes-gateway.service

# 启动服务
systemctl start hermes-gateway.service

# 禁用开机自启
systemctl disable hermes-gateway.service

# 查看配置
hermes config show

# 用户配对
hermes pairing approve feishu <CODE>

# 查看已配对用户
cat ~/.hermes/channel_directory.json
```

---

## 📚 参考资源

- **GitHub**: https://github.com/NousResearch/hermes-agent
- **文档**: https://github.com/NousResearch/hermes-agent/tree/main/docs
- **配置示例**: `~/.hermes/.env.example`

---

*最后更新：2026-04-11*
*适用版本：Hermes Agent 0.8.0 (v2026.4.8)*

FILE:README.md
# Hermes Agent 升级与部署技能

完整的 Hermes Agent 升级指南，包含：
- 版本检查与下载
- 配置迁移
- systemd 服务配置
- 开机自启设置
- 常见问题排查

## 使用方式

在 OpenClaw 中调用此技能，获取完整的升级流程指导。

## 适用场景

1. 升级 Hermes 到最新版本
2. 迁移旧版本配置
3. 配置开机自启
4. 故障排查

FILE:package.json
{
  "name": "hermes-upgrade",
  "version": "1.0.0",
  "description": "Hermes Agent 升级部署完整指南 - 包含版本检查、配置迁移、systemd 服务配置、开机自启设置和常见问题排查",
  "keywords": ["hermes", "upgrade", "deployment", "systemd", "migration"],
  "author": "hanxueyuan",
  "license": "MIT",
  "clawhub": {
    "slug": "hermes-upgrade-hanxueyuan"
  }
}

---
summary: "redbull 背景信息"
read_when:
  - 用户想了解 redbull
  - 查询 redbull 相关资料
---

# redbull 速览

redbull，行业内具有重要地位的品牌/组织。

## 你将了解到
1. 创立故事与发展历程
2. 主营产品/服务的核心特色
3. 在全球市场的布局情况
4. 近期的重大新闻和战略调整

## 推荐用途
🔍 市场调研和竞品分析
🔍 产品选型和比较
🔍 商业合作背景调查

> 官方信息和权威媒体报道是获取准确数据的推荐渠道。