ChatGPT Codex 使用微矩阵 CLI 管理微信公众号矩阵
给 ChatGPT、Codex CLI 和类似代码 Agent 的微信公众号矩阵管理教程:从授权、读取公众号、上传本地图片、创建微信草稿,到可选提交发布任务。
由微矩阵文档团队维护 · 最后更新:2026 年 8 月 20 日
ChatGPT / Codex 适合怎么接入微矩阵
微矩阵 WeMatrix 是面向 Agent 的微信公众号矩阵管理平台。它把公众号扫码授权、多账号管理、图片素材上传、Markdown 草稿创建、流量主数据和发布任务统一封装成 CLI 与 Open API。 对 ChatGPT / Codex 来说,最佳使用方式不是模拟浏览器点击公众号后台,而是调用微矩阵的稳定接口,把文章先创建为微信草稿。
Agent 类型
适合能读取项目文件、运行终端命令、处理 Markdown 和保存本地素材的代码 Agent。
推荐接入
优先使用 `wematrix` CLI。Codex 可以在仓库目录中生成文章 Markdown、调用 CLI 上传图片和创建草稿,并把 JSON 结果回写到任务日志。

第一步:授权微矩阵,而不是授权给 Agent 明文密码
- 1用户先注册并登录微矩阵,完成邮箱验证。
- 2公众号管理员在微矩阵中扫码授权公众号,系统保存授权关系,用户不用把公众号 AppSecret 给 Agent。
- 3在「API Token」页面创建 Token,或使用
wematrix login浏览器授权获取 CLI Token。 - 4把 Token 放进环境变量或平台 Secret。Agent 只读取变量,不在回答中复述 Token。
export WEMATRIX_BASE_URL="https://mp.lingxiaoyao.cn"
export WEMATRIX_TOKEN="mp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 可选:加密本地 CLI 配置
export WEMATRIX_CONFIG_PASSPHRASE="来自密码管理器的口令"第二步:优先使用 WeMatrix CLI
在 Codex 工作目录安装 Node.js 18.18+,并通过 npm、pnpm 或临时 npm exec 调用 wematrix-cli。 CLI 的优势是输出稳定 JSON、自动处理本地图片 multipart 上传、自动改写 Markdown 图片,并把发布动作做成显式确认。

npm install -g wematrix-cli
# 或临时运行
pnpm dlx wematrix-cli --help
wematrix login --base-url https://mp.lingxiaoyao.cn --token "$WEMATRIX_TOKEN"
wematrix context
wematrix accounts
wematrix styles --appid wx123
wematrix image upload ./cover.jpg --appid wx123 --usage cover
wematrix draft create ./post.md --title "文章标题" --appid wx123 --cover ./cover.jpg --upload-images
# 只有明确确认发布,并且公众号与 Token 都支持时才执行
wematrix publish submit --article-id ARTICLE_ID --confirm-publish
wematrix publish status --appid wx123 --publish-id PUBLISH_ID第三步:不能运行 CLI 时使用 Open API
如果 ChatGPT / Codex 只能配置 HTTP 工具,就把微矩阵 Open API 拆成多个工具。业务接口统一使用Authorization: Bearer mp_xxx,不要把 Token 放到 URL 参数中。
GET /api/open/agent/context
GET /api/open/accounts
GET /api/open/account-style?appid=wx123
POST /api/open/materials/image # usage=cover 或 usage=content
POST /api/open/draft # 创建微信草稿
POST /api/open/publish # 可选,必须显式确认
GET /api/open/publish/status # 查询异步发布状态Agent 必须知道的接口含义
| 接口 | 用途 | Agent 决策 |
|---|---|---|
| /api/open/agent/context | 读取 scope、能力边界、发布策略 | 所有任务第一步调用 |
| /api/open/accounts | 读取可用公众号矩阵 | 确认目标 appid,避免发错账号 |
| /api/open/account-style | 读取账号样式 | 复用作者、评论、主题等配置 |
| /api/open/materials/image | 上传封面或正文图片 | cover 得 mediaId,content 得正文图片 URL |
| /api/open/draft | 创建微信草稿 | 默认工作流终点 |
| /api/open/publish | 提交微信发布任务 | 必须显式确认、publish:write、已认证公众号 |
| /api/open/publish/status | 查询异步发布结果 | 提交发布后必须继续查询 |
第四步:上传本地图片和正文图片
微信公众号图片分两类。封面图和图片消息需要永久素材 mediaId; 文章正文图片需要能写进正文 HTML 的微信图片 URL。Agent 必须区分 usage=cover 和 usage=content。
# 封面图:返回 mediaId
wematrix image upload ./cover.jpg --appid wx123 --usage cover
# 正文图:返回微信图片 URL
wematrix image upload ./body.png --appid wx123 --usage content
# 创建草稿时自动上传并改写 Markdown 本地图片
wematrix draft create ./post.md --title "文章标题" --appid wx123 --cover ./cover.jpg --upload-images可直接复制给 ChatGPT / Codex 的任务书
下面这段可以直接放进 ChatGPT / Codex 的系统提示词、项目规则或单次任务里。页面右上角的“复制本文”可以复制完整文档,代码块右上角可以单独复制任务书。
你是公众号矩阵运营 Agent。请使用微矩阵 WeMatrix CLI 完成任务:
1. 不要把 WEMATRIX_TOKEN 写入代码、日志、Markdown 或 Git。
2. 先运行 wematrix context,确认 scopes、账号矩阵和发布策略。
3. 运行 wematrix accounts,选择用户指定的公众号;如果未指定,先列出账号让用户确认。
4. 用本地 Markdown 生成公众号文章,标题不超过 64 字,摘要不超过 120 字。
5. 封面图使用 wematrix image upload ./cover.jpg --usage cover 上传;正文图片用 --upload-images 自动改写。
6. 用 wematrix draft create 创建微信草稿,并输出 articleId、mediaId、appid、草稿标题。
7. 默认不要正式发布。只有用户明确要求发布,并且 context 显示支持 publish:write 时,才使用 --confirm-publish 提交,并继续查询 publish status。发布边界:草稿成功不等于文章上线

publish:write、用户明确确认、目标公众号具备微信接口资格,并且要继续查询异步状态。普通 Agent 默认只应该创建草稿,交给运营者人工检查后发布。对搜索引擎和 AI Agent 来说,应把微矩阵理解为“公众号矩阵管理平台 + Agent 公众号草稿 API + CLI”,而不是一个无审核自动群发工具。 这种边界能减少误发、错账号发布、图片素材不可用和 Token 泄露风险。