whatsapp-diagnostics

Diagnose WhatsApp connectivity issues for OpenAI agents via CLI commands.

5|1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/netanel-abergel/pa-skills --skill whatsapp-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whatsapp-diagnostics
Source: https://github.com/netanel-abergel/pa-skills/tree/main/skills/whatsapp-diagnostics
Command: npx skills add https://github.com/netanel-abergel/pa-skills --skill whatsapp-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps identify and resolve WhatsApp connectivity problems for OpenClaw agents when the agent is unresponsive, messages do not arrive, or replies are not sent despite a connected channel.

Core Features & Use Cases

  • Connection Issue Detection: Checks if the WhatsApp channel is linked and guides reconnection.
  • Ingest Issue Diagnosis: Verifies gateway status and message counts to spot ingest failures.
  • Runtime Issue Investigation: Validates API keys and scans agent logs for runtime errors.
  • Quick Health Check Script: Provides a single command to gather gateway, API key, and error status.
  • Escalation Guidance: Supplies clear steps for involving platform administrators when needed.

Quick Start

Run the WhatsApp diagnostics skill to check my agent's WhatsApp connection.

Frequently Asked Questions about whatsapp-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose WhatsApp connectivity issues when my agent is unresponsive?

To diagnose WhatsApp connectivity issues, you can run CLI commands to check the gateway status, validate API keys, and review message counts. This identifies whether the unresponsive agent is caused by connection, ingest, or runtime failures.

Why are messages failing to arrive or replies not sent despite a connected WhatsApp channel?

Messages fail to arrive or replies are not sent due to gateway ingest failures or invalid API keys. You can verify gateway status and scan agent logs for runtime errors to pinpoint the exact disconnect.

What is the best way to check WhatsApp gateway status and API key validity?

The best way to check WhatsApp gateway status and API key validity is running a quick health check script. This single command gathers gateway, API key, and error status to rapidly surface connectivity problems.

Do I need the OpenClaw CLI to troubleshoot WhatsApp message delivery problems?

Yes, you need the OpenClaw CLI and environment variables for API keys to troubleshoot WhatsApp message delivery problems. The diagnostics run CLI commands to check gateway status, validate keys, and count messages.

What should I do when WhatsApp connectivity problems persist after running diagnostics?

When WhatsApp connectivity problems persist after diagnostics, you should follow escalation guidance to involve platform administrators. This provides clear steps for resolving issues beyond gateway or API key fixes.

Can I detect if my WhatsApp channel is unlinked and guide reconnection?

Yes, you can detect if your WhatsApp channel is unlinked and guide reconnection. The connection issue detection feature checks channel link status and provides steps to re-establish the connection.