7.9 KB · 更新于 2026-08-06 11:28
Hermes Agent 工作流配置知识库
记录时间:2026-08-04 · 环境:Ubuntu 24.04 / Hermes Agent
1. AI 新闻多平台写作工作流
整体流程
每天 8/10/12/14/16/18/20 点(7次/天)
↓
cron「AI最新咨询」触发
↓
搜索 AI 新闻 → 编号 → 落盘 news/YYYY-MM-DD-HH.md
↓
微信推送(context_token 有效 → 送达)
↓ ↘
↓ (token 过期 → 推送失败,发"补发"可补)
↓
看到编号清单 → 回复数字 → 写 5 平台文章 → 交付 md 文件
回复"补发/看最新" → 读 news 文件补送 → 再回数字触发写作
非数字/不回复 → 本轮结束
关键配置
| 项 |
值 |
| Cron Job ID |
f1fcf6d1ce13 |
| 调度 |
0 8-20/2 * * *(每天 8:00-20:00 每 2 小时) |
| 搜索窗口 |
当天首跑覆盖 0 点起,之后每次约 2 小时 |
| 配图规则 |
尽量为每条新闻搜索一张关联配图(优先原文配图/官方产品图/公司 logo),个别找不到可跳过 |
| 落盘路径 |
/root/.hermes/workspace/news/YYYY-MM-DD-HH.md(含序号+摘要+配图URL) |
| 文章交付 |
/root/.hermes/workspace/articles/YYYY-MM-DD/HH-MM/ + Obsidian vault |
| 投递目标 |
feishu:ou_e2635f5c8970df74185e8ef8ea42e02f(飞书 open_id) |
| 飞书 chat_id |
oc_9725f2c16c799e61835793113eb4cbc7 |
| 飞书权限 |
im:message:send(发送)、im:chat:readonly(读取会话信息) |
结束契约
| 用户指令 |
行为 |
回复数字(1/1,3 等) |
写该序号对应新闻的 5 篇文章,交付后本轮结束 |
| 回复「不需要」「结束」「跳过」 |
立即结束,不创建文章 |
| 不回复 |
自动结束,不追问 |
5 平台风格库
- 知乎:1800-2500 字,理性分析,引用块+数据支撑,话题标签
- 百家号:800-1500 字,新闻叙事+情绪共鸣,SEO 关键词
- 今日头条:600-1200 字,直给观点,短段落,争议性标题
- 微信公众号:1200-2000 字,深度解读,引言+小标题,温和语气
- 小红书:300-600 字,口语化+emoji,列表体,热门话题标签
风格库完整文件:skills/content/ai-news-multi-platform-writing/references/platform-styles.md
总开关命令
- 「暂停推送」→ 停掉 cron;「恢复推送」→ 重新开启
- 「更新风格库」→ 重新研读各平台文章,刷新
references/platform-styles.md
2. 飞书投递机制与容错
飞书 Bot 权限要求
飞书应用(App ID: cli_aafbdc744bb81cd3)需要以下权限才能正常投递:
| 权限 |
用途 |
状态 |
im:message:send(或 im:message / im:message:send_as_bot) |
bot 主动发消息 |
✅ 已开通 |
im:chat:readonly(或 im:chat / im:chat:read) |
读取会话信息 |
✅ 已开通 |
权限管理地址:https://open.feishu.cn/app/cli_aafbdc744bb81cd3/auth
与微信 iLink 的区别
| 对比项 |
飞书 |
微信 iLink |
| 主动推送 |
✅ 不需要 context_token,随时可发 |
❌ 需要 context_token,2h 过期 |
| 投递失败原因 |
权限不足 / gateway 卡死 |
token 过期 / 服务端限流 |
| 容错策略 |
cron 落盘 + gateway 恢复后补发 |
cron 落盘 + 用户发消息刷 token 后补发 |
投递失败排查(飞书)
- gateway 心跳停了:
hermes cron status 看 ticker heartbeat,如果 stalled 则 hermes gateway restart
- 权限报错 99991672:去飞书后台开通对应权限
- cron 执行 completed 但没收到:查 gateway 日志有无投递记录
grep "deliver\|feishu.*send" logs/gateway.log
补发命令
# 补发指定期到飞书
cat news/2026-08-05-20.md | hermes send --to "feishu:oc_9725f2c16c799e61835793113eb4cbc7" -s "【AI最新咨询 · 补发】"
3. 模型 Fallback 链配置
调用顺序
z-ai/glm-5.2 (NVIDIA) ← 主模型
↓ 529/overload 重试耗尽
deepseek-ai/deepseek-v4-pro (NVIDIA) ← Fallback 1
↓ 重试耗尽
deepseek-ai/deepseek-v4-flash (NVIDIA) ← Fallback 2
↓ 重试耗尽
qwen3.8-max (阿里云 custom_provider) ← Fallback 3(兜底)
重试策略(Hermes 内置)
| 阶段 |
次数 |
间隔 |
| 短重试 |
3 次 |
~5s jittered 指数退避 |
| 长退避 |
4 次 |
30s → 60s → 90s → 120s |
| 触发 fallback |
重试耗尽后自动切下一个模型,重置计数 |
|
- 总重试次数:8(
agent.api_max_retries)
- 覆盖错误:529 (overload)、429 (rate limit)、503/502/500、连接超时
作用范围
全局生效——所有聊天窗口和所有任务共享同一条 fallback 链:
| 场景 |
生效方式 |
| Cron 定时任务 |
每次执行时从 config.yaml 读 fallback 链 |
| 微信会话 |
每条消息处理前刷新 fallback 链到 agent |
| CLI 会话 |
同上 |
配置位置
/root/.hermes/config.yaml:
model:
default: z-ai/glm-5.2
provider: nvidia
fallback_providers:
- provider: nvidia
model: deepseek-ai/deepseek-v4-pro
- provider: nvidia
model: deepseek-ai/deepseek-v4-flash
- provider: qwen3.8-max
model: qwen3.8-max
base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
agent:
api_max_retries: 8
修改模型的三种方式
# 1. 命令行切主模型
hermes config set model.default <模型ID>
hermes config set model.provider <provider>
# 2. 交互式管理 fallback 链
hermes fallback list # 查看当前链
hermes fallback add # 交互添加
hermes fallback remove # 交互删除
# 3. 改配置文件(推荐,最灵活)
# 编辑 /root/.hermes/config.yaml 的 model 和 fallback_providers 字段
# Cron 任务单独改模型:
hermes cron edit <job_id> --model <模型ID> --provider <provider>
NVIDIA NIM 可用模型(实测 102 个,常用的)
z-ai/glm-5.2
deepseek-ai/deepseek-v4-pro
deepseek-ai/deepseek-v4-flash
deepseek-ai/deepseek-coder-6.7b-instruct
4. Obsidian Vault 本地知识库
目录结构
/root/Documents/Obsidian Vault/
├── 知识库/ ← 技术配置文档
│ └── Hermes-Agent工作流配置.md
└── AI最新资讯/ ← 新闻文章归档
├── README.md
└── YYYY-MM-DD/
├── 01-知乎.md
├── 02-百家号.md
├── 03-今日头条.md
├── 04-微信公众号.md
└── 05-小红书.md
Markdown 网页服务器
- 脚本:
/root/.hermes/workspace/md-server.py
- 端口:8899
- 功能:目录浏览 + markdown 渲染为暗色主题网页 + wikilink 支持
- 启动:
python3 /root/.hermes/workspace/md-server.py -p 8899
- 访问:
http://<服务器IP>:8899/
写作 skill 双写机制
文章交付时自动双写到两个位置:
- /root/.hermes/workspace/articles/YYYY-MM-DD/(主存储)
- /root/Documents/Obsidian Vault/AI最新资讯/YYYY-MM-DD/(Obsidian vault)
5. 相关 Skill
| Skill |
用途 |
ai-news-multi-platform-writing |
用户回复新闻序号时触发 5 平台写作 |
ai-news-collection |
cron 任务搜索 AI 新闻 |
chinese-platform-style-research |
各平台爆款风格调研方法 |
hermes-cron-delivery-ops |
cron 投递失败排查与补发 |
hermes-cron-ops |
定时任务运维 |
6. 环境配置速查
| 配置项 |
路径 |
| Hermes 配置 |
/root/.hermes/config.yaml |
| 环境变量 |
/root/.hermes/.env |
| Cron 任务 |
/root/.hermes/cron/jobs.json |
| Cron 执行记录 |
/root/.hermes/cron/executions.db |
| Gateway 日志 |
/root/.hermes/logs/gateway.log |
| Agent 日志 |
/root/.hermes/logs/agent.log |
| 微信 token 缓存 |
/root/.hermes/weixin/accounts/*.context-tokens.json |
| Obsidian vault |
/root/Documents/Obsidian Vault/(OBSIDIAN_VAULT_PATH 已配) |
| Markdown 服务器 |
/root/.hermes/workspace/md-server.py(端口 8899) |