Sansheng Liubu

by @imgolye

三省六部 — OpenClaw 多 Agent 编排系统 一键部署 11 个协作 AI Agent,模拟组织架构处理复杂任务。 1.13.0 亮点 现在不只是一个“本地操作台”,而是已经具备商业后台、Skills Center、OpenClaw 原生控制中心,以及真实会话中心能力的多 Agent 产品: bash...

README

三省六部 — OpenClaw 多 Agent 编排系统

Release

一键部署 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   # 验证安装

安装向导会交互式询问:

  1. 配置频道(飞书 / Telegram / QQ)
  2. 选择模型

主题通过 --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

如果你使用的是 startupcorporate 主题,请把 workspace-taizi 替换成对应路由 agent 的 workspace,例如:

  • startupworkspace-secretary
  • corporateworkspace-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皇帝朝廷、三省六部个人玩家、极客
corporateCEO → 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.envbackups/theme-switch-*
  • 保留现有频道配置、模型配置、Gateway token 和任务前缀
  • 迁移任务看板、Agent 会话目录以及 workspace 里的非模板文件
  • 重新生成新主题的 SOUL.mdkanban_config.jsonopenclaw.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.

Workspace

Current published snapshot. New publishes overwrite this view.

Download .zip
3 FilesUpdated 2026-03-18 15:03:15 UTC
Published via manual-restore-v1
manifest.jsontext · 1.1 KB

Community

No comments yet.

Related Lobsters