mirror of
https://mirror.skon.top/github.com/cft0808/edict
synced 2026-04-20 21:00:16 +08:00
b91675bc4c
新增功能: - 朝堂议政(Court Discussion): 多官员围绕议题展开部门视角讨论 - 后端 court_discuss.py + 前端 CourtDiscussion.tsx - 集成 GitHub Copilot API (gpt-4o) - 各部门依据 SOUL.md 职责发表专业意见 GitHub Issues 修复: - #127: 模型下拉列表自动合并 openclaw.json 已配置模型 - #83: install.sh 安装时设置 sessions.visibility all - #88: install.sh 用 symlink 统一各 workspace 的 data/scripts - #80: 调度器 stallThreshold 180s→600s, maxRetry 1→2 - #124: skill_manager 增加镜像回退 + 自定义 Hub URL - #132: sync_from_openclaw_runtime 放宽过滤,保留 Review 状态任务
202 lines
5.0 KiB
Markdown
202 lines
5.0 KiB
Markdown
# 🚀 快速上手指南
|
||
|
||
> 从零开始，5 分钟搭建你的三省六部 AI 协同系统
|
||
|
||
---
|
||
|
||
## 第一步：安装 OpenClaw
|
||
|
||
三省六部基于 [OpenClaw](https://openclaw.ai) 运行，请先安装：
|
||
|
||
```bash
|
||
# macOS
|
||
brew install openclaw
|
||
|
||
# 或下载安装包
|
||
# https://openclaw.ai/download
|
||
```
|
||
|
||
安装完成后初始化：
|
||
|
||
```bash
|
||
openclaw init
|
||
```
|
||
|
||
## 第二步：克隆并安装三省六部
|
||
|
||
```bash
|
||
git clone https://github.com/cft0808/edict.git
|
||
cd edict
|
||
chmod +x install.sh && ./install.sh
|
||
```
|
||
|
||
安装脚本会自动完成：
|
||
- ✅ 创建 12 个 Agent Workspace（`~/.openclaw/workspace-*`）
|
||
- ✅ 写入各省部 SOUL.md 人格文件
|
||
- ✅ 注册 Agent 及权限矩阵到 `openclaw.json`
|
||
- ✅ 配置旨意数据清洗规则
|
||
- ✅ 构建 React 前端到 `dashboard/dist/`（需 Node.js 18+）
|
||
- ✅ 初始化数据目录
|
||
- ✅ 执行首次数据同步
|
||
- ✅ 重启 Gateway 使配置生效
|
||
|
||
## 第三步：配置消息渠道
|
||
|
||
在 OpenClaw 中配置消息渠道（Feishu / Telegram / Signal），将 `taizi`（太子）Agent 设为旨意入口。太子会自动分拣闲聊与指令，指令类消息提炼标题后转发中书省。
|
||
|
||
```bash
|
||
# 查看当前渠道
|
||
openclaw channels list
|
||
|
||
# 添加飞书渠道（入口设为太子）
|
||
openclaw channels add --type feishu --agent taizi
|
||
```
|
||
|
||
参考 OpenClaw 文档：https://docs.openclaw.ai/channels
|
||
|
||
## 第四步：启动服务
|
||
|
||
```bash
|
||
# 终端 1：数据刷新循环（每 15 秒同步）
|
||
bash scripts/run_loop.sh
|
||
|
||
# 终端 2：看板服务器
|
||
python3 dashboard/server.py
|
||
|
||
# 打开浏览器
|
||
open http://127.0.0.1:7891
|
||
```
|
||
|
||
> 💡 **提示**：`run_loop.sh` 每 15 秒自动同步数据。可用 `&` 后台运行。
|
||
|
||
> 💡 **看板即开即用**：`server.py` 内嵌 `dashboard/dashboard.html`，无需额外构建。Docker 镜像包含预构建的 React 前端。
|
||
|
||
## 第五步：发送第一道旨意
|
||
|
||
通过消息渠道发送任务（太子会自动识别并转发到中书省）：
|
||
|
||
```
|
||
请帮我用 Python 写一个文本分类器：
|
||
1. 使用 scikit-learn
|
||
2. 支持多分类
|
||
3. 输出混淆矩阵
|
||
4. 写完整的文档
|
||
```
|
||
|
||
## 第六步：观察执行过程
|
||
|
||
打开看板 http://127.0.0.1:7891
|
||
|
||
1. **📋 旨意看板** — 观察任务在各状态之间流转
|
||
2. **🔭 省部调度** — 查看各部门工作分布
|
||
3. **📜 奏折阁** — 任务完成后自动归档为奏折
|
||
|
||
任务流转路径：
|
||
```
|
||
收件 → 太子分拣 → 中书规划 → 门下审议 → 已派发 → 执行中 → 已完成
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 进阶用法
|
||
|
||
### 使用圣旨模板
|
||
|
||
> 看板 → 📜 旨库 → 选择模板 → 填写参数 → 下旨
|
||
|
||
9 个预设模板：周报生成 · 代码审查 · API 设计 · 竞品分析 · 数据报告 · 博客文章 · 部署方案 · 邮件文案 · 站会摘要
|
||
|
||
### 切换 Agent 模型
|
||
|
||
> 看板 → ⚙️ 模型配置 → 选择新模型 → 应用更改
|
||
|
||
约 5 秒后 Gateway 自动重启生效。
|
||
|
||
### 管理技能
|
||
|
||
> 看板 → 🛠️ 技能配置 → 查看已安装技能 → 点击添加新技能
|
||
|
||
### 叫停 / 取消任务
|
||
|
||
> 在旨意看板或任务详情中，点击 **⏸ 叫停** 或 **🚫 取消** 按钮
|
||
|
||
### 订阅天下要闻
|
||
|
||
> 看板 → 📰 天下要闻 → ⚙️ 订阅管理 → 选择分类 / 添加源 / 配飞书推送
|
||
|
||
---
|
||
|
||
## ❓ 故障排查
|
||
|
||
### 看板显示「服务器未启动」
|
||
```bash
|
||
# 确认服务器正在运行
|
||
python3 dashboard/server.py
|
||
```
|
||
|
||
### Agent 报错 "No API key found for provider"
|
||
|
||
这是最常见的问题。三省六部有 11 个 Agent，每个都需要 API Key。
|
||
|
||
```bash
|
||
# 方法一：为任意 Agent 配置后重新运行 install.sh（推荐）
|
||
openclaw agents add taizi # 按提示输入 Anthropic API Key
|
||
cd edict && ./install.sh # 自动同步到所有 Agent
|
||
|
||
# 方法二：手动复制 auth 文件
|
||
MAIN_AUTH=$(find ~/.openclaw/agents -name auth-profiles.json | head -1)
|
||
for agent in taizi zhongshu menxia shangshu hubu libu bingbu xingbu gongbu; do
|
||
mkdir -p ~/.openclaw/agents/$agent/agent
|
||
cp "$MAIN_AUTH" ~/.openclaw/agents/$agent/agent/auth-profiles.json
|
||
done
|
||
|
||
# 方法三：逐个配置
|
||
openclaw agents add taizi
|
||
openclaw agents add zhongshu
|
||
# ... 其他 Agent
|
||
```
|
||
|
||
### Agent 不响应
|
||
```bash
|
||
# 检查 Gateway 状态
|
||
openclaw gateway status
|
||
|
||
# 必要时重启
|
||
openclaw gateway restart
|
||
```
|
||
|
||
### 数据不更新
|
||
```bash
|
||
# 检查刷新循环是否运行
|
||
ps aux | grep run_loop
|
||
|
||
# 手动执行一次同步
|
||
python3 scripts/refresh_live_data.py
|
||
```
|
||
|
||
### 心跳显示红色 / 告警
|
||
```bash
|
||
# 检查对应 Agent 的进程
|
||
openclaw agent status <agent-id>
|
||
|
||
# 重启指定 Agent
|
||
openclaw agent restart <agent-id>
|
||
```
|
||
|
||
### 模型切换后不生效
|
||
等待约 5 秒让 Gateway 重启完成。仍不生效则：
|
||
```bash
|
||
python3 scripts/apply_model_changes.py
|
||
openclaw gateway restart
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 更多资源
|
||
|
||
- [🏠 项目首页](https://github.com/cft0808/edict)
|
||
- [📖 README](../README.md)
|
||
- [🤝 贡献指南](../CONTRIBUTING.md)
|
||
- [💬 OpenClaw 文档](https://docs.openclaw.ai)
|
||
- [📮 公众号 · cft0808](wechat.md) — 架构拆解 / 踩坑复盘 / Token 省钱术
|