logo
0
0
WeChat Login
wanikua<wanikua@users.noreply.github.com>
docs: add MiniMax Coding Plan referral link

English Version | 🏢 企业版 Become CEO (English)

🏛️ AI 朝廷 — 用明代六部制管理你的 AI Agent 团队

30 分钟搭建 · 多 Agent 协作 · 零代码 · 古代治国智慧 × 现代 AI 管理

以明朝三省六部制为蓝本,用 OpenClaw 框架构建的多 Agent 协作系统。 一台服务器 + OpenClaw = 一支 7×24 在线的 AI 朝廷。

系统架构流程图

Discord 朝廷架构图


目录

章节说明
📜这个项目是什么?项目介绍、设计理念、核心能力
🆚为什么选这套方案?与 ChatGPT / AutoGPT / CrewAI 对比
🏗️技术架构三省六部映射、架构图
🎬效果展示Discord 真实对话示例
🚀快速开始← 从这里开始安装
├─ Linux 服务器安装一键脚本,5分钟搞定
├─ macOS 本地安装Homebrew 自动安装
├─ 精简安装(已有 OpenClaw)只初始化配置
├─ 填 Key 上线API Key + Discord Bot Token
└─ 全六部上线测试 + 配置自动化
🍍实战案例:菠萝王朝14 Agent 真实运行架构
🏛️朝廷架构详解历史背景、角色对照、多模型混搭
⚙️核心能力详解协作、记忆、Skill、Cron、沙箱
🖥️GUI 管理界面Web Dashboard + Discord + Notion
常见问题基础 + 技术 FAQ
🏢企业版 Become CEO同架构的英文企业版
🔗相关链接 & 社区小红书、公众号、微信群

这个项目是什么?

AI 朝廷是一个开箱即用的多 AI Agent 协作系统,将中国古代的三省六部制(中书省 · 门下省 · 尚书省 → 吏部 · 户部 · 礼部 · 兵部 · 刑部 · 工部)映射为现代 AI Agent 的组织架构。

简单来说: 你是皇帝,AI 是你的大臣。每位大臣各司其职——写代码的、管财务的、搞营销的、做运维的——你只需要在 Discord 里下一道「圣旨」(@某个 Agent),大臣们就会立刻执行。

为什么用古代朝廷架构?

古代三省六部制是人类历史上运行时间最久的组织管理体系之一(隋唐至清末,超过 1300 年)。它的核心设计理念:

  • 职责分明 — 六部各司其职,互不越权(= AI Agent 各有专长)
  • 流程标准化 — 奏折制度、批红制度(= Prompt 模板 + SOUL.md 人格注入)
  • 权力制衡 — 三省互相制约(= Agent 互审、多步确认)
  • 档案留存 — 起居注、实录制度(= Memory 持久化、Notion 自动归档)

这些思想完美映射到现代多 Agent 系统的设计需求。古代治国的智慧,就是现代管理 AI 团队的最佳实践。

核心能力一览

能力描述
多 Agent 协作7 个独立 AI Agent(六部 + 司礼监),各有专长,协同工作
独立记忆每个 Agent 有独立工作区和 memory 文件,越用越懂你
60+ 内置 SkillGitHub、Notion、浏览器、Cron、TTS 等开箱即用
自动化任务Cron 定时任务 + 心跳自检,7×24 无人值守
沙箱隔离Docker 容器隔离,Agent 代码执行互不干扰
多平台支持Discord / 飞书 / Slack / Telegram 等,@mention 即可调用
Web 管理后台React + TypeScript 构建的 Dashboard,可视化管理
OpenClaw 生态基于 OpenClaw 框架,可使用 OpenClaw Hub 的 Skill 生态

想要企业版?

如果你更熟悉现代企业管理概念,我们有英文企业版

👉 Become CEO — 同一套架构,用 CEO / CTO / CFO / CMO 等企业角色代替朝廷六部

朝廷角色企业角色职责
皇帝CEO最高决策者
司礼监COO / 首席运营官日常调度、任务分配
兵部CTO / 工程VP软件工程、技术架构
户部CFO / 财务VP财务分析、成本管控
礼部CMO / 营销VP品牌营销、内容策划
工部VP Infra / SREDevOps、基础设施
吏部VP Product / PMO项目管理、团队协调
刑部General Counsel法务合规、合同审查

💡 两个项目基于相同的 OpenClaw 框架,架构完全一致,只是角色命名和文化背景不同。选你喜欢的风格即可!


📌 关于原创性 — 本项目首次提交于 2026-02-22commit 记录),是「用中国古代官制隐喻 AI 多 Agent 协作」这一概念的原始实现。我们注意到 cft0808/edict(首次提交 2026-02-23,晚约 21 小时)在框架选型、SOUL.md 人格文件、部署方式、竞品对比表格等方面与本项目高度一致,详见 Issue #55

欢迎转载,请注明出处。

📕 小红书原创系列:用AI当上皇帝的第3天,我已经欲罢不能了 | 赛博皇帝的日常:睡前下旨,AI连夜肝完代码


为什么选这套方案?

ChatGPT 等网页版AutoGPT / CrewAI / MetaGPTAI 朝廷(本方案)
多 Agent 协作❌ 单个通才✅ 需写 Python 编排✅ 配置文件搞定,零代码
独立记忆⚠️ 单一通用记忆⚠️ 需自己接向量库✅ 每个 Agent 独立工作区 + memory 文件
工具集成⚠️ 有限插件⚠️ 需自己开发✅ 60+ 内置 Skill(GitHub / Notion / 浏览器 / Cron …)
界面网页命令行 / 自建 UI✅ Discord 原生(手机电脑都能用)
部署难度无需部署需 Docker + 编码✅ 一键脚本,5 分钟跑起来
24h 在线❌ 需手动对话✅ 定时任务 + 心跳自检
组织架构隐喻三省六部制,职责分明
框架生态封闭自建✅ OpenClaw Hub Skill 生态

核心优势:不是框架,是成品。 跑个脚本就能用,在 Discord 里 @谁谁回复。


技术架构

┌─────────────────────┐ │ 皇帝(你) │ │ Discord / Web UI │ └──────────┬──────────┘ │ 圣旨(@mention / DM) ▼ ┌──────────────────────────────┐ │ OpenClaw Gateway │ │ Node.js 守护进程 │ │ │ │ ┌─────────────────────────┐ │ │ │ 消息路由 (Bindings) │ │ │ │ channel + accountId │ │ │ │ → agentId 匹配 → 分发 │ │ │ │ 会话隔离 · Cron · 心跳 │ │ │ └─────────────────────────┘ │ └──┬───┬───┬───┬───┬───┬───┬───┘ │ │ │ │ │ │ │ ┌─────────────┘ │ │ │ │ │ └─────────────┐ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ┌──────────┐ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌──────────┐ │ 司礼监 │ │兵部│ │户部│ │吏部│ │礼部│ │工部│ │ 刑部 │ │ 总管调度 │ │编码│ │财务│ │管理│ │营销│ │运维│ │ 法务 │ │ (main) │ │ │ │ │ │ │ │ │ │ │ │ │ └──────────┘ └────┘ └────┘ └────┘ └────┘ └────┘ └──────────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ┌───────────────────────────────────────────────────────────┐ │ Skill 工具层(60+ 内置) │ │ GitHub · Notion · 浏览器 · Cron · TTS · 截图 │ │ sessions_spawn(跨 Agent 派活) │ │ sessions_send(跨 Agent 通信) │ │ OpenClaw Hub 社区扩展 Skill │ └───────────────────────────────────────────────────────────┘

每个 Agent 绑定一个 Discord Bot 账号,由同一个 Gateway 进程统一管理:

  • 独立会话:每个 Agent 有独立的会话存储(~/.openclaw/agents/<agentId>/sessions),互不干扰
  • 独立模型:重活用强力模型,轻活用快速模型,省钱又高效
  • 独立沙箱:可配置 Docker 沙箱隔离,每个 Agent 独立容器
  • 身份注入:Gateway 自动将 SOUL.md + IDENTITY.md + 工作区文件组装为系统提示
  • 消息路由:通过 bindings 配置将 (channel, accountId) 映射到 agentId,最具体的匹配优先

效果展示

Discord 对话示例

👑 皇帝:@兵部 帮朕写一个用户登录的 REST API,用 Node.js + Express 🏛️ 兵部:遵旨,臣即刻动手。 📁 已创建 auth-api/ 项目结构 ✅ POST /api/login — JWT 认证 ✅ POST /api/register — 用户注册 ✅ middleware/auth.js — Token 验证中间件 ✅ 已提交至 GitHub:wanikua/auth-api#1 臣已完工,请陛下御览。 👑 皇帝:@户部 这个月 API 花了多少钱? 🏛️ 户部:启禀陛下,本月 API 支出如下: 💰 总计:$23.47 ├── 兵部(强力模型):$15.20(编码任务 142 次) ├── 礼部(快速模型):$3.80(文案任务 89 次) ├── 司礼监(快速模型):$2.12(日常对话 203 次) └── 其他:$2.35 📊 环比上月 -12%,主要因兵部优化了 Prompt 长度。 👑 皇帝:@礼部 写条小红书文案,推荐 AI 工具搭建 🏛️ 礼部:遵旨!文案如下: 📝 标题:「普通人也能当AI皇帝?我用6个AI管理整个团队」 正文:还在一个个对话框里跟AI聊天?我直接搭了个AI朝廷... 🏷️ #AI工具 #效率提升 #多Agent #AI朝廷 #三省六部 👑 皇帝:@everyone 明天下午三点开会,各部门准备周报 🏛️ 司礼监:遵旨,臣已记录会议安排。 🏛️ 兵部:臣收到,将整理本周代码产出。 🏛️ 户部:臣收到,将备好财务报表。 🏛️ 礼部:臣收到,将汇总营销数据。 🏛️ 工部:臣收到,将备好服务器运行报告。

使用场景

场景描述涉及部门
独立开发者一个人拥有完整技术团队,编码 + 运维 + 营销全覆盖兵部 + 工部 + 礼部
学生学习AI 导师团队,不同科目不同 Agent,各有记忆全六部可自定义
创业团队低成本 AI 助手矩阵,覆盖产品、技术、运营全六部
自媒体运营内容创作 + 数据分析 + 财务管理一体化礼部 + 户部
科研项目文献搜索 + 代码实验 + 论文写作兵部 + 礼部
AI 实验/娱乐Agent 互相对话、成语接龙、模拟朝会全六部

快速开始

第一步:一键部署(5 分钟)

准备一台 Linux 服务器,SSH 连上,选择对应的安装方式:

服务器推荐

平台推荐配置费用说明
阿里云ECS 2核4G / ARM免费试用 / 低至 ¥40/月领取免费试用
腾讯云轻量应用服务器 2核4G免费试用 / 低至 ¥40/月领取免费试用
华为云HECS 2核4G免费试用领取免费试用
AWSt4g.medium (ARM)免费套餐 12 个月Free Tier
GCPe2-medium免费套餐 90 天Free Trial
Oracle CloudARM 4核24G永久免费Always Free
本地 MacM1/M2/M3/M4无需服务器见下方 Mac 安装

💡 推荐 ARM 架构 + 4GB 以上内存。如果只跑司礼监(单 Agent),2GB 内存也够用。

Linux 一键安装

bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/boluobobo-ai-court-tutorial/main/install.sh)

脚本自动完成:

  • ✅ 系统更新 + 防火墙配置(自动适配阿里云/腾讯云/Oracle 等)
  • ✅ 4GB Swap(防 OOM)
  • ✅ Node.js 22 + GitHub CLI + Chromium
  • ✅ OpenClaw 全局安装
  • ✅ 工作区初始化(SOUL.md / IDENTITY.md / USER.md / openclaw.json 多 Agent 模板)
  • ✅ Gateway 系统服务安装(开机自启)

安装脚本带彩色输出和进度提示,每一步都有 ✓ 成功标记。

💡 已经装好 OpenClaw/Clawdbot? 用精简版脚本,跳过系统依赖安装,只初始化工作区和配置模板:

bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/boluobobo-ai-court-tutorial/main/install-lite.sh)

支持两种模式:Discord 多Bot模式 或 纯 WebUI 模式(不需要Discord)。

🍎 macOS 用户? 用 Mac 专用脚本,自动通过 Homebrew 安装所有依赖:

bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/boluobobo-ai-court-tutorial/main/install-mac.sh)

支持 Intel 和 Apple Silicon (M1/M2/M3/M4),自动检测架构。

第二步:填 Key 上线(10 分钟)

跑完脚本,你只需要填两样东西:

  1. LLM API Key → 你的 LLM 服务商控制台
  2. Discord Bot Token(每个部门一个)→ discord.com/developers
# 编辑配置,填入 API Key 和 Bot Token # 配置文件路径取决于安装的包:openclaw 用 ~/.openclaw/openclaw.json,clawdbot 用 ~/.clawdbot/clawdbot.json nano ~/.openclaw/openclaw.json # 启动朝廷 systemctl --user start openclaw-gateway # 验证 systemctl --user status openclaw-gateway

在 Discord @你的 Bot 说句话,收到回复就成功了。

第三步:全六部上线 + 自动化(15 分钟)

@兵部 帮我写个用户登录的 API → 兵部(强力模型):完整代码 + 架构建议,大任务自动开 Thread @户部 这个月 API 花了多少钱 → 户部(强力模型):费用明细 + 优化建议 @礼部 写条小红书文案,主题是 AI 工具推荐 → 礼部(快速模型):文案 + 标签建议 @everyone 明天下午开会,各部门准备周报 → 所有 Agent 各自回复确认

配置自动日报:

# 获取 Gateway Token openclaw gateway token # 每天 22:00(北京时间)自动生成日报 openclaw cron add \ --name "每日日报" --agent main \ --cron "0 22 * * *" --tz "Asia/Shanghai" \ --message "生成今日日报,写入 Notion 并发送到 Discord" \ --session isolated --token <你的token>

实战案例:菠萝王朝

以下是基于本项目搭建的真实运行中的 AI 朝廷——菠萝王朝,展示 14 个 Agent 协同运作的完整架构。

菠萝王朝组织架构

┌──────────────────────┐ │ 菠萝皇帝(你) │ │ Discord + 多端推送 │ └──────────┬───────────┘ │ ┌────────────────────┼────────────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ 司礼监 │ │ 内阁首辅 │ │ 都察院 │ │ 大内总管 │ │ 战略谋划 │ │ 左都御史 │ │ 批红·调度·统领 │ │ 票拟·直谏 │ │ 纠劾·审查·质控 │ └───────┬────────┘ └────────────────┘ └────────────────┘ │ ┌───────────┼───────────────────────────────────┐ │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ 兵部 │ │ 户部 │ │ 礼部 │ │ 工部 │ │ 刑部 │ │ 吏部 │ │软件工程│ │财务预算│ │品牌营销│ │基础设施│ │法务合规│ │人事考核│ │架构部署│ │成本管控│ │社媒公关│ │DevOps │ │风控审查│ │团队管理│ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ ┌───────────────────────────────────────────────┐ │ 🏛️ 辅助机构 │ ├────────┬────────┬────────┬────────┬────────────┤ │ 国子监 │ 翰林院 │ 太医院 │ 内务府 │ 御膳房 │ │教育培训 │文书起草 │健康管理 │日程后勤 │膳食推荐 │ │知识管理 │论文研究 │营养规划 │起居安排 │食谱研究 │ └────────┴────────┴────────┴────────┴────────────┘

菠萝王朝运作实况

14 个 Agent,各有专属 Discord Bot,24/7 在线运转:

机构Agent日常工作示例
司礼监大内总管接收圣旨、分派任务、协调各部、Cron 调度
内阁首辅大学士商业战略分析、竞品研究、全局决策建议
都察院左都御史代码审查、质量把关、纠正各部错误
兵部尚书全栈开发、GitHub PR、系统架构、Bug 修复
户部尚书市场数据分析、API 成本追踪、财务报表
礼部尚书社媒运营、文案创作、品牌推广
工部尚书服务器运维、CI/CD、基础设施巡检
刑部尚书开源合规、知识产权维权、合同审查
吏部尚书项目管理、创业孵化、人事考核
国子监祭酒课程学习辅导、学习规划、知识整理
翰林院学士论文写作、读书笔记、技术文档
太医院院使健康提醒、饮食建议、运动计划
内务府总管日程管理、天气查询、出行提醒
御膳房总管美食推荐、食谱研究、外卖选择

自动化 Cron 任务(实际运行中)

任务频率描述
每日简报每天 08:00自动汇总 GitHub、天气、待办,推送到手机
市场盘前分析工作日 09:15户部自动拉取市场数据,生成分析报告,多渠道推送
起居注每天 22:30史官自动记录当日大事,写入 Notion 起居注数据库
礼部日报每天 14:00礼部汇报社媒运营数据

Notion 史记式知识库

菠萝王朝使用 Notion 作为「国史馆」,完整存档所有决策和数据:

🏯 菠萝王朝 ├── 本纪(时间线) │ ├── 起居注(日报) ← 每日自动写入 │ ├── 朔望录(周报) ← 每周自动汇总 │ ├── 编年纪(月报) ← 每月自动总结 │ └── 大事记 ← 里程碑事件 ├── 表(数据看板) │ ├── 食货表(财务) ← 户部管理 │ ├── 舆情表(社媒) ← 礼部管理 │ ├── 臣工表(人脉) ← 吏部管理 │ └── 器用表(工具) ← 工部管理 ├── 志(知识库) │ ├── 天工志(技术) ← 兵部/工部 │ ├── 宣化志(运营) ← 礼部 │ ├── 经籍志(学业) ← 国子监 │ └── 典章志(SOP) ← 各部流程 └── 列传(项目档案) └── 11个项目独立档案 ← 全生命周期管理

💡 这不是 demo,是每天在用的生产系统。 菠萝王朝已稳定运行数周,处理过数百个实际任务——从代码开发到内容运营,从数据分析到项目管理。


朝廷架构——三省六部制

历史背景

三省六部制是中国古代的中央官制体系:

  • 中书省:起草诏令(= 接收用户指令、生成计划)
  • 门下省:审核驳回(= 消息路由、权限校验)
  • 尚书省:执行落实(= Skill 工具层、实际执行)

尚书省下设六部,各管一摊。在本项目中,OpenClaw Gateway 扮演三省的角色,六个 AI Agent 对应六部:

部门古代职责AI 职责推荐模型典型场景
司礼监皇帝近侍、批红总管调度快速模型日常对话、任务分配、自动汇报
兵部军事武备软件工程强力模型写代码、架构设计、代码审查、Bug 调试
户部户籍财税财务运营强力模型成本分析、预算管控、电商运营
礼部礼仪外交品牌营销快速模型文案创作、社媒运营、内容策划
工部工程营造运维部署快速模型DevOps、CI/CD、服务器管理
吏部官员选拔项目管理快速模型创业孵化、任务追踪、团队协调
刑部司法刑狱法务合规快速模型合同审查、知识产权、合规检查

💡 模型分层策略:重活(编码/分析)用 强力模型,轻活(文案/管理)用 快速模型,能省 5 倍成本。也可以接入 经济模型 等国产模型进一步降本。

多 Provider 混搭(可选)

默认模板用单一 Provider,但你可以同时接入多家,给不同部门分配不同模型:

// openclaw.json 中的 models.providers 支持多个 { "models": { "providers": { "anthropic": { "baseUrl": "https://api.anthropic.com", "apiKey": "sk-ant-xxx", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5", "input": ["text", "image"], "contextWindow": 200000, "maxTokens": 8192 } ] }, "deepseek": { "baseUrl": "https://api.deepseek.com/v1", "apiKey": "sk-xxx", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek V3", "input": ["text"], "contextWindow": 128000, "maxTokens": 8192 } ] } } } }

然后在 agents.list 里按需分配:

{ "id": "bingbu", "model": { "primary": "anthropic/claude-sonnet-4-5" } }, // 重活用 Claude { "id": "libu", "model": { "primary": "deepseek/deepseek-chat" } } // 轻活用 DeepSeek 省钱

格式:provider名/模型id。支持任何兼容 OpenAI API 格式的服务商(Ollama、通义千问、Gemini 等),详见 OpenClaw 模型配置文档


核心能力

多 Agent 协作

每个部门是独立 Bot,@谁谁回复,@everyone 全员响应。大任务自动新建 Thread 保持频道整洁。

⚠️ 想让 Bot 之间互相触发(如成语接龙、多 Bot 讨论),需在 openclaw.jsonchannels.discord 中加上 "allowBots": true。不加的话 Bot 默认忽略其他 Bot 的消息。同时每个 account 都要设置 "groupPolicy": "open",否则群聊消息会被静默丢弃。

独立记忆系统

每个 Agent 有独立的工作区和 memory/ 目录。对话积累的项目知识会持久化到文件,跨会话保留。Agent 越用越懂你的项目。

60+ 内置 Skill(基于 OpenClaw 生态)

不只是聊天——内置的工具覆盖开发全流程,且可通过 OpenClaw Hub 扩展更多 Skill:

类别Skill
开发GitHub(Issue/PR/CI)、Coding Agent(代码生成与重构)
文档Notion(数据库/页面/自动汇报)
信息浏览器自动化、Web 搜索、Web 抓取
自动化Cron 定时任务、心跳自检
媒体TTS 语音、截图、视频帧提取
运维tmux 远程控制、Shell 命令执行
通信Discord、Slack、飞书(Lark)、Telegram、WhatsApp、Signal…
扩展OpenClaw Hub 社区 Skill、自定义 Skill

定时任务(Cron)

内置 Cron 调度器,让 Agent 定时自动执行:

  • 每天自动写日报,发到 Discord + 存到 Notion
  • 每周汇总周报
  • 定时健康检查、代码备份
  • 自定义任意定时任务

好友协作

邀请朋友进 Discord 服务器,所有人都能 @各部门 Bot 下达指令。互不干扰,结果大家都能看到。

沙箱隔离

Agent 可以运行在 Docker 沙箱中,代码执行互不干扰。支持配置网络、文件系统、环境变量的隔离级别。


GUI 管理界面

除了 Discord 命令行交互,AI 朝廷还提供多种图形界面(GUI)管理方式:

Web 管理后台(菠萝王朝 Dashboard)

本项目内置了一套 Web 管理后台(gui/ 目录),基于 React + TypeScript + Vite 构建:

朝堂总览 — 各部门状态一目了然
朝堂总览 — 御座、六部、诸院,在线状态一目了然

会话管理 — Token 消耗、消息统计
会话管理 — 88 个会话、9008 条消息、87.34M Token 消耗实时追踪

功能包括:

  • 仪表盘:实时查看各部门状态、Token 消耗、系统负载
  • 朝堂:直接在 Web 端与各部门 Bot 对话
  • 会话管理:查看所有历史会话、消息详情、Token 统计
  • 定时任务:可视化管理 Cron 任务(启用/禁用/手动触发)
  • Token 统计:按部门、按日期的 Token 消耗分析
  • 系统健康:CPU/内存/磁盘监控、Gateway 状态

启动方式:

# 1. 先 clone 教程仓库(如果还没有) git clone https://github.com/wanikua/boluobobo-ai-court-tutorial.git cd boluobobo-ai-court-tutorial # 2. 构建前端 cd gui && npm install && npm run build # 3. 安装后端依赖并启动(设置登录密码) cd server && npm install BOLUO_AUTH_TOKEN=你的密码 node index.js

⚠️ 登录密码说明:启动后端时通过环境变量 BOLUO_AUTH_TOKEN 设置登录密码。打开页面后用这个密码登录。如果不想要密码验证,需要修改 server/index.js 中的 authMiddleware

访问地址:http://你的服务器IP:18790

💡 生产环境建议通过 Nginx 反向代理 + HTTPS 访问,不要直接暴露端口。长期运行建议用 pm2screenBOLUO_AUTH_TOKEN=你的密码 pm2 start server/index.js --name boluo-gui

Discord 作为 GUI

Discord 本身就是最佳的 GUI 管理界面:

  • 手机 + 电脑同步,随时随地管理
  • 频道分类天然对应各部门(兵部、户部、礼部…)
  • 消息历史永久保存,自带搜索
  • 权限管理精细控制谁能看什么、谁能操作什么
  • @mention 即可调用任意 Agent,零学习成本

Notion 作为数据可视化补充

通过 OpenClaw 的 Notion Skill 集成,朝廷的数据可以自动同步到 Notion:

  • 起居注(日报)、**朔望录(周报)**自动生成
  • **食货表(财务)**自动记录 API 消耗
  • **列传(项目)**追踪各项目进展
  • Notion 的看板、日历、表格视图提供丰富的数据可视化

💡 三层 GUI 配合使用:Web Dashboard 看系统状态 → Discord 下达指令 → Notion 查看报表和历史数据。


详细教程

基础篇(服务器申请→安装→配置→跑起来)和进阶篇(tmux、GitHub、Notion、Cron、Discord、Prompt 技巧)见小红书系列笔记。


📱 接入飞书(Feishu/Lark)

除了 Discord,AI 朝廷也支持飞书作为交互界面。飞书插件已内置在新版 OpenClaw 中,无需额外安装。

第一步:创建飞书应用

  1. 访问 飞书开放平台,登录后点击 创建企业自建应用
  2. 填写应用名称和描述,选择图标
  3. 凭证与基础信息 页面,复制 App ID(格式 cli_xxx)和 App Secret

第二步:配置权限和能力

  1. 添加权限:进入 权限管理,点击 批量导入,粘贴以下内容:
{ "scopes": { "tenant": [ "im:message", "im:message:send_as_bot", "im:message:readonly", "im:message.p2p_msg:readonly", "im:message.group_at_msg:readonly", "im:resource", "im:chat.members:bot_access", "im:chat.access_event.bot_p2p_chat:read" ] } }
  1. 开启机器人能力:进入 应用能力 > 机器人,启用并设置机器人名称

  2. 配置事件订阅:进入 事件订阅,选择 使用长连接接收事件(WebSocket),添加事件 im.message.receive_v1

⚠️ 配置事件订阅前,需要先完成下面第三步并启动 Gateway,否则长连接可能保存失败。

  1. 发布应用:在 版本管理与发布 中创建版本,提交审核发布

第三步:配置 OpenClaw

方式一:命令行向导(推荐)

openclaw channels add # 选择 Feishu,输入 App ID 和 App Secret

方式二:手动编辑配置文件

{ "channels": { "feishu": { "enabled": true, "dmPolicy": "pairing", "accounts": { "main": { "appId": "cli_xxx", "appSecret": "你的App Secret" } } } } }

第四步:启动并测试

# 启动/重启 Gateway openclaw gateway restart # 在飞书里找到你的机器人,发一条消息 # 首次会收到配对码,执行以下命令批准: openclaw pairing approve feishu <配对码>

批准后即可正常聊天。群聊中需要 @机器人 才会触发回复。

💡 飞书使用 WebSocket 长连接,不需要公网IP或域名,本地部署也能用。

📖 完整飞书文档:docs.openclaw.ai/channels/feishu


📝 接入 Notion(自动归档)

AI 朝廷可以通过 Notion Skill 自动写日报、归档数据、管理知识库。配置只需 3 步。

第一步:创建 Notion Integration

  1. 访问 Notion Integrations
  2. 点击 New integration(新建集成)
  3. 填写名称(如「AI 朝廷」),选择关联的 Workspace
  4. 创建后复制 Internal Integration Secret(格式 ntn_xxxsecret_xxx

第二步:存储 API Key

# 创建配置目录并保存 Key mkdir -p ~/.config/notion echo "ntn_你的token" > ~/.config/notion/api_key

第三步:授权页面/数据库

这一步很关键,不做的话 API 会返回 404:

  1. 打开你想让 AI 访问的 Notion 页面或数据库
  2. 点击右上角 ···Connect to(连接到)
  3. 选择你刚创建的 Integration 名称
  4. 子页面会自动继承权限

⚠️ 每个要访问的顶级页面/数据库都需要手动授权一次,Integration 不会自动获得整个 Workspace 的权限。

验证

# 测试 API 是否通了 NOTION_KEY=$(cat ~/.config/notion/api_key) curl -s "https://api.notion.com/v1/users/me" \ -H "Authorization: Bearer $NOTION_KEY" \ -H "Notion-Version: 2025-09-03" | head -c 200

看到返回的 JSON 包含你的 Integration 名称就说明配置成功了。

使用示例

配好后就可以在 Discord 里让 Agent 操作 Notion:

@司礼监 把今天的工作总结写到 Notion 日报里 @户部 创建一个新的财务数据库,字段包含日期、收入、支出、备注 @礼部 把这周的社媒数据更新到 Notion 舆情表

💡 Notion 适合做持久化存档(日报/周报/知识库),Discord 适合做实时交互,两者配合效果最佳。

📖 Notion API 文档:developers.notion.com


🏥 配置诊断(doctor.sh)

遇到问题?跑一行命令自动检查配置:

bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/boluobobo-ai-court-tutorial/main/doctor.sh)

诊断内容包括:

  • ✅ OpenClaw/Node.js 安装检查
  • ✅ 配置文件格式和 API Key 检查
  • ✅ Discord Bot Token、allowBots、groupPolicy 检查
  • ✅ Agent 和 Binding 路由匹配检查
  • ✅ 工作区文件(SOUL.md / USER.md / memory/)检查
  • ✅ Notion 等可选集成检查
  • @everyone 不触发的完整排查清单

@everyone 不触发 Bot 回复?

这是最常见的问题,通常原因是 Discord Developer Portal 的 Intent 没开

  1. 打开 Discord Developer Portal
  2. 选择你的 Bot → 左侧 Bot 页面
  3. 往下翻到 Privileged Gateway Intents,开启以下三项:
    • Message Content Intent(必须)
    • Server Members Intent(必须)
    • Presence Intent(可选)
  4. 每个 Bot 都要开,不是只开一个!
  5. 确认服务器里每个 Bot 的角色有 View Channels 权限
  6. 确认配置文件里 channels.discord.groupPolicy 和每个 account 的 groupPolicy 都是 "open"

⚠️ 改完 Intent 后需要重启 Gatewayopenclaw gateway restartsystemctl --user restart openclaw-gateway


常见问题

基础问题

Q: 需要会写代码吗? 不需要。一键脚本搞定安装,配置文件填几个 Key 就行。所有交互都是在 Discord 里用自然语言。

Q: 和直接用 ChatGPT 有什么区别? ChatGPT 是一个通才,对话结束就失忆。这套系统是多个专家——每个 Agent 有自己的专业领域、持久记忆和工具权限。能自动写代码提交 GitHub、自动写文档到 Notion、定时执行任务。

Q: 能用其他模型吗? 能。OpenClaw 支持 Anthropic、OpenAI、Google Gemini 等主流服务商,也可接入其他兼容 OpenAI API 格式的服务商。在 openclaw.json 里改 model 配置就行。不同部门可以用不同模型。

Q: 每月 API 费用大概多少? 看使用强度。轻度使用 1015/月,中度10-15/月,中度 20-30/月。省钱技巧:重活用 强力模型,轻活用 快速模型(便宜约 5 倍),简单任务可接入 经济模型 等国产模型进一步降本。

Q: 和 Become CEO 项目有什么关系? Become CEO 是本项目的英文企业版,使用相同的 OpenClaw 框架和架构,只是将朝廷角色换成了现代企业角色(CTO、CFO 等)。喜欢中国古代风格选 AI 朝廷,喜欢现代企业风格选 Become CEO。

技术问题

Q: @everyone 不触发 Agent 回复? Discord Developer Portal 里每个 Bot 要开启 Message Content IntentServer Members Intent,服务器里 Bot 角色要有 View Channels 权限。OpenClaw 会把 @everyone 当作对每个 Bot 的显式 mention,权限到位就能触发。

Q: 开了 sandbox 后 Agent 报没有权限写文件? sandbox mode 设成 all 会把 Agent 跑在 Docker 容器里,默认只读文件系统、断网、不继承环境变量。解决方法:

"sandbox": { "mode": "all", "workspaceAccess": "rw", "docker": { "network": "bridge", "env": { "LLM_API_KEY": "你的LLM_API_KEY" } } }
  • workspaceAccess: "rw" — 让沙箱能读写工作目录
  • docker.network: "bridge" — 允许联网
  • docker.env — 传入 API Key(沙箱不继承主机环境变量)

Q: 多人同时 @ 同一个 Agent 会冲突吗? 不会。OpenClaw 为每个用户 × Agent 组合维护独立的会话(session)。多人同时 @兵部,各自的对话互不干扰。

Q: Agent 之间能互相调用吗? 能。Agent 可以通过 sessions_spawn 产生子任务给其他 Agent,也可以通过 sessions_send 发消息给其他 Agent 的会话。比如司礼监可以把编码任务派给兵部。

Q: 怎么自定义 Skill? OpenClaw 有内置的 Skill Creator 工具,可以创建自定义 Skill。每个 Skill 是一个包含 SKILL.md(指令)+ 脚本 + 资源的目录。放到工作区的 skills/ 目录下即可被 Agent 使用。也可以从 OpenClaw Hub 获取社区共享的 Skill。

Q: 怎么接入私有模型(Ollama 等)?openclaw.jsonmodels.providers 中添加兼容 OpenAI API 格式的 provider,指定 baseUrl 到你的 Ollama 地址即可。Ollama 本地模型零 API 费用。

Q: Gateway 启动失败怎么排查?

# 查看详细日志 journalctl --user -u openclaw-gateway --since today --no-pager # 配置检查 openclaw doctor # 常见原因:API Key 未填、JSON 格式错误、Bot Token 无效

加入朝会

小红书「菠萝菠菠🍍」公众号「菠言菠语」微信群「OpenClaw 皇帝交流群」
@菠萝菠菠🍍关注获取最新教程和更新群二维码过期请关注公众号获取最新入口

🤝 推荐

相关链接

免责声明 / Disclaimer

本项目按"原样"提供,不承担任何直接或间接责任。/ This project is provided "as is" without any warranties.

使用前请注意 / Please note:

  1. AI 生成内容仅供参考 / AI-generated content is for reference only

    • AI 生成的代码、文案、建议等可能存在错误或不准确之处
    • 使用前请自行审核,确认无风险后再实际应用
    • Code, suggestions, etc. may contain errors. Please review before using in production.
  2. 代码安全 / Code Security

    • 自动生成的代码建议在合并前进行 code review
    • 涉及财务、安全敏感的操作请务必人工复核
    • Review AI-generated code before merging. Human review required for financial/sensitive operations.
  3. API 密钥安全 / API Key Security

    • 请妥善保管您的 API 密钥 / Keep your API keys safe
    • 不要将包含密钥的配置文件提交到公开仓库 / Don't commit config files with keys to public repos
  4. 服务器费用 / Server Costs

    • 免费服务器(云服务商 等)有一定使用限额 / Free servers have usage limits
    • 超出限额后可能产生费用,请留意账单 / Excess usage may incur charges
  5. 数据备份 / Data Backup

    • 建议定期备份您的工作区和数据 / Regularly backup your workspace
    • 本项目不提供任何数据保证 / This project provides no data guarantees

v3.5 | MIT License

📜 This project is licensed under MIT. If you create derivative works or projects inspired by this architecture, please credit the original: boluobobo-ai-court-tutorial by @wanikua