← 返回
沟通协作

WhatsApp 428 修复

修复 WhatsApp Web 连接 428 错误和代理配置问题。当用户遇到 WhatsApp 连接断开 (status 428)、需要配置代理、或在新机器上部署 OpenClaw 后遇到 WhatsApp 连接问题时使用此 Skill。
修复 WhatsApp Web 连接 428 错误和代理配置问题。当用户遇到 WhatsApp 连接断开 (status 428)、需要配置代理、或在新机器上部署 OpenClaw 后遇到 WhatsApp 连接问题时使用此 Skill。
jeffreycheungrt
沟通协作 clawhub v1.0.0 1 版本 100000 Key: 无需
★ 0
Stars
📥 607
下载
💾 16
安装
1
版本
#latest

概述

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-*.jsWhatsAppSharedSchema 中添加:

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

版本历史

共 1 个版本

  • v1.0.0 当前
    2026-03-20 02:48 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

communication-collaboration

Gmail

byungkyu
Gmail API 集成,托管 OAuth,支持读取、发送和管理邮件、线程、标签及草稿,适用于需要与 Gmail 交互的场景。
★ 72 📥 37,718
communication-collaboration

Himalaya

lamelas
{"answer":"通过IMAP/SMTP管理邮件的CLI。可在终端使用 `himalaya` 收发、回复、转发、搜索及整理邮件。支持多账户与MML(MIME元语言)编写邮件。"}
★ 68 📥 45,577
communication-collaboration

imap-smtp-email

gzlicanyi
使用IMAP/SMTP读取和发送邮件;检查新/未读邮件、获取内容、搜索邮箱、标记已读/未读、发送带附件的邮件。支持...
★ 113 📥 52,385