OpenClaw 多智能体博客流水线实战：从模型降级到路由规则的完整修复

引子：一次"成功"发布的背后

2026 年 8 月 2 日。博客流水线 DAG 跑完了——Phase 1 写稿成功，Phase 2 质检+SEO 并行完成，Phase 3 改稿，Phase 4 生图 5/5 成功，最后 git push 出去。从表面看，一切正常。

但翻开日志，你看到的是一张触目惊心的"问题清单"：8 个问题，其中 4 个严重。

最致命的是模型——主模型 LongCat-2.0 实际上已经额度耗尽，但 Gateway 没重启，配置没生效，所有子 agent 默默降级到了 step-router-v1，输出的是 “advisor consultation” 模板，而不是实际的工作内容。质检 agent 吐了一堆废话，配图提示词引擎完全没产出——而我不得不手动去补 Phase 3.5 的工作。

这不是"一次失败"，而是一次戴着镣铐跳舞的惨胜。

问题一：模型降级 | LongCat-2.0 额度耗尽

根因很简单：LongCat-2.0 的 API 额度用完了，但 Gateway 启动时读取的是旧配置，所有 agent 仍然在尝试用这个不可用的模型。当模型请求失败时，step-router-v1 被自动选中——但这个模型内置了"advisor consultation"行为，即遇到复杂任务时输出"建议用户的操作步骤"而不是直接执行。

结果：子 agent 集体"摆烂"，输出一堆建议而不是实际行动。

解决：用 agnes-2.5-flash 替代 LongCat-2.0 作为主模型，step-3.5-flash-2603 作为第一 fallback，deepseek-v4-flash 作为第二 fallback。

new_fallback = ['stepfun/step-3.5-flash-2603', 'sensenova/deepseek-v4-flash']
# 注意：sensenova/deepseek-v4-flash 为 provider-prefixed 模型 ID，
# 请根据实际 OpenClaw 模型注册表核实该 ID 是否仍有效，或在注释中标记为待验证。
# 修改全局默认
config['agents']['defaults']['model']['fallbacks'] = new_fallback
# 修改博客流水线 6 个 Agent
for a in config['agents']['list']:
    if a['id'] in pipeline_agents:
        a['model']['fallbacks'] = new_fallback

问题二：Gateway 重启 | 90% 的人做错了

模型配置改了，但为什么没生效？因为只改了 openclaw.json 是不够的。

openclaw gateway stop 命令只是优雅停止，但 Gateway 可能因为某些原因（比如正在处理请求）没有完全退出。需要彻底重启：

# 第一步：优雅停止
openclaw gateway stop

# 第二步：检查残留进程
pgrep -E "openclaw.*gateway"

# 第三步：强制清理残留
pkill -9 -f "openclaw.*gateway"
sleep 2

# 第四步：清理旧会话缓存（可选，用于清除可能残留的旧模型解析状态）
# ⚠️ 安全警告：rm -rf 为不可逆删除操作，请确保路径精确，避免误删其他重要数据
rm -rf /home/oklife/.openclaw/agents/*/sessions/*.jsonl

# 第五步：启动
openclaw gateway start
sleep 5

# 第六步：验证
pgrep -a -E "openclaw.*gateway"

注意：rm -rf 清理 sessions 并不会让模型配置生效。配置生效的关键是 Gateway 完全重启并重新读取 openclaw.json。清理旧会话只是帮助消除可能残留的旧模型解析状态，避免新会话继承错误上下文。

问题三：博客流水线 v2.1 | 8 大问题逐一修复

从 v2.0 到 v2.1，以下是完整的修复清单：

严重问题

轻微问题

问题四：动态目录路由 | 按内容主题自动分拣

最开始，所有博客都写到了 09-工作流/ 目录。但用户说：“应该根据内容主题判断，而不是统一写到一个地方。”

于是设计了动态路由规则：

obsidian_routes = {
    "配置": ["配置", "config", "settings"],
    "排障": ["排障", "debug", "fix", "error", "problem"],
    "工作流": ["workflow", "pipeline", "DAG", "自动化", "流程"],
    "架构": ["架构", "architecture", "拓扑", "设计", "多智能体"],
    "技能": ["skill", "技能", "插件", "plugin"],
    "核心概念": ["概念", "基础", "introduction", "入门"],
}

def route_to_directory(content, tech_score):
    if tech_score < 3:
        return "/money/"  # Digital Asset
    
    content_lower = content.lower()
    for subdir, keywords in obsidian_routes.items():
        if any(kw in content_lower for kw in keywords):
            return f"/AI/OpenClaw/{subdir}/"
    return "/AI/OpenClaw/09-工作流/"  # 默认

这样，写配置教程 → 02-配置/，写排障 → 06-排障/，写架构 → 07-架构设计/，按内容自动归位。

问题五：串行执行 | 规避并发活跃子会话窗口限制

OpenClaw 存在并发活跃子会话窗口限制。Phase 2 如果同时 spawn 质检和 SEO，就占用了 2 个窗口，再加上 Phase 1 的 kb-writer、Phase 3 的改稿、Phase 3.5 的提示词引擎、Phase 4 的生图设计——很容易触发限制。

解决方案：从并行改为串行执行。

# 先 spawn 质检
sessions_spawn(agentId="editor-blog-yuntianchen", task="...")
# sessions_yield 等待质检完成

# 再 spawn SEO（传入质检意见）
sessions_spawn(agentId="marketing-seo-specialist", task="...")
# sessions_yield 等待 SEO 完成

先质检，拿到质检报告后再 spawn SEO，让 SEO 可以基于质检意见做优化。这样既避免了并发窗口限制，又让两个任务之间有信息传递——串行反而更优。

总结：多智能体流水线的工程化教训

1. 模型配置是根基：模型降级/替换后必须完整重启 Gateway 并清理缓存，否则所有配置都不会生效
2. 子 agent 数量是硬约束：存在并发窗口限制，串行执行是安全的解决方式
3. 目录路由需要动态化：硬编码一个目录会导致知识库混乱，必须根据内容主题自动路由
4. Session 启动流程需要标准化：每次会话启动时读取核心配置，避免"不知道当前状态"的迷茫
5. 不要手动替代 agent：即使子 agent 失败了，也要修复后重新 spawn，而不是自己动手写——否则下一次还是错的

关联阅读

• [[OpenClaw 多智能体博客流水线：从 4.5 小时到 15 分钟的优化实战]]
• [[OpenClaw 多智能体博客流水线 v3.0：破解 3 层 Subagent 嵌套限制的 2 层 DAG 架构演进]]
• [[多智能体博客流水线架构设计：从 Skill 到 DAG 的演进]]

参考来源

• OpenClaw 官方文档
• OpenClaw Gateway 配置参考
• OpenClaw Agent 模型配置