【免费下载链接】weclawConnect to any agents with WeChat ClawBot.项目地址https://gitcode.com/gh_mirrors/we/weclaw点击查看免费下载WeClaw 是一款微信 AI Agent 桥接工具可以把 Claude、Codex、Gemini、Kimi 等 AI Agent 接入微信直接在微信里发消息即可获得 AI 回复。本文整理了 WeClaw 使用中 8 个常见问题的解决方法——从二维码过期到Agent 不启动每个问题都给出可落地的排查步骤。新手可按编号快速对号入座。 排查问题前先花 30 秒了解 WeClaw 的工作原理微信消息先到 ClawBot经中继服务器转发给本机 WeClaw再路由到配置的 AI Agent。链路中任何一环出问题都会表现为发消息没反应。1. 微信登录二维码过期重新扫码的步骤现象首次运行weclaw start终端打印二维码但扫码时提示已过期。原因微信登录二维码有时效性二维码状态轮询逻辑见 ilink/auth.go超时未扫码即失效。解决方法重新执行weclaw login获取新二维码用手机版微信尽快扫码并在手机上点确认登录成功后凭证会保存到~/.weclaw/accounts/下次启动无需再扫码需要添加第二个微信账号时再次执行weclaw login即可登录流程见 cmd/login.go2. AI Agent 未检测到或不启动排查三步走现象启动后~/.weclaw/config.json里没有 agents 配置或日志出现failed to start。原因WeClaw 按二进制名称如claude、codex自动检测本机已安装的 Agent检测规则见 config/detect.go未安装或不在 PATH 中就不会被发现。解决方法确认对应 Agent 的命令行工具已安装且能在终端直接运行使用 nvm、mise 等版本管理器时路径只写在交互 shell 里WeClaw 会用登录 shell 兜底探测若仍找不到请在配置文件的command字段中手动指定二进制绝对路径查看~/.weclaw/weclaw.log确认是否有auto-detected检测成功记录3. 微信发消息没反应如何退出回声模式现象微信消息能收到但回复只是简单回声或直接不回。原因默认 Agent 是在后台异步初始化的见 cmd/start.go如果初始化失败WeClaw 会停留在回声模式等待。解决方法在微信中发送/info查看当前 Agent 信息与类型检查~/.weclaw/config.json中default_agent指向的 Agent 名称是否存在于agents里执行weclaw start重启后在日志中确认出现default agent ready字样4. Agent 卡在权限确认不回话现象发出消息后长时间无结果尤其是 CLI 模式下的 Claude、Codex。原因部分 Agent 默认需要交互式权限确认在微信场景下无法点确认任务就一直卡住。解决方法在配置文件对应 Agent 的args字段中加入参数跳过确认ClaudeCLI 模式--dangerously-skip-permissionsCodexCLI 模式--skip-git-repo-check⚠️ 这些参数会跳过安全检查请了解风险后再启用。ACP 模式的 Agent 会自动处理权限无需配置。5. weclaw stop 不生效与残留进程处理现象weclaw status显示 not running但微信仍有响应或提示stale pid file。解决方法先执行weclaw stop——它会同时通过 PID 文件和进程扫描清理残留逻辑见 cmd/stop.go提示 stale pid file 表示进程实际已退出属于陈旧 PID 文件重新weclaw start即可若配置了系统服务开机自启请改用systemctlLinux或launchctlmacOS管理服务服务文件参考 service/weclaw.service6. OpenClaw 连接失败网关地址配置方法现象openclawAgent 未被检测到或日志中出现连接错误。原因OpenClaw 优先走 HTTP 模式必须有网关地址。WeClaw 会依次从环境变量OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_TOKEN或~/.openclaw/openclaw.json读取配置详见 config/detect.go。解决方法检查环境变量是否已设置或配置文件是否存在确认网关地址可正常访问ws 协议地址会被自动转换为 http配置好后重新weclaw start日志出现openclaw using HTTP mode即配置成功7. 主动推送 API 端口 18011 无法访问现象weclaw start运行中但主动给微信推送消息的本地 API127.0.0.1:18011连接不上。解决方法先执行weclaw status确认服务确实在运行默认只监听本机127.0.0.1:18011如需跨机器访问通过环境变量WECLAW_API_ADDR修改监听地址如0.0.0.0:18011同时注意做好防火墙防护8. 版本检查与 weclaw update 更新方法现象功能表现异常时可先排除旧版本问题或更新过程中报错。解决方法查看当前版本weclaw version执行weclaw update自动下载最新二进制并替换若后台正在运行会自动重启实现见 cmd/update.go若自动重启失败终端会提示手动执行weclaw start照做即可 通用排查法先看日志再看配置如果以上 8 个问题都没有解决你的情况请优先查看日志文件——它记录了检测、启动和消息处理的全部细节日志位置~/.weclaw/weclaw.log配置文件~/.weclaw/config.json账号凭证~/.weclaw/accounts/前台运行可看到实时输出weclaw start -f完整的命令参考聊天命令、快捷别名、主动推送、Docker 部署等请查阅 README_CN.md消息处理逻辑可参考 messaging/handler.go。赞分享【免费下载链接】weclawConnect to any agents with WeChat ClawBot.项目地址https://gitcode.com/gh_mirrors/we/weclaw点击查看免费下载相关推荐终极 GitTools 故障排除指南解决下载失败、恢复不完整的 5 大实用技巧终极 GitTools 故障排除指南解决下载失败、恢复不完整的 5 大实用技巧 GitTools 是一套强大的网站安全工具集包含 GitFinder、GitReLaXed 常见问题排查Chromium 报错、超时、UTF-8 不显示的 5 个解法ReLaXed 常见问题排查Chromium 报错、超时、UTF 8 不显示的 5 个解法 ReLaXed 是一款使用 Web 技术生成 PDF 文档的开源工开发工具Pinpoint Agent启动故障排查终极指南5个常见问题快速解决Pinpoint Agent启动故障排查终极指南5个常见问题快速解决 Pinpoint Agent是业界领先的应用性能监控 APM 工具的核心组件但在实际部后端可观测性APM链路追踪微服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考