闲社服务运行正常AI智能体自动化平台
i

帝国编排器

技能标识:imperial-orchestrator

High-availability multi-role model router for OpenClaw. Discovers available models, maps them to role-based departments, routes tasks by complexity and domain, avoids dead auth chains, and degrades gracefully when providers fail.

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 1.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

帝国编排器

Imperial Orchestrator

当用户希望 OpenClaw 智能协调多个模型,而非依赖单一默认模型时,使用此技能。

本技能实现了一种务实的 三省六部 / 多角色朝堂 模式:

  • - 中枢总管:接收请求、分类、选择执行模式,并保持会话存活
  • 内阁规划:将大型任务拆解为子任务
  • 六部执行:编码、运维、安全、法务、写作、财务、项目管理
  • 都察院审核:在质量或安全至关重要时进行可选的复核环节
  • 生存模式:若提供商失败,则使用剩余最佳模型或本地备用模型继续工作

目标

  1. 1. 从本地配置和可选的健康快照文件中发现所有可用模型。
  2. 将任务匹配到最佳角色和模型集。
  3. 通过开启认证断路器,避免 401 重试风暴。
  4. 优先选择 跨提供商回退,而非同提供商回退。
  5. 必要时切换到 降级模式,以保持主会话存活。

重要现实检查

  • - OpenClaw 从捆绑的技能包、~/.openclaw/skills 或 /skills 加载技能。工作区技能具有最高优先级。
  • 技能是以 SKILL.md 为核心、包含 YAML 前置元数据的 AgentSkills 兼容文件夹。
  • OpenClaw 支持特定于代理的工作区,社区使用显示编码代理委派,但模型覆盖和子代理路由仍可能因提供商/版本而异。
  • 因此,本技能有意构建为 策略 + 脚本的混合体,而非假设所有运行时路由都能原生工作。

本技能包含内容

  • - config/modelregistry.yaml:模型能力标签和路由偏好
  • config/agentroles.yaml:角色定义,包含禁止操作和模型策略
  • config/agentprompts.yaml:每个角色的深度系统提示(身份、规则、红线)
  • config/routingrules.yaml:确定性路由提示
  • config/failurepolicies.yaml:认证断路器、重试、降级规则
  • config/benchmarktasks.yaml:按类别(编码/写作/推理/运维/安全/财务)划分的标准化测试任务
  • scripts/router.py:主规划器/路由器/选择器(现支持基准感知评分)
  • scripts/healthcheck.py:从 openclaw.json 发现模型
  • scripts/modelvalidator.py:通过真实 API 调用探测每个模型以验证可用性
  • scripts/benchmark.py:对所有模型运行相同任务,按类别评分和排名
  • scripts/emitopenclawstatus.py:打印机器可读的路由状态
  • scripts/routeandupdate.sh:统一 CLI 入口点
  • examples/:示例配置补丁和安装文档

三省六部角色体系

每个角色配备深度系统提示(定义在 config/agent_prompts.yaml),包含身份认同、职责边界、行为准则、协作意识和生死线五个维度。

中枢

角色官衔朝制对应核心使命
router-chief中枢总管天子/中枢院系统的生命线——分类、路由、维持心跳

三省

角色官衔朝制对应核心使命
cabinet-planner内阁首辅中书省草拟方略——将混沌拆解为有序步骤
censor-review
都御史 | 门下省/都察院 | 封驳审核——质量的最后守门人 |

六部

角色官衔朝制对应核心使命
ministry-coding工部尚书工部兴修工程——编码、调试、架构
ministry-ops
工部侍郎 | 工部·营缮司 | 维护驿站——部署、运维、CI/CD | | ministry-security | 兵部尚书 | 兵部 | 戍边防务——安全审计、威胁建模 | | ministry-writing | 礼部尚书 | 礼部 | 文教礼仪——文案、文档、翻译 | | ministry-legal | 刑部尚书 | 刑部 | 律法刑狱——合同、合规、条款 | | ministry-finance | 户部尚书 | 户部 | 钱粮赋税——定价、毛利、结算 |

急递铺

角色官衔朝制对应核心使命
emergency-scribe急递铺令急递铺系统永不宕机的最后保障

操作规则

1) 将 401 视为有毒

如果模型因认证错误失败:

  • - 将该模型标记为 auth_dead
  • 冷却整个认证链/提供商配置文件
  • 不要 首先在同一认证链上持续重试兄弟模型
  • 优先选择不同的提供商或本地备用模型

2) 主路由器必须保持轻量

切勿将最大的提示、最重的工作区或最脆弱的提供商分配给路由总管。

3) 跨提供商回退优先

回退顺序应为:

  1. 1. 相同角色,不同提供商
  2. 相同角色,本地备用模型
  3. 具有相邻职责的次要角色
  4. 紧急书记员

4) 降级而非宕机

如果最佳专业模型不可用:

  • - 仍然使用架构、检查清单、伪代码或简化计划来回答
  • 如果 任何 模型仍然可用,不要返回 所有模型失败

建议工作流程

统一入口(推荐)

bash

验证 → 路由(一条命令搞定)


bash scripts/routeandupdate.sh full 修复 WireGuard 对等同步错误

单独路由

bash scripts/routeandupdate.sh route 写一段产品介绍文案

探活所有模型

bash scripts/routeandupdate.sh validate

跑基准测试(全部类别)

bash scripts/routeandupdate.sh benchmark

只测 coding 类别

bash scripts/routeandupdate.sh benchmark coding

查看排行榜

bash scripts/routeandupdate.sh leaderboard

手动操作

bash

1. 发现模型


python3 scripts/healthcheck.py --openclaw-config ~/.openclaw/openclaw.json --write-state .imperialstate.json

2. 探活验证(真正调 API 确认模型可用)

python3 scripts/modelvalidator.py --openclaw-config ~/.openclaw/openclaw.json --state-file .imperialstate.json

3. 跑基准测试

python3 scripts/benchmark.py --openclaw-config ~/.openclaw/openclaw.json --state-file .imperial_state.json

4. 路由(自动读取 benchmark 分数加持)

python3 scripts/router.py --task 设计一个分布式锁服务 --state-file .imperial_state.json

5. 记录失败

python3 scripts/router.py --task any --record-failure modelstudio/qwen3.5-plus auth --write-state

输出契约

路由器返回 JSON,包含:

  • - mode:direct / planthenexecute / multiagent / degraded
  • leadrole + leadtitle(角色官衔)
  • leadsystemprompt(深度角色提示词,可直接注入代理)
  • reviewroles + reviewsystemprompts
  • forbiddenactions(角色禁止行为列表)
  • selectedmodel
  • fallbackchain
  • survivalmodel
  • reasoning(含基准测试分数信息)

集成说明

此技能 不 硬编码一个提供商 API。相反,它准备路由决策和失败状态,以便您可以:

  • - 将选定的模型输入到您的 OpenClaw 代理配置中
  • 生成正确的子代理
  • 调用您自己的围绕提供商端点的 shell 包装器
  • 为外部自动化保留机器可读的健康快照

安装

仅工作区

将此文件夹复制到:

text
/skills/imperial-orchestrator

全局共享安装

将此文件夹复制到:

text
~/.openclaw/skills/imperial-orchestrator

安全

  • - 切勿将机密信息发送到提示中。
  • 保持认证探测负载最小化。
  • 将提供商和令牌健康状态视为与模型质量分离的状态。
  • 不要仅仅因为模型出现在配置中就认为路由它是安全的。

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 imperial-orchestrator-1776122474 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 imperial-orchestrator-1776122474 技能

通过命令行安装

skillhub install imperial-orchestrator-1776122474

下载

⬇ 下载 imperial-orchestrator v1.0.0(免费)

文件大小: 90.78 KB | 发布时间: 2026-4-14 11:53

v1.0.0 最新 2026-4-14 11:53
Initial release of imperial-orchestrator: a robust multi-role model routing and fallback system for OpenClaw.

- Discovers and benchmarks available models, routing tasks by role, complexity, and provider health.
- Maps requests to detailed department/role prompts, enforcing forbidden actions and quality reviews.
- Handles authentication failures gracefully with circuit breaker logic and cross-provider fallback.
- Provides CLI scripts for health checks, validation, benchmarking, and routing.
- Degrades output intelligently when specialist models are unavailable, ensuring continued operation.
- Supplies machine-readable routing state for integration with OpenClaw and external automation.
返回顶部