微信 接入 Coze 完整指南

微信 接入 Coze 完整指南

Coze（扣子） 是字节跳动推出的 AI Agent 搭建平台，国内版地址 https://www.coze.cn。它最大的优势是 零代码可视化编排：拖拖拽拽就能组合大模型、插件、工作流、知识库，搭出一个能干活的智能体，并原生支持一键发布到微信公众号、微信客服、飞书、掘金等多个渠道。

本教程覆盖两条接入路径，无论你是运营同学还是开发者，都能找到适合自己的方案：

为什么选择 Coze

在众多 Agent 平台中，Coze 在 微信场景 下有几个独到优势：

• 原生支持微信公众号渠道：不用自己写消息加解密、不用申请公众号开发者模式，在 Coze 平台点几下就能发布
• 零代码可视化编排：人设、开场白、插件、工作流、知识库、数据库全部图形化配置，不用写 Prompt 工程
• 内置丰富插件生态：搜索引擎、新闻、天气、图片生成、知识库检索等 60+ 官方插件直接调用
• 支持工作流（Workflow）：复杂多步任务可视化串联，比如"用户提问 → 搜索资料 → 生成文案 → 推送图片"一条龙
• 多模型自由切换：豆包、Moonshot、通义千问、DeepSeek 等模型可按 Bot 单独配置，按成本和效果灵活选型
• 国内直连无需梯子：www.coze.cn 国内可访问，API 域名 api.coze.cn 国内延迟低
• 免费额度友好：个人开发者可白嫖模型调用额度，公众号渠道无额外服务器成本

前置准备

无论走哪种方式，先确认以下事项：

• 微信公众号：已完成微信认证的订阅号或服务号（个人公众号暂不支持 Coze 渠道发布）。登录地址 https://mp.weixin.qq.com
• Coze 账号：使用抖音 / 手机号 / 飞书账号登录 https://www.coze.cn，完成实名认证（个人实名即可，无需企业资质）
• 浏览器：Chrome / Edge 最新版，避免使用 IE 等老旧浏览器
• 公众号管理员权限：方式 A 发布时需要管理员扫码确认，确保你是公众号管理员或可联系到管理员
• （方式 B 专用）一台 可公网访问的服务器（云主机、NAS、家庭宽带公网 IP 均可）或本地开发机 + 内网穿透工具（如 cpolar、frp）

步骤一：注册并获取 Coze 个人访问令牌（PAT）

PAT 是调用 Coze API 的唯一凭证，方式 A 虽然用不到 PAT，但建议先拿到以备后续调试。

1. 打开 https://www.coze.cn，点击右上角「登录」，选择抖音 / 手机号 / 飞书账号完成登录
2. 首次登录后，按提示完成 实名认证（姓名 + 身份证），认证后才能创建 Bot 和调用 API
3. 鼠标悬停右上角头像 → 点击「个人中心」→ 在左侧菜单选择「API 令牌」（也可直接访问 https://www.coze.cn/open/oauth/pats）
4. 点击「生成新令牌」：
   • 令牌名称：填 wechat-bot（便于日后识别用途）
   • 过期时间：默认 30 天，按需调整
   • 权限范围：勾选 Bot → 访问和调用 Bot，Workflow → 执行工作流
5. 点击「生成」，立刻复制并妥善保存令牌（形如 pat_xxxxxxxxxxxxxxxxxxxx）。令牌只在生成时显示一次，关掉窗口就再也看不到了

方式 A：在 Coze 平台直接发布到微信公众号

步骤二：创建你的第一个 Bot

1. 登录 Coze 首页，点击左上角「创建 Bot」
2. 在弹窗中填写：
   • Bot 名称：例如 公众号小助手
   • Bot 功能介绍：一句话描述 Bot 能干什么，例如 自动回复公众号粉丝消息、查询订单、生成活动文案
   • Bot 所属空间：默认选个人空间即可（团队多人协作时可创建团队空间）
3. 点击「确认创建」，进入 Bot 编排页面

步骤三：配置 Bot 人设和能力

这是决定 Bot 好不好用的核心环节。Coze 的编排页由四大模块组成：

1. 人设与回复逻辑（Persona & Prompt）

在左侧「人设与回复逻辑」输入框中，用自然语言描述 Bot 的角色。一个好的 Prompt 应包含：角色定位、能力边界、回复风格、特殊指令。

1# 角色
2你是「XX 公众号」的官方客服助手「小扣」，主要负责回答粉丝关于产品功能、价格、售后的问题。
3
4# 能力边界
5- 可以回答：产品功能介绍、价格咨询、使用教程、常见问题
6- 不能回答：涉及政治、医疗诊断、投资建议的敏感话题，统一回复"这个问题建议联系人工客服，微信号：xxx"
7- 涉及具体订单：请用户提供订单号后 4 位，调用「查询订单」工作流
8
9# 回复风格
10- 称呼用户为"小伙伴"，语气亲切但不油腻
11- 回复控制在 100 字以内，必要时分点输出
12- 涉及价格、优惠等关键信息时加粗显示

2. 技能（插件 / 工作流 / 触发器）

• 插件：点击中间面板「+ 插件」，搜索并添加需要的官方插件。微信场景常用：
  • 必应搜索 / 头条搜索：让 Bot 能查最新资讯
  • 图片生成 / ByteDance 文生图：粉丝输入"画只猫"即可收到图片
  • 链接读取：粉丝发公众号文章链接，Bot 自动总结
• 工作流：把多步骤任务编排成一个流程。例如"活动报名"：用户输入手机号 → 校验格式 → 写入数据库 → 回复报名成功
• 触发器：定时执行任务，例如每天早上 8 点自动生成一条"早安问候"文案（需配合渠道推送能力）

3. 知识库（Knowledge）

如果 Bot 需要回答特定领域问题（如自家产品手册、FAQ 文档）：

1. 点击「+ 知识库」→「创建知识库」
2. 上传文档（支持 PDF、Word、TXT、Markdown）或粘贴网页 URL
3. 选择分段策略（推荐「自动分段」），点击「确认并处理」
4. 在 Bot 编排页勾选该知识库，Bot 回答时会优先检索知识库内容

4. 开场白与问题引导

向下滚动到「开场白」模块：

• 开场白：粉丝首次关注公众号或开始对话时的欢迎语，例如：你好呀，我是小扣 👋 可以问我产品功能、价格、售后问题，也可以发文章链接让我帮你总结～
• 推荐问题：3–4 个引导按钮，例如 最新活动、价格咨询、使用教程、联系人工

配置完成后，点击右上角「预览与调试」进行测试。在右侧聊天框模拟粉丝提问，确认 Bot 回答符合预期后再进入下一步。

步骤四：发布 Bot 到微信公众号渠道

1. 在 Bot 编排页右上角点击「发布」按钮
2. 在弹出的「发布到渠道」页面，找到「微信公众号」卡片，点击「配置」
3. 选择接入方式：
   • 授权接入（推荐）：点击「去微信授权」，使用公众号管理员微信扫码授权。完成后 Coze 会自动获取公众号 AppID，无需手动填配置
   • 手动接入：在 微信公众平台 →「设置与开发」→「基本配置」中复制 AppID 和 AppSecret 填入 Coze
4. 选择目标公众号（如果你绑定了多个公众号，需指定发布到哪个）
5. 点击「发布」按钮，等待状态变成「已发布」（通常 1–2 分钟）
6. 发布后，Coze 会自动接管公众号的 自动回复 和 客服消息 能力

步骤五：在微信公众号实测

1. 用个人微信扫码关注你的公众号
2. 点击底部菜单或直接发送消息，例如 你好、最近有什么活动、画一张赛博朋克风格的猫
3. 确认收到 Coze Bot 的智能回复，且响应时间在合理范围（3–10 秒为正常）
4. 测试图片生成、知识库问答等关键能力
5. 如需调整 Bot 行为：在 Coze 修改编排后，**重新点击「发布」**即生效，无需重新扫码授权

完成！🎉 方式 A 用户可直接跳到 场景应用示例。

方式 B：通过 Coze API 接入微信机器人框架

适合需要把 Coze 接到 个人微信 / 微信群（公众号以外的场景），或希望自定义路由、触发词、多 Bot 切换的开发者。

步骤二：创建 Bot 并发布为 API 渠道，获取 Bot ID

1. 重复方式 A 的「步骤二、步骤三」创建并配置好 Bot
2. 在 Bot 编排页右上角点击「发布」
3. 在「发布到渠道」页面找到「Bot as API」卡片（也叫「API」渠道），点击「发布」
4. 发布成功后，在该渠道卡片上能看到形如 7400000000000000000 的 Bot ID，复制保存

步骤三：部署 coze2openai 转换层

Coze 的 /v1/bot/chat 接口是 非 OpenAI 兼容 格式（请求体需带 bot_id、响应是异步轮询模式），不能直接被微信机器人框架调用。社区开源的 coze2openai 把它包装成标准 OpenAI /v1/chat/completions 格式，方便接入。

方案 1：Docker 部署（推荐生产环境）

在服务器上创建 docker-compose.yml：

1version: "3"
2services:
3  coze2openai:
4    image: fatwang2/coze2openai
5    container_name: coze2openai
6    ports:
7      - "3010:3010"
8    environment:
9      - BOT_ID=你的_Bot_ID
10      - COZE_API_BASE=https://api.coze.cn
11      - PAT=pat_xxxxxxxxxxxxxxxxxxxx
12      - CHANNEL_ID=api
13      - STREAM_MODE=true
14      - ROUTER_TYPE=multi
15    restart: unless-stopped

启动服务：

1docker compose up -d
2docker compose logs -f

看到 Server is listening on port 3010 即启动成功。

方案 2：Cloudflare Workers 部署（推荐个人用户，免服务器）

1. Fork 仓库 fatwang2/coze2openai 到自己的 GitHub
2. 登录 Cloudflare Dashboard →「Workers & Pages」→「Create」→「Import a repository」
3. 选择刚才 Fork 的仓库，框架预设选「None」，构建命令留空，部署目录填 /
4. 在「Settings」→「Variables and Secrets」添加环境变量：
   • BOT_ID = 你的 Bot ID
   • PAT = 你的 Coze PAT
   • COZE_API_BASE = https://api.coze.cn
   • CHANNEL_ID = api
5. 部署完成后，会得到一个 https://coze2openai.<你的子域>.workers.dev 的地址

验证转换层是否正常：

1curl https://your-coze2openai-domain.com/v1/chat/completions \
2  -H "Authorization: Bearer any-string-here" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "coze-bot",
6    "messages": [{"role": "user", "content": "你好，自我介绍一下"}]
7  }'

返回标准 OpenAI 格式的 JSON（含 choices[0].message.content）即表示转换层工作正常。

步骤四：配置微信机器人框架对接

社区主流的微信机器人框架（如 wechaty、chatgpt-on-wechat、wcferry）都支持自定义 OpenAI 兼容接口。以 chatgpt-on-wechat 为例：

1. 克隆并部署 chatgpt-on-wechat（支持 Docker / 源码部署）
2. 编辑 config.json：

1{
2  "channel_type": "wx",
3  "model": "coze-bot",
4  "open_ai_api_key": "any-string-here",
5  "open_ai_api_base": "http://your-coze2openai-domain.com/v1",
6  "single_chat_prefix": [""],
7  "single_chat_reply_prefix": "",
8  "group_name_white_list": ["AI 助手群", "测试群"],
9  "nick_name_black_list": ["通知bot"],
10  "proxy": "",
11  "hot_reload": true
12}

关键字段说明：

• model：随意填，coze2openai 不校验模型名（实际调用由 BOT_ID 决定）
• open_ai_api_base：填你的 coze2openai 转换层地址，末尾要带 /v1
• group_name_white_list：只在这些群里响应，避免 Bot 在所有群乱答
• single_chat_prefix：私聊触发前缀，留空则无需前缀直接回复

1. 启动 chatgpt-on-wechat：

1python app.py
2# 或 Docker
3docker run -d --name cow -v $(pwd)/config.json:/app/config.json -v $(pwd)/plugins:/app/plugins zhenqicai/chatgpt-on-wechat

1. 用手机微信扫描终端输出的二维码登录

步骤五：测试连通性

1. 在配置的群里 @ 机器人 发送 你好，确认收到 Coze Bot 的回复
2. 私聊机器人发送 画一张日式动漫风格的咖啡店，测试多模态能力
3. 发送一篇公众号文章链接，验证「链接读取」插件工作正常
4. 通过 docker logs -f coze2openai 观察 API 调用日志，确认请求被正确转发到 Coze

完成！🎉

场景应用示例

场景 1：公众号自动回复 + 智能客服（方式 A 最佳实践）

场景描述：电商公众号每天收到几百条粉丝私信，问"订单到哪了""有没有优惠券""怎么退款"，人工客服根本回复不过来。

Bot 配置要点：

• 知识库上传：商品手册、退换货政策、运费规则、活动 FAQ
• 工作流编排：用户输入订单号 → 调用「查询物流」插件 → 返回物流轨迹 + 预计到达时间
• 人设设定：明确回答范围，订单号校验失败时引导用户重新输入

典型对话：

1粉丝：我的订单 20250821001 物流到哪了？
2Bot：小伙伴，你的订单目前显示「已揽收，预计 8 月 23 日送达」📦
3     如需修改收货地址，请回复"改地址 + 新地址"，我帮你转人工处理。
4
5粉丝：有没有满减券？
6Bot：本月活动期间，满 199 减 30、满 399 减 80 🎁
7     回复"领券"即可领取，每个用户限领 1 张，8 月 31 日 23:59 失效。

预期效果：80% 常见问题被 Bot 自动解决，人工客服只处理复杂工单，响应时间从小时级降到秒级。

场景 2：微信群专属助手（方式 B 典型应用）

场景描述：付费社群 / 兴趣群 / 团队内部群，希望群成员能 @ 机器人问问题、查资料、生成内容，且只在指定群生效避免打扰其他群。

Bot 配置要点：

• 知识库：社群规章制度、往期精华内容、行业报告
• 插件：搜索 + 链接读取 + 图片生成
• 群白名单：仅在配置的 group_name_white_list 群里响应
• 提示词：明确"被 @ 才回答，不主动插话"

典型对话：

1群友A @助手：帮我搜一下最近 RAG 的最新论文，3 篇就好
2助手：小伙伴，这是最近 RAG 领域 3 篇值得关注的论文：
3     1. GraphRAG: Unlocking LLM's Capabilities...（链接）
4     2. Self-RAG: Learning to Retrieve...（链接）
5     3. RAG-Fusion: Enhancing RAG...（链接）
6     需要我帮你总结哪篇吗？
7
8群友B @助手：画一张赛博朋克风格的猫咪，发到群里
9助手：[图片]

预期效果：群活跃度提升、人工运营成本下降，新人可通过 @ 助手快速了解社群历史内容。

场景 3：朋友圈 / 公众号文案生成器

场景描述：新媒体运营每天要发朋友圈、写公众号文章摘要、做活动海报文案，重复劳动多。把 Coze Bot 配置成专属文案生成器，运营直接在微信里发指令即可。

Bot 配置要点：

• 人设：资深新媒体文案，熟悉小红书 / 公众号 / 朋友圈三种风格差异
• 知识库：品牌调性文档、往期高赞文案、敏感词清单
• 工作流：「朋友圈文案」：输入主题 → 生成 3 版文案（感性 / 理性 / 互动）→ 输出 + 字数统计
• 触发词：朋友圈、小红书、公众号标题

典型对话：

1运营：朋友圈 新品上市 降噪耳机
2Bot：3 版朋友圈文案请查收 ✍️
3     1. 【感性】通勤路上的最后一公里清净，从戴上它的那一刻开始...
4     2. 【理性】42dB 主动降噪 / 30 小时续航 / LDAC 高清，¥699 限量首发...
5     3. 【互动】你能忍受地铁里多少分贝的噪音？测完发现我每天暴露在 75dB...
6     均已控制在 80 字以内，需要配图建议可继续告诉我。

预期效果：日常文案产出时间从 30 分钟降到 3 分钟，文案风格统一且符合品牌调性。

最佳实践

提示词技巧

1. 结构化 Prompt：用 # 角色 / # 能力边界 / # 回复风格 / # 特殊指令 分段，Coze 对结构化 Prompt 理解更准
2. 明确边界：写清"不能做什么"，避免 Bot 在医疗 / 法律 / 投资等敏感话题上乱答引发投诉
3. few-shot 示例：在 Prompt 中给 2–3 个理想问答范例，让 Bot 模仿风格和长度
4. 变量化配置：Coze 工作流支持 {{user_input}}、{{order_id}} 等变量，复杂逻辑用工作流而不是堆 Prompt

安全建议

1. PAT 存储：用环境变量 / 密钥管理工具，禁止硬编码到代码或截图分享
2. 转换层鉴权：coze2openai 默认 Authorization 任意值即可调用，务必改 ENV_AUTHORIZATION 加密码保护，否则 PAT 会被盗刷
3. 内容审核：Coze 平台已内置内容安全过滤，但 Bot 输出仍可能存在边缘风险，建议在公众号场景配合微信原生内容审核
4. 频次控制：方式 B 部署时建议在 coze2openai 配置 RATE_LIMIT，避免个别群友狂发消息触发 Coze 平台限流
5. 日志脱敏：日志中不要打印 PAT、用户手机号、订单号等敏感信息

故障排查

扩展与进阶

多 Bot 路由

coze2openai 的 ROUTER_TYPE=multi 模式支持根据请求中的 model 字段路由到不同 Bot。例如：

• model=customer-service → 路由到客服 Bot
• model=copywriter → 路由到文案 Bot

配置时把 BOT_ID 改为 JSON 格式：

1BOT_ID='{"customer-service":"7400000000000001","copywriter":"7400000000000000002"}'

工作流与触发器进阶

• 定时推送：配置触发器每天早 8 点生成"早安问候"，配合工作流把文案推送到企业微信群
• 数据库：Coze 内置数据库可存用户画像、订单记录，工作流中通过 SQL 查询，实现"识别用户 → 个性化推荐"
• 多模态输出：工作流串联图片生成 + 链接读取 + 文本生成，实现"发 URL → 自动生成图文海报"

接入其他渠道

Coze 还原生支持以下渠道，配置思路与微信公众号类似：

• 微信客服：在 Coze 渠道页配置「微信客服」，适合企业客服场景
• 飞书机器人：参考官方教程 coze-feishu-bot
• 掘金社区：自动回复掘金评论
• 微信小程序：通过 API 渠道 + 自研小程序前端接入

成本与配额

• Coze 个人版提供免费额度（模型调用次数 / 图片生成张数 / 知识库容量），适合个人测试和小规模公众号
• 商用建议升级 Coze 专业版，按 token 计费，配额上限更高，享受 SLA 保障
• 方式 B 部署的服务器成本：1 核 1G 云主机即可满足中小群使用，年成本约 ¥200–500

推荐学习路径

1. 先用方式 A 跑通公众号接入，理解 Coze Bot 的编排思路
2. 进阶学习 Coze 工作流，把复杂业务逻辑可视化编排
3. 学习 数据库 + 知识库 组合，实现用户画像驱动的个性化回复
4. 最后上手方式 B，把 Coze 接入个人微信群，做更灵活的自动化