← Back to Skills Marketplace
WhatsApp 428 修复
by
jeffreyCheungRT
· GitHub ↗
· v1.0.0
· MIT-0
272
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install whatsapp-428-fix
Description
修复 WhatsApp Web 连接 428 错误和代理配置问题。当用户遇到 WhatsApp 连接断开 (status 428)、需要配置代理、或在新机器上部署 OpenClaw 后遇到 WhatsApp 连接问题时使用此 Skill。
Usage Guidance
要不要安装/运行这个 Skill 前请注意：
- 脚本会在已安装的 OpenClaw 目录中原地修改文件并安装 npm 依赖，请先确认 OPENCLAW_DIR 是否正确（脚本硬编码为 /home/admind/...，很可能不适用于你的系统）。
- 在生产环境运行前，在隔离或测试环境中先执行并验证效果；检查脚本生成的 *.bak 备份以便回滚。
- 仔细审阅 scripts/fix-whatsapp-428.sh 的每一步（尤其是 sed 替换、npm install、systemd 修改与重启），确保不会意外破坏其他功能。
- 优先考虑向 OpenClaw 官方或上游仓库提交补丁/配置项（更稳健的长期解决方案），而不是直接修改已安装的包。
- 运行脚本会触发网络操作（npm install），确认网络策略和信任的 npm 包来源；仅在信任作者并已审查代码后才执行。
如果你能提供你系统上 OpenClaw 的实际安装路径及用户（或让脚本使用可检测的路径替代硬编码值），可以显著降低风险并提升可接受性。
Capability Analysis
Type: OpenClaw Skill
Name: whatsapp-428-fix
Version: 1.0.0
The skill performs invasive modifications to the OpenClaw source code and systemd service configurations to implement proxy support. It uses `sed` to patch JavaScript files in the `dist` directory and executes `npm install` to add the `https-proxy-agent` dependency. While these actions are aligned with the stated goal of fixing WhatsApp connectivity issues, the direct modification of application binaries and system services without proper package management or build processes poses a significant risk to system integrity and stability. (File: scripts/fix-whatsapp-428.sh, SKILL.md)
Capability Assessment
Purpose & Capability
宣称修复 WhatsApp 428 并添加 proxy 支持；脚本和文档确实修改 OpenClaw 的 schema、session、channel 以及 systemd 服务以传入代理，这与目标一致。但实现方式是直接在已安装的 node_modules 中做原地修改（并通过 npm 安装依赖），这是侵入性的而非通过官方扩展或配置项完成。
Instruction Scope
SKILL.md 指示运行包含在包内的自动修复脚本并给出逐步手动修改步骤。脚本会查找并修改安装目录下的多个已编译/打包文件、备份原文件、改写 systemd 单元并重启 gateway。这些步骤超出“仅在技能目录内操作”的范围，且 SKILL.md 与脚本均假定特定路径（见下文），缺乏对不同部署环境的防护与回滚说明。
Install Mechanism
这是 instruction-only，但包含并建议运行一个脚本，该脚本会在硬编码的 OPENCLAW_DIR 下运行 npm install https-proxy-agent（网络操作并修改 node_modules），并使用 sed 修改编译后的文件。虽然不从可疑 URL 下载二进制，但在运行环境中原地修改已安装软件并安装 npm 包存在中度风险（可能引入兼容性或安全问题）。
Credentials
Skill 声称不需要任何环境变量或凭证，脚本也不尝试读取远端凭证或外部密钥。问题在于脚本硬编码 OPENCLAW_DIR=/home/admind/..., 假定特定用户路径而非使用通用检测（如 npm root 或 $HOME），这暗含对特定主机/用户环境的依赖并可能导致误修改或失败。
Persistence & Privilege
虽然 always:false，脚本会对系统产生持久更改：备份并改写 OpenClaw 的分发目录文件，向 systemd user 单元写入代理环境变量，并执行 openclaw gateway restart。这些持久修改影响平台运行时行为，应在备份和审计下谨慎执行。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whatsapp-428-fix - After installation, invoke the skill by name or use
/whatsapp-428-fix - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the whatsapp-428-fix skill.
- Provides automated and manual steps to fix WhatsApp Web connection error 428 and related proxy configuration issues.
- Includes detailed systemd service and OpenClaw configuration instructions.
- Offers necessary code modifications for OpenClaw to support proxy settings at both the schema and session level.
- Supports multi-account proxy configuration.
Metadata
Frequently Asked Questions
What is WhatsApp 428 修复?
修复 WhatsApp Web 连接 428 错误和代理配置问题。当用户遇到 WhatsApp 连接断开 (status 428)、需要配置代理、或在新机器上部署 OpenClaw 后遇到 WhatsApp 连接问题时使用此 Skill。 It is an AI Agent Skill for Claude Code / OpenClaw, with 272 downloads so far.
How do I install WhatsApp 428 修复?
Run "/install whatsapp-428-fix" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WhatsApp 428 修复 free?
Yes, WhatsApp 428 修复 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does WhatsApp 428 修复 support?
WhatsApp 428 修复 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WhatsApp 428 修复?
It is built and maintained by jeffreyCheungRT (@jeffreycheungrt); the current version is v1.0.0.
More Skills