支付宝AI付扫码失败时，需依次排查二维码生成、本地服务、插件配置、安全拦截及支付宝账户资质五方面问题，按步骤验证并修复对应环节。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用OpenClaw（“龙虾”）调用支付宝AI付功能时，微信或支付宝客户端扫描生成的二维码无响应、无法识别或跳转失败，则可能是由于二维码生成异常、本地服务未就绪或通信链路中断所致。以下是针对该问题的多路径排查与修复步骤：
一、确认二维码生成有效性与时效性
OpenClaw在启动支付宝AI付授权流程时，需通过网关服务动态生成带签名和短时效的二维码，若生成过程被阻断或缓存污染，将导致扫码端无法解析有效载荷。
1、在OpenClaw终端窗口中观察日志输出，确认是否出现类似[gateway] QR code generated at /auth/alipay/qr?token=xxx的日志行；
2、检查二维码图片是否完整显示于控制台或网页界面，若仅显示空白、乱码或HTTP 500错误提示，则说明网关未成功渲染；
3、使用手机浏览器直接访问该二维码URL（如http://localhost:18789/auth/alipay/qr?token=xxx），验证能否正常加载并下载图片；
4、若可加载但扫码仍失败，尝试长按图片保存后使用支付宝“相册扫码”功能识别，排除实时渲染延迟干扰。
二、校验本地服务状态与端口连通性
支付宝AI付授权依赖OpenClaw网关服务持续监听指定端口（默认18789），并维持与支付宝OAuth2.0回调地址的双向通信通道。任何进程中断或端口占用都将导致扫码请求无法被接收或转发。
1、打开任务管理器（Windows）或活动监视器（macOS），搜索进程名openclaw、node或weclaw，确认其CPU与内存占用处于活跃状态；
2、在命令行执行netstat -ano | findstr :18789（Windows）或lsof -i :18789（macOS/Linux），确认端口已被OpenClaw主进程绑定；
3、若端口显示为LISTENING但无对应PID，或返回Address already in use，则需终止冲突进程（如其他Node服务、旧版Clawdbot实例）；
4、重启OpenClaw服务：先执行weclaw stop或手动kill进程，再运行weclaw start，等待日志中出现Gateway server listening on http://localhost:18789。
三、检查支付宝AI付插件与权限配置
OpenClaw需加载alipay-ai-pay技能插件，并完成支付宝开放平台应用的OAuth2.0授权配置，缺失任一环节均会导致二维码生成逻辑跳过或返回空响应。
1、进入OpenClaw配置目录（默认~/.weclaw/config.json），确认"skills"数组中包含"alipay-ai-pay"条目；
2、检查config.json内alipay节点是否完整填写：app_id、private_key、alipay_public_key、redirect_uri必须全部存在且格式合法；
3、验证redirect_uri是否与支付宝开放平台后台配置的“授权回调地址”完全一致（含协议、端口、路径，区分大小写）；
4、若使用阿里云部署版本，登录百炼控制台→API密钥管理→确认已启用“支付宝AI付”相关权限策略，并将该密钥ID填入config.json的alipay.api_key_id字段。
四、排除安全软件与网络拦截干扰
部分安全防护软件会主动拦截OpenClaw对本地回环地址（127.0.0.1）的HTTP服务暴露行为，或阻止其向支付宝域名发起HTTPS请求，造成二维码生成后无法完成签名或回调注册。
1、临时禁用Windows Defender实时保护、火绒、360安全卫士等所有终端防护软件，关闭其“网页防护”“HTTPS扫描”模块；
2、在防火墙高级设置中，为node.exe或weclaw添加出站与入站规则，放行TCP端口18789及443；
3、打开命令行执行ping openapi.alipay.com与telnet openapi.alipay.com 443，确认DNS解析正常且SSL端口可达；
4、若企业网络部署了代理 服务器，需在config.json中显式配置"proxy": "http://your-proxy:port"，否则支付宝OAuth2.0令牌交换将超时失败。
五、验证支付宝账户与应用资质状态
即使OpenClaw服务与二维码生成均正常，若绑定的支付宝商户账户存在资质异常、APP支付产品未开通或授权函缺失，支付宝服务端将在扫码后直接拒绝授权，表现为页面空白或提示“系统繁忙”，实际未触发OpenClaw回调。
1、使用配置中指定的app_id，登录支付宝开放平台，进入“我的应用”→查看该应用的“APP支付”功能是否显示为“已上线”；
2、点击应用名称→“功能列表”，确认“支付宝AI付”能力已勾选并提交审核，状态为“审核通过”；
3、进入“账号中心”→“商户基本信息”，核对主体类型是否为企业，个人账户无法开通APP支付；
4、若主体为个体工商户，检查是否已上传《APP支付授权函》并经支付宝人工审核通过，未通过审核的应用无法生成有效授权二维码。
