📋 架构设计指导文档
壹辰 AI 数据运营系统
基于 OpenClaw 的多 Agent 协同架构设计,目标实现:数据自动采集 → AI 智能分析 → 可视化报告 → 微信推送全链路无人值守运营。
📅 制定日期:2026-03-21
👤 设计者:小龙虾 AI
🔄 版本:v1.0
📁 文档位置:/workspace/SPEC-壹辰多Agent系统.md
🗄️ 四、核心数据结构
4.1 任务队列(agent_queue.json)
{
"tasks": [
{
"id": "task_20260321_001",
"store": "十一店",
"raw": "到店1 留客1 业绩722",
"parsed": { "daodian": 1, "liuke": 1, "yeji": 722 },
"status": "parsed",
"created_at": "2026-03-21T11:24:00+08:00"
}
],
"pending_stores": ["三店","六店","九店","十五店","十六店"],
"date": "2026-03-21"
}
4.2 日报数据(data/daily/YYYY-MM-DD.json)
{
"date": "2026-03-21",
"stores": {
"十一店": { "daodian": 1, "liuke": 1, "yeji": 722,
"channels": { "meituan":0,"douyin":0,"shangmen":1 },
"reported_by": "aKeLiTiNaJinJin",
"reported_at": "2026-03-21T11:24:00+08:00" }
},
"summary": {
"total_daodian": 1, "total_liuke": 1, "total_yeji": 722,
"report_rate": "3/8"
}
}
✅ 核心设计原则:所有 Agent 通过读写 JSON 文件通信,实现真正的去中心化松耦合协作,任意一个 Agent 重启都不影响其他 Agent 运行。
⚙️ 六、技术栈选型
| 层级 | 技术选型 | 说明 |
| 调度层 | OpenClaw Cron | 定时触发入口,配置在 openclaw.json |
| Agent 运行时 | OpenClaw Sessions Spawn | Sub-agent 执行环境,隔离运行 |
| 通信中枢 | JSON 文件(agent_queue.json) | 跨 Agent 共享状态,文件系统级别隔离 |
| 历史存储 | JSON 文件(data/daily/*.json) | 持久化数据,轻量无需额外服务 |
| 报告渲染 | React + Vite + TailwindCSS | 可视化仪表盘,HTML5 可分享 |
| 消息推送 | WeCom Bot(message tool) | 下发通道,对接企微 |
| 长期记忆 | MEMORY.md + memory/*.md | Agent 持久记忆 |
| Web 服务 | OpenClaw 内置 / minimax space | Dashboard 部署 |
6.1 目录结构
/workspace/
├── agent_queue.json # ★ 实时任务队列(共享状态中枢)
├── agents/ # ★ Agent 模块
│ ├── __init__.py # 队列管理 + 消息解析引擎
│ ├── collector.py # 数据接收 Agent
│ ├── analyzer.py # 数据分析 Agent
│ ├── reporter.py # 报告生成 Agent
│ └── alerter.py # 异常告警 Agent
├── data/
│ ├── daily/ # ★ 日数据文件(YYYY-MM-DD.json)
│ │ ├── 2026-03-20.json
│ │ └── 2026-03-21.json
│ └── monthly/ # 月度汇总
├── reports/ # 生成的 HTML 日报
├── cron_scripts/ # Cron 执行脚本
│ ├── daily_reset.py # 09:58 重置队列
│ ├── send_template.py # 10:00 发送模板
│ ├── check_pending.py # 10:30 检查 pending
│ ├── reminder.py # 11:00 / 15:00 催报
│ └── generate_report.py # 12:00 生成报告
├── dashboard/ # React 可视化仪表盘
│ └── dist/ # 构建产物
├── memory/ # 每日日志 + 长期记忆
├── SPEC-壹辰多Agent系统.md # ★ 本架构规格文档
└── 架构设计指导文档.html # ★ 本文档(HTML版)
🧠 十、多模型协同架构
10.1 Router 模式(意图路由)
用户消息 → 意图分类(小模型)→ 分发到对应 LLM
📊 数据分析任务
→ DeepSeek / Qwen
✍️ 内容创作任务
→ GPT-4o / Claude
🔍 深度推理任务
→ Claude 3.5 Opus
10.2 Pipeline 模式(串行处理链)
10.3 OpenClaw 中的模型配置
{
"models": {
"providers": {
"minimax": { "baseUrl": "...", "apiKey": "sk-..." },
"deepseek": { "baseUrl": "...", "apiKey": "sk-..." },
"openrouter": {
"baseUrl": "https://openrouter.ai/api/v1",
"apiKey": "sk-or-xxxx" // OpenRouter 支持支付宝
}
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat", // 默认模型
"models": [
{ "id": "minimax/max", "provider": "minimax" },
{ "id": "deepseek/deepseek-chat", "provider": "deepseek" },
{ "id": "openai/gpt-4o", "provider": "openrouter" },
{ "id": "anthropic/claude-3.5-sonnet", "provider": "openrouter" }
]
}
}
}
}
}