扣子智能体接入微信生态需分五步：先在coze.cn创建调试智能体并配置人设与回复逻辑；其次绑定知识库并开启召回开关；再发布至公众号，完成开发者凭证绑定与服务器配置验证；接着通过OpenClaw插件接入微信群，仅响应明确@；最后小程序端须经云函数代理调用，API密钥严禁硬编码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
把扣子智能体接入微信生态，不是只配个API密钥就完事——它要能真正在微信群里自动应答、在公众号里按图文规则回复、在小程序里实现流式打字效果，三端行为一致且不掉上下文。这要求你必须分清每条通道的技术约束和平台边界，比如公众号强制走服务器校验，小程序禁止前端直连API，微信群依赖OpenClaw插件中转。
第一步：在扣子平台创建并调试智能体
打开 coze.cn，登录后点击左上角「+ 创建」→ 选择「创建智能体」→ 填写名称（如“客服小助手”）、描述，语言选中文，模型优先选 kimi-moonshot-8k（适配微信单次消息≤3000字符限制）。
进入编辑页后，立刻点击左侧「人设与回复逻辑」→ 删除默认模板，粘贴以下结构化提示词：
你是一名专注电商售后的AI助手，仅回答退货流程、物流查询、优惠券使用三类问题；所有回复必须控制在280字以内；遇到模糊提问，先追问具体订单号或商品ID；禁止生成链接、二维码、联系方式。
点击右上角「预览与调试」→ 在对话框输入“我的订单123456还没发货”，确认返回内容简洁、无超限、无违规信息。这一步没通过，后续所有接入都会失效。
第二步：配置知识库（可选但强烈建议）
方法一：上传本地文档
在智能体编辑页左侧菜单点「知识库」→「+ 新建知识库」→ 类型选「表格」→ 名称填“售后FAQ”→ 导入方式选「本地文档」→ 上传一个CSV文件，首行字段必须含“问题”“答案”，且“问题”列已设为索引列。
方法二：手动录入高频问答
点击「添加条目」→ 问题栏输入“怎么查物流”，答案栏输入“请提供订单号，我帮您实时查询快递状态”→ 点击保存。每条问答独立存储，不支持批量导入文本块。
【知识库绑定后必须开启「召回开关」】 否则智能体完全无法检索内容，调试时看似正常，上线后却只会胡说。
第三步：发布到微信公众号（订阅号/服务号通用）
第一步：获取公众号开发者凭证
登录 mp.weixin.qq.com → 左侧菜单「设置与开发」→「基本配置」→ 复制「AppID」和「AppSecret」→ 注意：服务号需额外开通「网页授权」权限，订阅号无需。
第二步：在扣子平台绑定
回到智能体编辑页 → 右上角「发布」→ 选择「微信公众号」→ 粘贴AppID → 点击「保存」→ 扫码授权（必须用公众号管理员微信扫）→ 授权成功后状态变为「已连接」。
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
第三步：验证消息路由
关注你的公众号 → 发送任意消息 → 查看扣子后台「调试日志」是否出现请求记录；若无记录，检查公众号后台「服务器配置」是否启用，URL是否填写扣子提供的回调地址（形如 https://api.coze.com/webhooks/public/xxx）。
第四步：接入微信群（依赖OpenClaw插件）
① 访问扣子 OpenClaw 专属部署页（https://space.coze.cn）→ 登录后点击「创建副本」→ 选择「OpenClaw 微信插件」模板 → 等待1分钟完成云端部署。
② 部署完成后，进入「OpenClaw 控制台」→ 点击「微信配置」→ 手机微信扫码登录 → 选择要接入的群（仅显示你作为管理员或群主的群）→ 开启「自动回复」开关。
③ 回到扣子智能体编辑页 → 在「插件」区域点击「+」→ 搜索并添加「微信消息处理器」插件 → 绑定刚部署的OpenClaw实例ID（格式为oc_开头的字符串）→ 保存。
这一步完成后，群内@机器人提问，消息会经OpenClaw转发至扣子智能体，再由OpenClaw将回复投回群聊。注意：普通成员@机器人时，机器人仅响应明确提及（如@客服小助手）的消息，不会监听全群关键词。
第五步：小程序端安全接入（必须经后端代理）
在小程序项目根目录新建 cloud/functions/kouzi-proxy/index.js，写入如下云函数代码：
const cloud = require('wx-server-sdk');
cloud.init();
exports.main = async (event, context) => {
const { message, sessionId } = event;
const res = await wx.cloud.http.request({
method: 'POST',
url: 'https://api.kouzi.ai/v1/chat',
header: { 'Authorization': `Bearer ${process.env.KOUZI_API_KEY}` },
data: { message, session_id: sessionId }
});
return res.data;
};
在小程序前端调用时，使用 wx.cloud.callFunction → name: 'kouzi-proxy' → data: { message: '我想退换货', sessionId: 'wx_user_abc123' }。
【KOUZI_API_KEY 必须存于云函数环境变量，绝不可写在小程序代码里】 否则任意用户抓包即可盗用你的API额度，24小时内可能耗尽全部免费配额。
