WhatsApp 428 修复

修复 WhatsApp Web 连接 428 错误和代理配置问题。当用户遇到 WhatsApp 连接断开 (status 428)、需要配置代理、或在新机器上部署 OpenClaw 后遇到 WhatsApp 连接问题时使用此 Skill。

Security Scan

这个 Skill 的目的（通过代理修复 WhatsApp Web 428）与其行为大体一致，但脚本在多处做出侵入性、本地化的修改（硬编码路径、修改已安装的 OpenClaw 包、在 systemd 中写入代理并安装 npm 包），这些做法不够通用且有潜在风险，安装前需谨慎审查并在测试环境验证。

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。这些持久修改影响平台运行时行为，应在备份和审计下谨慎执行。

What to consider before installing

要不要安装/运行这个 Skill 前请注意： - 脚本会在已安装的 OpenClaw 目录中原地修改文件并安装 npm 依赖，请先确认 OPENCLAW_DIR 是否正确（脚本硬编码为 /home/admind/...，很可能不适用于你的系统）。 - 在生产环境运行前，在隔离或测试环境中先执行并验证效果；检查脚本生成的 *.bak 备份以便回滚。 - 仔细审阅 scripts/fix-whatsapp-428.sh 的每一步（尤其是 sed 替换、npm install、systemd 修改与重启），确保不会意外破坏其他功能。 - 优先考虑向 OpenClaw 官方或上游仓库提交补丁/配置项（更稳健的长期解决方案），而不是直接修改已安装的包。 - 运行脚本会触发网络操作（npm install），确认网络策略和信任的 npm 包来源；仅在信任作者并已审查代码后才执行。 如果你能提供你系统上 OpenClaw 的实际安装路径及用户（或让脚本使用可检测的路径替代硬编码值），可以显著降低风险并提升可接受性。

WhatsApp 428 问题修复

快速修复

运行自动修复脚本：

bash /home/admind/.openclaw/workspace/skills/whatsapp-428-fix/scripts/fix-whatsapp-428.sh

手动修复步骤

1. 检查当前状态

openclaw status --deep
openclaw channels status

2. 获取本地 IP

LOCAL_IP=$(hostname -I | awk '{print $1}')
echo "本地IP: $LOCAL_IP"

3. 修改 systemd service 配置

编辑 ~/.config/systemd/user/openclaw-gateway.service，添加代理环境变量：

[Service]
Environment=HTTP_PROXY=http://LOCAL_IP:10808
Environment=HTTPS_PROXY=http://LOCAL_IP:10808
Environment=ALL_PROXY=http://LOCAL_IP:10808

4. 重新加载并重启

systemctl --user daemon-reload
openclaw gateway restart

5. 验证

openclaw logs --follow | grep -i whatsapp

注意事项

• 状态码 428 是 WhatsApp Web 本身机制，配置代理后可更快自动恢复
• 代理端口 10808 需根据实际代理服务调整

---

代码级修复（必选）

需要修改 OpenClaw 源码以支持 proxy，按以下步骤修改：

1. 添加配置 Schema

在 auth-profiles-*.js 的 WhatsAppSharedSchema 中添加：

proxy: z.string().url().optional()

2. 修改 session.ts

添加 HttpsProxyAgent 支持：

import { HttpsProxyAgent } from "https-proxy-agent";

// 在 makeWASocket 调用中添加 agent
const agent = new HttpsProxyAgent(opts.proxy);

3. 修改 createWaSocket 调用

在 channel-web-*.js 中传入 proxy 参数：

const sock = await createWaSocket(false, options.verbose, { 
  authDir: options.authDir, 
  proxy: options.proxy 
});

4. 账户级别 proxy 配置（多账户）

proxy: account.proxy