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 平台风格库

风格库完整文件:skills/content/ai-news-multi-platform-writing/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
主动推送 ✅ 不需要 context_token,随时可发 ❌ 需要 context_token,2h 过期
投递失败原因 权限不足 / gateway 卡死 token 过期 / 服务端限流
容错策略 cron 落盘 + gateway 恢复后补发 cron 落盘 + 用户发消息刷 token 后补发

投递失败排查(飞书)

  1. gateway 心跳停了hermes cron status 看 ticker heartbeat,如果 stalled 则 hermes gateway restart
  2. 权限报错 99991672:去飞书后台开通对应权限
  3. 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 重试耗尽后自动切下一个模型,重置计数

作用范围

全局生效——所有聊天窗口和所有任务共享同一条 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 个,常用的)


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 网页服务器

写作 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)