夜雨聆风
Openclaw上部署Zoe集群部署文档
1. 系统架构
# 1.1 双层 AI 编排架构
“`
┌─────────────────────────────────────────────────────────┐
│编排层(Zoe)│
│OpenClaw QQBot/飞书 – 业务上下文、任务拆解、监控│
│位置：/root/.openclaw/extensions/qqbot/│
└─────────────────────────────────────────────────────────┘
│┌───────────────────┼───────────────────┬──────────────────┐
▼▼▼▼
┌───────────────┐┌───────────────┐┌───────────────┐┌───────────────┐
│Codex││Claude Code││OpenCode││Qwen Code│
│后端/复杂││前端/Git││UI/设计││快速编码│
│v0.107.0││v2.1.68││v1.2.16││v0.11.1│
└───────┘ └───────────────┘└───────────────┘└───────────────┘
1.2 核心工作流程
1. 需求理解 → Zoe 接收飞书/QQ 任务，拆解为技术子任务
2. Agent 启动 → 创建Git
2.外部服务
2.1OpenClaw平台
|项目|配置|
|——|——|
|安装位置|/root/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw|
|工作空间|/root/.openclaw/workspace|
|当前模型|bailian/qwen3.5-plus|
|Channel|feishu|
2.2QQBot插件
2.3飞书集成
2.4邮件通知
|项目|配置|
3.部署文件清单
3.1项目结构
位置：/root/.openclaw/workspace/agent-orchestrator/
agent-orchestrator/
├──scripts/
│├──zoe-orchestrator.pyZoe核心编排逻辑(22KB)
│├──zoe-orchestrator.shZoeShell版本(8KB)
│├──start-zoe.sh启动脚本(3KB)
│├──check-agents.sh健康检查(4KB)
│├──status.sh状态面板(6KB)
│├──setup-agents.shAgent配置(2KB)
│├──email-notifier.py邮件通知(7KB)
│├──test-email.py邮件测试(2KB)
│├──feishu-integration.py飞书集成(7KB)
│├──feishu-sync.py飞书同步(4KB)
│├──task-bridge.py任务桥接(4KB)
│├──send-email-report.sh邮件报告脚本(9KB)
│├──sync-feishu.sh飞书同步脚本(4KB)
│└──notify-qqbot.shQQBot通知(2KB)
├──config/
│├──zoe.config.json主配置文件(1.6KB)
│├──models.env模型API配置⚠️敏感
│├──feishu.env飞书配置⚠️敏感
│├──email.env邮箱配置⚠️敏感
│├──codex-config.tomlCodex配置
│├──claude-settings.jsonClaudeCode配置
│├──qwen-code-settings.jsonQwenCode配置
│└──opencode-settings.jsonOpenCode配置
├──docs/
│├──AGENT_SETUP.mdAI编辑器配置指南
│├──EMAIL_SETUP.md邮箱配置指南
│├──DELIVERY.md交付报告
│└──QWEN_CODE_SETUP.mdQwenCode配置指南
├──.clawdbot/
│└──active-tasks.json任务状态数据库
├──worktrees/Gitworktree隔离目录
├──logs/日志目录
└──README.md项目说明
3.2核心配置(zoe.config.json)
“`json
{
“system”:{
“name”:”Zoe”,
“role”:”orchestrator”,
“version”:”1.0.0″
},
“agents”:{
“claude-code”:{
“command”:”claude”,
“model”:”qwen3.5-plus”,
“specialty”:[“frontend”,”git-operations”]
},
“codex”:{
“command”:”codex”,
“model”:”qwen3.5-plus”,
“specialty”:[“backend”,”complex-tasks”]
},
“opencode”:{
“command”:”opencode”,
“model”:”qwen3.5-plus”,
“specialty”:[“ui-design”,”spec-generation”]
}
},
“workflow”:{
“monitorIntervalMinutes”:10,
“maxRetries”:3,
“worktreeBase”:”/root/.openclaw/workspace/agent-orchestrator/worktrees”,
“logsBase”:”/root/.openclaw/workspace/agent-orchestrator/logs”
},
“notifications”:{
“channel”:”qqbot”,
“feishuDocToken”:”——————“,
“email”:{
“enabled”:true,
“smtp”:”smtp.qq.com:587″,
“from”:”—————–“,
“to”:”——————–“,
“dailyReportTime”:”20:00″
}
}
}
“`
—
4.Agent配置详解
4.1AI编码器版本与选型
|Agent|版本|默认模型|专长领域|使用场景|
|——-|——|———-|———-|———-|
|Codex|v0.107.0|qwen3-coder-plus|后端/复杂任务|API开发、数据库、重构|
|ClaudeCode|v2.1.68|qwen3.5-plus|前端/Git操作|UI开发、PR管理|
|OpenCode|v1.2.16|MiniMax-M2.5|UI/设计|设计稿实现、规范生成|
|QwenCode|v0.11.1|qwen3-coder-plus|快速编码|小修小补、快速迭代|
4.2Agent选择策略
|任务类型|推荐Agent|理由|
|———|———–|——|
|后端API|Codex|擅长逻辑、类型安全|
|前端UI|ClaudeCode|Git操作友好|
|设计稿实现|OpenCode|先设计后实现|
|复杂重构|Codex|上下文理解强|
|快速编码|QwenCode|免费快速响应|
|小修小补|QwenCode|轻量级任务|
4.3DashScopeAPI配置
可用模型列表:
|模型|上下文|最大Token|特点|
|——|——–|———–|——|
|qwen3.5-plus|1M|65536|均衡型|
|qwen3-max-2026-01-23|256K|65536|最强推理|
|qwen3-coder-plus|1M|65536|代码专用⭐|
|qwen3-coder-next|256K|65536|快速代码|
|MiniMax-M2.5|1M|65536|通用型⭐|
|glm-5|202K|16384|智谱AI|
|glm-4.7|202K|16384|智谱AI|
|kimi-k2.5|256K|32768|月之暗面|
4.4配置文件位置
|编辑器|配置文件|
|——–|———-|
|Codex|~/.codex/config.toml|
|ClaudeCode|~/.claude/settings.json|
|QwenCode|~/.qwen/settings.json|
|OpenCode|~/.opencode/settings.json|
—
5.环境配置
5.1敏感文件清单(禁止提交Git)
-config/models.env-APIKeys
-config/feishu.env-飞书AppSecret
-config/email.env-邮箱授权码
-.clawdbot/active-tasks.json-任务状态
5.2环境变量示例
models.env:
“`bash
DASHSCOPE_API_KEY=sk-sp-xxxxxxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://coding.dashscope.aliyuncs.com/apps/anthropic
ANTHROPIC_AUTH_TOKEN=sk-sp-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-sp-xxxxxxxxxxxxxxxx
“`
email.env:
“`ini
SENDER_EMAIL=———-
SENDER_AUTH=xxxxxxxxxxxxxxxxxxxxxxxxQQ邮箱授权码
SMTP_SERVER=smtp.qq.com
SMTP_PORT=465
RECIPIENT_EMAIL=93687610@qq.com
“`
—
6.启动与监控
6.1启动Zoe编排器
“`bash
cd/root/.openclaw/workspace/agent-orchestrator
./scripts/start-zoe.sh
或后台运行
nohuppython3scripts/zoe-orchestrator.py>logs/zoe.log2>&1&
“`
6.2依赖检查
启动脚本自动检查:
–✅Python3
–✅tmux
–✅git
–⚠️ghCLI(可选，用于PR)
–⚠️codex(可选)
–⚠️claude(可选)
6.3监控命令
“`bash
查看所有Agent状态
./scripts/check-agents.sh
查看状态面板
./scripts/status.sh
查看tmux会话
tmuxls
查看特定任务日志
tmuxattach-tcodex-<task-name>
手动干预Agent
tmuxsend-keys-tcodex-<task-name>”命令“Enter
查看任务数据库
cat.clawdbot/active-tasks.json
查看日志
tail-flogs/.log
“`
6.4邮件通知测试
“`bash
测试邮件发送
python3scripts/test-email.py
发送每日报告
./scripts/send-email-report.shreport
任务完成通知
./scripts/send-email-report.shcomplete<ID>”<描述>”[PR]
“`
—
7.邮件通知系统
7.1邮件类型
|邮件类型|触发条件|频率|
|———|———|——|
|任务同步报告|新任务创建|实时|
|监控报告|Zoe健康检查|每30分钟|
|失败告警|任务失败且重试3次|实时|
|完成报告|PR创建成功|实时|
7.2邮件内容
–任务同步报告:任务ID、描述、来源、状态、子任务列表、Agent分配、飞书链接
–监控报告:活动任务数量、tmux会话状态、PR列表、磁盘使用率、日志摘要
–失败告警:任务ID、错误信息、重试次数、建议操作
–完成报告:任务信息、PR编号和链接、下一步指引
—
8.当前状态(2026-03-07)
8.1系统状态
|组件|状态|备注|
|——|——|——|
|OpenClaw|🟢运行中|FeishuChannel|
|QQBot|🟢已安装|/root/.openclaw/extensions/qqbot/|
|Zoe编排器|🟢就绪|v1.0.0|
|Codex|🟢已安装|v0.107.0|
|ClaudeCode|🟢已安装|v2.1.68|
|OpenCode|🟢已安装|v1.2.16|
|QwenCode|🟢已安装|v0.11.1|
|邮件通知|🟢测试通过|SMTP:smtp.qq.com:587|
|飞书集成|🟢已配置|AppID:—————|
8.2任务状态
–活跃任务：0
–已完成任务：0
–任务数据库：.clawdbot/active-tasks.json
8.3飞书文档
|文档|Token|状态|
—
9.安全注意事项
9.1敏感信息处理
1.APIKeys-存储在.env文件，加入.gitignore
2.飞书AppSecret-已泄露需重新生成
3.邮箱授权码–使用QQ邮箱授权码，非登录密码
4.GitHubPAT-如曾泄露，立即撤销
9.2访问控制
–工作空间：/root/.openclaw/workspace-仅root访问
–配置文件：config/.env-权限600
–日志目录：logs/-定期清理
—
10.快速参考
10.1常用路径
“`
workspace→/root/.openclaw/workspace
agent-orchestrator→/root/.openclaw/workspace/agent-orchestrator
qqbot-extension→/root/.openclaw/extensions/qqbot/
openclaw-install→/root/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw
“`
10.2常用命令
“`bash
OpenClaw状态
openclawstatus
启动Zoe
cd/root/.openclaw/workspace/agent-orchestrator&&./scripts/start-zoe.sh
检查Agent
./scripts/check-agents.sh
查看状态
./scripts/status.sh
查看tmux会话
tmuxls
测试邮件
python3scripts/test-email.py
查看日志
tail-flogs/.log
“`
—
