三省六部 — OpenClaw 多 Agent 编排系统
一键部署 11 个协作 AI Agent,模拟组织架构处理复杂任务。
1.13.0 亮点
现在不只是一个“本地操作台”,而是已经具备商业后台、Skills Center、OpenClaw 原生控制中心,以及真实会话中心能力的多 Agent 产品:
python3 ~/.openclaw/workspace-your-router-id/scripts/collaboration_dashboard.py --serve
这一版新增:
- 每 Agent 直达对话:Agent 运营台卡片、Agent 抽屉和会话中心都能一键进入对应 Agent 的主会话
- 会话中心:新增
/conversations,直接浏览 OpenClaw 真实 sessions、查看 jsonl transcript,并继续与 Agent 对话 - 产品内对话:Owner / Operator 可以直接在产品里向选中 Agent 或当前 session 发消息,不再必须回终端
- 原生会话 API:新增
/api/conversations和/api/conversations/transcript - OpenClaw Control Center:新增
/openclaw,直接查看官方版本、schema 校验、gateway 健康、managed skills 目录和原生 skills 可用性 - OpenClaw 原生 API 映射:新增
/api/openclaw,给产品内和外部自动化直接读 OpenClaw 运行态 - Skills Center:新增
/skills,直接管理本地 skill 目录、校验质量、生成脚手架和打包 zip - Claude 风格 skill 工具链:内置
bin/skill_utils.py,支持list / validate / scaffold / package - skill 分发能力:可把本地 skill 打成 zip,或直接发布到当前 OpenClaw 的 managed skills 目录
- 示例 skill:仓库内置
mission-control-release-ops,直接演示 Anthropic 推荐的 frontmatter + references 渐进披露模式 - OpenClaw 适配基线:按
OpenClaw 2026.3.12+适配,并兼容 CLI 在 JSON 前后夹带 warning / plugin 日志的场景 - 团队账号登录:日常使用改走账号密码,
Owner Token只保留给初始化和紧急接管 - 角色权限体系:
Owner / Operator / Viewer三层权限,收口任务、对话、主题和后台动作 - 商业后台:新增
/admin,可管理团队席位、角色状态、密码重置和审计日志 - 席位治理:支持激活 / 停用账号,且会阻止你把最后一个活跃 Owner 锁死
- 后台敏感数据分层:静态快照只保留聚合统计,具体成员名单和审计流只对已登录授权会话开放
- 多模块 Mission Control:总览、Agent 运营、交付执行、活动时间线、主题中心
- 本地实时 Web 应用:
--serve会启动带 SSE 推送的常驻产品面板 - 本地登录:先访问
/login,通过签名 cookie 会话进入受保护的产品界面 - 深链接路由:
/agents、/tasks、/conversations、/activity、/themes、/skills、/openclaw、/admin - 本地 API:
/api/agents、/api/tasks、/api/conversations、/api/conversations/transcript、/api/events、/api/themes、/api/skills、/api/openclaw、/api/deliverables、/api/admin - 可调布局:支持收起菜单,并在运营 / 聚焦 / 紧凑三种布局间切换
- 操作工作台:直接在产品里创建任务,不再先回终端
- 任务操作抽屉:可在任务详情里追加进展、标记阻塞、标记完成
- 产品内主题切换:在主题中心直接切换
imperial / corporate / startup - 全局 toast 反馈、任务筛选、交付物列表、产品内置 runbook
- Agent 明细抽屉与任务回放抽屉仍然保留,而且切页时不会再被抽屉挡住导航
- 运行中切换主题:
bash bin/switch_theme.sh --theme startup - 自动迁移:保留现有频道、模型、网关 token、任务板和 workspace 产物
架构
用户(老板/CEO/皇上)
└─ 路由 Agent ── 消息分拣、建任务、回奏
├─ 简报 Agent ── 每日情报
└─ 规划 Agent ── 方案设计
├─ 审议 Agent ── 重大任务把关
└─ 调度 Agent ── 派发执行
├─ 工程部 ── 开发/架构
├─ 运维部 ── 部署/安全
├─ 数据部 ── 分析/报表
├─ 内容部 ── 文档/对外
├─ 质量部 ── 测试/审查
└─ 行政部 ── 人事/管理
快速开始
git clone https://github.com/imgolye/sansheng-liubu.git
cd sansheng-liubu
bash bin/setup.sh
bash bin/validate.sh # 验证安装
安装向导会交互式询问:
- 配置频道(飞书 / Telegram / QQ)
- 选择模型
主题通过 --theme 指定,默认是 imperial:
bash bin/setup.sh --theme corporate
5 分钟上手
1. 安装到默认目录
bash bin/setup.sh
默认会写入 ~/.openclaw。
2. 安装完成后立即验证
bash bin/validate.sh --dir ~/.openclaw
openclaw config validate
通过标准:
validate.sh显示 11 个 agent 文件完整openclaw config validate返回Config valid
3. 启动网关
openclaw gateway run
另开一个终端检查:
openclaw gateway health
4. 查看运行状态
# imperial 主题示例
python3 ~/.openclaw/workspace-taizi/scripts/health_dashboard.py
如果你希望自动识别当前主题的路由 agent,可以直接运行:
ROUTER_ID=$(python3 - <<'PY'
import json
from pathlib import Path
config = json.loads((Path.home() / ".openclaw" / "openclaw.json").read_text())
agents = config.get("agents", {}).get("list", [])
router_id = next((a["id"] for a in agents if a.get("default")), agents[0]["id"] if agents else "taizi")
print(router_id)
PY
)
python3 ~/.openclaw/workspace-${ROUTER_ID}/scripts/health_dashboard.py
如果你使用的是 startup 或 corporate 主题,请把 workspace-taizi 替换成对应路由 agent 的 workspace,例如:
startup→workspace-secretarycorporate→workspace-assistant
示例输出:
======================================================================
Health Dashboard | 2026-03-14 07:34:00
======================================================================
--- Agent 状态 ---
Agent 名称 模型 工作区活动 会话活动
assistant EA openai-codex/gpt-5.4 8分钟前 无记录
vp_strategy VP Strategy openai-codex/gpt-5.4 8分钟前 无记录
...
--- 活跃任务 (0) ---
无活跃任务
如果你想看到“每个 Agent 正在干什么、最近怎么接力”,可以打开协同态势看板:
python3 ~/.openclaw/workspace-${ROUTER_ID}/scripts/collaboration_dashboard.py
python3 ~/.openclaw/workspace-${ROUTER_ID}/scripts/collaboration_dashboard.py --serve
--serve 会启动本地实时面板,默认地址:
http://127.0.0.1:18890/collaboration-dashboard.html
它会通过 Server-Sent Events 实时接收任务与协同变化,不再整页重载。
如果开启本地服务,建议先从登录页进入:
http://127.0.0.1:18890/login
首次进入时可以使用 DASHBOARD_AUTH_TOKEN;如果未设置,会自动回落到现有的 GATEWAY_AUTH_TOKEN。创建团队席位后,建议改走团队账号登录。
如果通过本地服务访问,现在还可以直接打开这些模块:
http://127.0.0.1:18890/
http://127.0.0.1:18890/agents
http://127.0.0.1:18890/tasks
http://127.0.0.1:18890/activity
http://127.0.0.1:18890/themes
http://127.0.0.1:18890/skills
http://127.0.0.1:18890/admin
现在还能直接点开:
- Agent 卡片:查看最近信号、当前关注点、在手任务
- 任务卡片:查看任务路线、TODO 进度、完整协同回放,并直接推进 / 阻塞 / 完成
- 时间线事件:从最近一次 handoff / progress 直接跳到对应任务
- 主题卡片:直接在产品中切换主题
- Skills Center:扫描 skill 目录、查看 frontmatter/结构质量、直接创建脚手架并打包 zip
- 商业后台:创建席位、调整角色、停用账号、重置密码,并查看治理审计
生成结果默认在:
~/.openclaw/dashboard/collaboration-dashboard.html
~/.openclaw/dashboard/collaboration-dashboard.json
5. 首次使用建议
- 先发一条简单消息,确认路由 Agent 能正常接收并回复
- 再发一条明确任务,确认会自动建任务并流转到规划/执行链路
- 若升级过 OpenClaw,建议补跑一次
openclaw gateway health
三套主题
| 主题 | 风格 | 适合场景 |
|---|---|---|
imperial | 皇帝朝廷、三省六部 | 个人玩家、极客 |
corporate | CEO → VP → Teams | 企业团队、正式场合 |
startup | 老板 → PM → 全栈 | 创业公司、小团队 |
# 指定主题
bash bin/setup.sh --theme corporate
运行中切换主题
已有安装不需要重装,可以直接切换:
bash bin/switch_theme.sh --theme startup
如果你的 OpenClaw 不在默认目录:
bash bin/switch_theme.sh --theme corporate --dir /path/to/.openclaw
切换时会:
- 备份当前
openclaw.json和.env到backups/theme-switch-* - 保留现有频道配置、模型配置、Gateway token 和任务前缀
- 迁移任务看板、Agent 会话目录以及 workspace 里的非模板文件
- 重新生成新主题的
SOUL.md、kanban_config.json和openclaw.json
如果你希望切换时顺便改任务前缀,可以加:
bash bin/switch_theme.sh --theme corporate --task-prefix TASK
Skills Center
如果你要把 Anthropic Skills 那套能力落进这个仓库,现在可以直接在产品里打开:
http://127.0.0.1:18890/skills
也可以直接走命令行:
python3 bin/skill_utils.py list --project-dir .
python3 bin/skill_utils.py validate --project-dir .
python3 bin/skill_utils.py package --project-dir . --skill mission-control-release-ops
如果你想新建一个 skill 脚手架:
python3 bin/skill_utils.py scaffold \
--project-dir . \
--slug customer-onboarding \
--title "Customer Onboarding" \
--description "Guides a repeatable customer onboarding workflow." \
--trigger-phrase "onboard a new customer" \
--category workflow-automation \
--include-scripts \
--include-references
当前仓库已经自带一个示例 skill:
skills/mission-control-release-ops/
核心特性
- 任务分级 S/A/B:重大任务走审议流程,简单任务直达执行
- 串联/并行调度:支持 工程→测试→部署 链式执行
- 实时看板:全程进度可视,每个 Agent 主动上报状态
- 协同态势视图:直接看到谁在执行、谁在等待、任务如何接力流转
- 异常升级:阻塞自动逐级上报
- 安全加固:secrets 环境变量化、per-agent 沙箱、工具白名单
- 多语言支持:主题配置
language: "en"自动生成英文 SOUL.md 和看板标签 - 安装验证:
validate.sh一键检查所有文件/配置是否完整
目录结构
sansheng-liubu/
├── bin/
│ ├── setup.sh # 交互式安装脚本
│ ├── switch_theme.sh # 已安装环境切换主题
│ ├── switch_theme.py # 主题切换与迁移逻辑
│ ├── render_templates.py # SOUL.md / kanban_config / HEARTBEAT 渲染
│ ├── generate_config.py # openclaw.json 生成
│ ├── theme_utils.py # 主题 schema 校验 / 迁移辅助
│ ├── skill_utils.py # Claude 风格 skill 的扫描 / 校验 / 脚手架 / 打包
│ └── validate.sh # 安装后验证
├── skills/
│ └── mission-control-release-ops/
│ ├── SKILL.md # 示例 skill
│ └── references/
│ └── release-checklist.md
├── templates/
│ └── scripts/ # 运行时脚本(部署到每个 workspace)
│ ├── kanban_update.py # 看板任务管理(自动加载 kanban_config.json)
│ ├── file_lock.py # 原子文件锁
│ ├── refresh_live_data.py
│ └── health_dashboard.py # 健康看板(自动加载 agent 列表)
├── themes/
│ ├── imperial/theme.json # 皇帝朝廷主题
│ ├── corporate/theme.json # 现代企业主题
│ └── startup/theme.json # 创业团队主题
└── README.md
前置要求
- OpenClaw >= 2026.3.12
- Python 3.10+
- 至少一个频道(飞书/Telegram/QQ)的 Bot Token
自定义主题
复制任意主题 JSON 修改即可:
cp themes/imperial/theme.json themes/my-team/theme.json
# 编辑 agent_id、title、description 等
bash bin/setup.sh --theme my-team
License
MIT
Changelog
See CHANGELOG.md for version upgrade records.
还没有评论。