1. 项目定位与用途
wechat-agent-studio 是一个专为 Claude Code 环境设计的微信公众号自动化运营模板。它并非一个独立应用程序，而是一套完整的搭建和运维指南，旨在通过 12 个 AI Agent 的协作，实现从创意到发布的全流程无人干预内容生产。其核心用途是作为多 Agent 协同工作流的参考实现，展示如何将复杂的媒体运营任务分解并分配给具备不同专长的自动化角色。
项目档案模板 / Starter
wechat-agent-studio：Claude Code 微信公众号自动化运营模板（12 Agent 协作 + Discord 集成）
wechat-agent-studio 是一个为 Claude Code 环境设计的微信公众号全自动化运营模板，通过 12 个 AI Agent 在 Discord 中协作完成内容生产全流程。本页提供完整搭建指南、生产环境经验教训、安装使用说明及技术架构解析。
14Star 于 2026年3月3日2026年6月23日 更新
AI 总结
这是一个为 Claude Code 环境设计的微信公众号全自动化运营模板，通过 12 个分工明确的 AI Agent 在 Discord 中协作，实现从选题讨论、内容创作到封面生成、草稿发布的完整内容生产管线，并提供生产环境中的关键经验教训。
中文项目介绍
wechat-agent-studio 是一个面向微信公众号内容运营的自动化解决方案模板。它通过 12 个具有独立性格和职责的 AI Agent（如总监、笔锋、灵犀等）在 Discord 频道中进行协作，模拟真实团队的工作流程，完成从选题讨论、内容创作、封面图生成到草稿发布的全流程自动化。
该项目解决了传统公众号运营中人力成本高、流程繁琐、协作效率低的问题。其核心机制包括三轮会议讨论（亮牌→交锋→终极辩论）以确保决策质量，基于 SOUL.md 的严格 Agent 行为规范，以及 24/7 运行的 team-supervisor 守护进程进行监控和自动修复。技术栈涵盖 OpenClaw gateway、Discord bot、通义万象 API 和微信公众平台 API。
适用场景主要是希望构建无人干预的内容生产流水线的运营者，以及研究多 Agent 协作工作流的技术人员。仓库中提供了完整的技术方案、12 条生产环境关键教训和端到端检查清单，但具体实现细节需参考配套的 wechat-agent-studio.md 命令文件。
详细信息与使用说明
2. 解决的问题
该项目主要解决微信公众号内容运营中的三大痛点：一是多人协作流程繁琐、沟通成本高；二是内容生产各环节（选题、写作、配图、发布）割裂，效率低下；三是缺乏可靠的自动化监控和错误处理机制。通过模拟包含总监、编辑、设计师等角色的 12 人团队，并在 Discord 中建立结构化讨论和决策机制，它实现了流程的标准化和自动化，同时通过 team-supervisor 守护进程和详细的生产教训总结，确保了系统在真实环境中的稳定运行。
3. 适用场景
主要适用于两类场景：一是内容创作者或运营团队希望建立稳定、可扩展的自动化内容生产线，减少重复性人工干预；二是开发者和研究人员需要学习多 Agent 系统的架构设计、协作模式及生产环境中的常见陷阱。由于项目依赖特定的 OpenClaw gateway 和 Discord 环境，它更适合作为技术方案参考或内部工具模板，而非开箱即用的 SaaS 产品。
4. 安装方式
安装过程在仓库中明确给出两种方式，均需将核心配置文件放置到 Claude Code 的 commands 目录。方式一为克隆仓库后复制文件：先执行 git clone 下载项目，然后将 wechat-agent-studio.md 文件复制到 ~/.claude/commands/ 目录。方式二为直接下载：使用 curl 命令从 GitHub 原始链接直接下载该文件到同一目录。安装后，用户需在 Claude Code 环境中通过命令触发配置流程。
5. 使用方式
使用方式在 README 中有明确说明。在 Claude Code 环境中，用户输入命令 /wechat-agent-studio 即可触发该技能。随后，系统会引导用户完成一系列配置，包括 12 个 Agent 的 Discord 频道绑定、API 密钥（如 DashScope 用于通义万象图片生成、微信公众号 API 凭证）设置以及发布管线参数调整。项目还提供了多个触发示例，如配置 Agent 协作、调试 Agent spawn 问题、生成封面图、排查发布管线错误以及催促卡住 Agent 等，覆盖了主要运维场景。
6. 实现特点与补充说明
项目的实现具有几个关键特点：一是基于 OpenClaw gateway 的 Agent 架构，所有 Agent 共享 Discord bot 身份，必须通过 sessions_spawn 工具进行任务派发，简单的文字 @提及无效；二是采用严格的 SOUL.md 规范来约束 Agent 行为，包括直接回复规则、格式禁令和针对不同模型（Opus/Sonnet/GLM-5）的差异应对；三是包含可视化组件 Star-Office-UI，以像素风办公室监控 Agent 实时状态。需要注意的是，仓库中未明确给出具体的 Discord bot 配置步骤、OpenClaw gateway 的部署方法以及微信发布管线的详细代码实现，这些细节需参考 wechat-agent-studio.md 文件或相关依赖仓库。
思维导图
wechat-agent-studio
核心架构
OpenClaw gateway 基础
12 Agent 角色系统
Discord 协作层
协作机制
3轮会议讨论
SOUL.md 行为规范
team-supervisor 守护进程
发布管线
通义万象图片生成
wechat_publish.py 草稿发布
pipeline.py 浏览器预览
运维与监控
Star-Office-UI 可视化
端到端检查清单
12条生产教训
常见问题
如何安装和配置 wechat-agent-studio？
安装方式有两种：一是克隆仓库后将 wechat-agent-studio.md 复制到 ~/.claude/commands/ 目录；二是使用 curl 命令直接下载该文件到同一目录。配置需在 Claude Code 中执行 /wechat-agent-studio 命令，按提示完成 Discord 频道绑定、API 密钥（DashScope、微信公众号）等设置。
为什么在 Discord 中 @提及 Agent 没有反应？
根据生产教训第一条，Discord 中的文本 @提及不会触发 Agent。必须使用 sessions_spawn 工具进行任务派发。这是由 OpenClaw gateway 的设计决定的，bot 自身消息会被 gateway 跳过，且 Agent 的激活依赖于特定的工具调用而非消息提及。
如何避免 SOUL.md 规范冲突导致的问题？
教训第三条指出，SOUL.md 中的矛盾指令是致命的，模型会选择更懒散的选项。解决方案包括：确保指令清晰无冲突；将关键规则同时放在文档头部和尾部（教训第十二条，LLM 注意力呈 U 型分布）；并使用真实的错误示例而非抽象规则来强化规范（教训第四条）。
微信发布管线常见错误如何排查？
常见问题有：draft/update 接口需要传递所有文章字段，仅发送 thumb_media_id 会导致 44004 错误；通义万象图片生成需间隔 30 秒以避免 429 限流；浏览器标签页会累积，需通过 CDP 自动清理。建议参考项目中的端到端检查清单和 12 条生产教训进行逐项排查。
team-supervisor 守护进程的作用是什么？
team-supervisor 是一个 24/7 运行的统一守护进程，负责六项健康检查、每 30 秒轮询 Agent 状态，并在发现问题时执行自动修复、发送 Discord 告警或催促卡住的 Agent。它是确保多 Agent 系统长期稳定运行的关键运维组件。