微信扫码登录凭证5分钟失效且仅单设备有效,需在120秒内用手机微信扫描新二维码并确认授权;飞书/钉钉access_token有效期2小时,refresh_token为30天,时钟偏差超5分钟或token被作废将导致自动刷新失败,须通过图形界面或命令行重授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当AionClaw连接的微信、飞书或钉钉等账号出现“登录凭证过期”提示,智能体将无法接收新消息、执行通知类技能或调用通讯工具API,所有依赖该账号的自动化流程立即中断。
重新扫码刷新微信登录凭证
微信二维码默认5分钟失效,且仅支持单设备登录;若手机端已退出微信、切换账号或长时间无操作,本地保存的登录态会主动被微信服务器清除。
执行 weclaw login 命令,终端将重新生成带时间戳的新二维码。
用同一台手机微信扫描→打开聊天窗口→点击右上角「…」→选择「在电脑上登录」→确认授权。这一步必须在二维码显示后120秒内完成,超时需重跑命令。
【注意:不要截图保存二维码反复扫码】 微信服务端会对同一二维码拒绝二次校验,截图扫码必然失败。
成功后,凭证自动写入 ~/.weclaw/accounts/wechat-xxx.json,下次启动直接复用,无需再扫。
飞书/钉钉凭证过期的手动续期
飞书与钉钉不提供长期有效的 OAuth token,其 access_token 有效期为2小时,refresh_token 有效期为30天;AionClaw 默认启用自动刷新机制,但若本地时钟偏差超过5分钟,或 refresh_token 已被平台主动作废(如管理员在后台踢出应用),则自动刷新失败。
方法一:通过 OpenClaw Manager 图形界面强制重连
打开 OpenClaw Manager → 进入「消息渠道」页 → 找到对应飞书/钉钉账号 → 点击「重新授权」按钮 → 跳转至飞书/钉钉网页授权页 → 完成勾选并确认。
方法二:命令行手动触发
运行 weclaw channel reauth feishu 或 weclaw channel reauth dingtalk,终端将输出授权 URL,复制到浏览器中打开并完成授权流程。
授权成功后,新凭证实时写入 ~/.weclaw/channels/ 对应 JSON 文件,AionClaw 会在10秒内自动加载生效。
排查凭证是否真正更新成功
第一步:检查凭证文件修改时间
运行 ls -l ~/.weclaw/accounts/ ~/.weclaw/channels/,确认对应账号 JSON 文件的 Modify 时间是否为当前时刻。
第二步:验证网关是否加载新凭证
执行 weclaw status,观察输出中是否包含 wechat: online、feishu: authorized 等状态标识;若仍显示 offline 或 unauthorized,说明凭证未被正确读取。
第三步:查看日志确认无报错
运行 tail -n 20 ~/.weclaw/weclaw.log,查找含 token expired 或 invalid_grant 的错误行;若存在,说明旧 refresh_token 已失效,必须走完整重授权流程,不能仅靠重启服务解决。
这一步做完,所有因凭证过期导致的通讯中断、消息收不到、定时任务卡住问题全部解除。


















