{"id":"e6b19198-ace7-4ddc-a0ae-6e4981bd0948","entityType":"agent","slug":"clawhub-skills-0xs4m1337-openclaw-whatsapp","name":"openclaw-whatsapp","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-0xs4m1337-openclaw-whatsapp","canonicalPath":"/agent/clawhub-skills-0xs4m1337-openclaw-whatsapp","generatedAt":"2026-10-10T06:53:37.756Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- name: openclaw-whatsapp description: WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- openclaw-whatsapp WhatsApp bridge that connects OpenClaw agents to WhatsApp. Send messages, auto-reply to DMs with AI, search message history, and sync contacts — all from a single Go binary. Quick Reference Full Setup (Self-Service) Follow these steps to set u","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:0xs4m1337:openclaw-whatsapp","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/0xs4m1337/openclaw-whatsapp","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/0xs4m1337/openclaw-whatsapp","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- name: openclaw-whatsapp description: Whats"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"the","status":"self-declared"},{"label":"qr","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":3,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"the","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"qr","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:the|supported|profile capability:qr|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No source adoption metrics were available."},"stars":null,"forks":null,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T06:16:21.762Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T06:16:21.762Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T06:16:21.762Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install skills:0xs4m1337:openclaw-whatsapp","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T06:53:37.756Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-0xs4m1337-openclaw-whatsapp/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"---\nname: openclaw-whatsapp\ndescription: WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync\n---\n\n# openclaw-whatsapp\n\nWhatsApp bridge that connects OpenClaw agents to WhatsApp. Send messages, auto-reply to DMs with AI, search message history, and sync contacts — all from a single Go binary.\n\n## Quick Reference\n\n```bash\n# Check status\nopenclaw-whatsapp status\n\n# Send a message\nopenclaw-whatsapp send \"NUMBER@s.whatsapp.net\" \"Your message\"\n\n# View logs (if running as service)\njournalctl --user -u openclaw-whatsapp.service -f\n\n# View worker logs\ntail -f /tmp/openclaw-wa-agent/worker.log\n```\n\n## Full Setup (Self-Service)\n\nFollow these steps to set up WhatsApp auto-reply from scratch.\n\n### Step 1: Install the binary\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/0xs4m1337/openclaw-whatsapp/main/install.sh | bash\n```\n\nVerify installation:\n```bash\nopenclaw-whatsapp version\n```\n\n### Step 2: Find your openclaw binary path\n\n```bash\nwhich openclaw\n# Example output: /home/USER/.nvm/versions/node/v22.22.0/bin/openclaw\n```\n\nSave this path — you'll need it in Step 4.\n\n### Step 3: Install relay scripts\n\nCopy scripts from this skill directory:\n\n```bash\nSKILL_DIR=\"$(dirname \"$(realpath \"$0\")\")\"  # or use absolute path to skill\n\n# Copy scripts\nsudo cp \"$SKILL_DIR/scripts/wa-notify.sh\" /usr/local/bin/wa-notify.sh\nsudo cp \"$SKILL_DIR/scripts/wa-notify-worker.sh\" /usr/local/bin/wa-notify-worker.sh\nsudo chmod +x /usr/local/bin/wa-notify.sh /usr/local/bin/wa-notify-worker.sh\n```\n\nOr if running as agent, use the skill directory path directly:\n```bash\ncp ~/clawd/skills/openclaw-whatsapp/scripts/wa-notify.sh /usr/local/bin/\ncp ~/clawd/skills/openclaw-whatsapp/scripts/wa-notify-worker.sh /usr/local/bin/\nchmod +x /usr/local/bin/wa-notify.sh /usr/local/bin/wa-notify-worker.sh\n```\n\n### Step 4: Configure the worker script\n\nEdit `/usr/local/bin/wa-notify-worker.sh` and update the PATH line with your openclaw binary path from Step 2:\n\n```bash\n# Find this line near the top:\nexport PATH=\"/home/oussama/.nvm/versions/node/v22.22.0/bin:$PATH\"\n\n# Change it to your actual path:\nexport PATH=\"/home/YOUR_USER/.nvm/versions/node/vXX.XX.X/bin:$PATH\"\n```\n\nAlso update the worker script path in `/usr/local/bin/wa-notify.sh`:\n```bash\n# Find this line near the bottom:\nnohup /home/oussama/dev/openclaw-whatsapp/scripts/wa-notify-worker.sh\n\n# Change to:\nnohup /usr/local/bin/wa-notify-worker.sh\n```\n\n### Step 5: Create config file\n\n```bash\nmkdir -p ~/.openclaw-whatsapp\ncat > ~/.openclaw-whatsapp/config.yaml << 'EOF'\nport: 8555\ndata_dir: ~/.openclaw-whatsapp\nauto_reconnect: true\nreconnect_interval: 30s\nlog_level: info\n\nagent:\n  enabled: true\n  mode: \"command\"\n  command: \"/usr/local/bin/wa-notify.sh '{name}' '{message}' '{chat_jid}' '{message_id}'\"\n  ignore_from_me: true\n  dm_only: true\n  timeout: 30s\n  system_prompt: |\n    You are a helpful WhatsApp assistant. Be concise and natural.\nEOF\n```\n\n### Step 6: Create systemd service (recommended)\n\n```bash\nmkdir -p ~/.config/systemd/user\n\ncat > ~/.config/systemd/user/openclaw-whatsapp.service << 'EOF'\n[Unit]\nDescription=OpenClaw WhatsApp Bridge\nAfter=network.target\n\n[Service]\nType=simple\nExecStart=/usr/local/bin/openclaw-whatsapp start -c %h/.openclaw-whatsapp/config.yaml\nRestart=always\nRestartSec=5\n\n[Install]\nWantedBy=default.target\nEOF\n\nsystemctl --user daemon-reload\nsystemctl --user enable openclaw-whatsapp.service\nsystemctl --user start openclaw-whatsapp.service\n```\n\n### Step 7: Link WhatsApp\n\n1. Check bridge is running: `openclaw-whatsapp status`\n2. Open QR page: `http://localhost:8555/qr`\n3. On your phone: WhatsApp → Settings → Linked Devices → Link a Device\n4. Scan the QR code\n\n### Step 8: Test\n\nSend a WhatsApp message to the linked number from another phone. Check:\n```bash\n# Bridge logs\njournalctl --user -u openclaw-whatsapp.service -n 20\n\n# Worker logs\ncat /tmp/openclaw-wa-agent/worker.log\n```\n\n## Architecture\n\n```\nWhatsApp DM → Bridge → wa-notify.sh (enqueue)\n  → wa-notify-worker.sh (background, file-locked)\n  → Fetches last 10 messages for context\n  → openclaw agent (processes message)\n  → openclaw-whatsapp send <JID> <reply>\n  → WhatsApp reply sent\n```\n\nKey features:\n- **Fast enqueue** — bridge doesn't wait for agent processing\n- **Deduplication** — message IDs tracked to prevent double-replies\n- **Single worker** — file-locked, sequential processing, no race conditions\n- **Crash resilience** — queue persists across restarts\n\n## Customizing System Prompt\n\nEdit `~/.openclaw-whatsapp/config.yaml` and update the `system_prompt` field:\n\n```yaml\nagent:\n  system_prompt: |\n    You are a sales assistant for Acme Corp.\n    Be friendly and professional.\n    When someone wants to book a demo:\n    - Book via: mcporter call composio.GOOGLECALENDAR_CREATE_EVENT ...\n    - Notify team via: message action=send channel=telegram target=CHAT_ID ...\n```\n\nRestart after changes:\n```bash\nsystemctl --user restart openclaw-whatsapp.service\n```\n\n## Allowlist / Blocklist\n\nRestrict which numbers the agent responds to:\n\n```yaml\nagent:\n  allowlist: [\"971586971337\"]  # only these (empty = all)\n  blocklist: [\"spammer123\"]     # never these\n```\n\n## CLI Reference\n\n```bash\nopenclaw-whatsapp start [-c config.yaml]  # Start the bridge\nopenclaw-whatsapp status [--addr URL]      # Check connection status\nopenclaw-whatsapp send NUMBER MESSAGE      # Send a message\nopenclaw-whatsapp stop                     # Stop the bridge\nopenclaw-whatsapp version                  # Print version\n```\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| QR expired | Refresh http://localhost:8555/qr — auto-refreshes every 3s |\n| Bridge disconnected | `openclaw-whatsapp status`; auto-reconnects by default |\n| Agent not replying | Check `/tmp/openclaw-wa-agent/worker.log` for errors |\n| \"stream replaced\" errors | Multiple bridge instances — ensure only one runs (`systemctl --user status openclaw-whatsapp` + `pgrep openclaw-whatsapp`) |\n| \"openclaw: not found\" | Edit wa-notify-worker.sh PATH to include openclaw binary |\n| \"not logged in\" | Scan QR again — session expired |\n\n## Files\n\n| Path | Description |\n|------|-------------|\n| `~/.openclaw-whatsapp/config.yaml` | Bridge configuration |\n| `~/.openclaw-whatsapp/messages.db` | SQLite message store |\n| `~/.openclaw-whatsapp/sessions/` | WhatsApp session data |\n| `/tmp/openclaw-wa-agent/queue.jsonl` | Message queue |\n| `/tmp/openclaw-wa-agent/worker.log` | Worker logs |\n| `/tmp/openclaw-wa-agent/seen_message_ids.txt` | Deduplication list |\n\n## API Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| `GET` | `/status` | Connection status |\n| `GET` | `/qr` | QR code page |\n| `POST` | `/send/text` | Send message `{\"to\": \"...\", \"message\": \"...\"}` |\n| `GET` | `/chats` | List all chats |\n| `GET` | `/chats/{jid}/messages?limit=10` | Messages for a chat |\n| `GET` | `/messages/search?q=keyword` | Full-text search |\n\nSee [references/api-reference.md](references/api-reference.md) for full API docs.\n","readmeExcerpt":"--- name: openclaw-whatsapp description: WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- openclaw-whatsapp WhatsApp bridge that connects OpenClaw agents to WhatsApp. Send messages, auto-reply to DMs with AI, search message history, and sync contacts — all from a single Go binary. Quick Reference Full Setup (Self-Service) Follow these steps to set u","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Check status\nopenclaw-whatsapp status\n\n# Send a message\nopenclaw-whatsapp send \"NUMBER@s.whatsapp.net\" \"Your message\"\n\n# View logs (if running as service)\njournalctl --user -u openclaw-whatsapp.service -f\n\n# View worker logs\ntail -f /tmp/openclaw-wa-agent/worker.log"},{"language":"bash","snippet":"curl -fsSL https://raw.githubusercontent.com/0xs4m1337/openclaw-whatsapp/main/install.sh | bash"},{"language":"bash","snippet":"curl -fsSL https://raw.githubusercontent.com/0xs4m1337/openclaw-whatsapp/main/install.sh | bash"},{"language":"bash","snippet":"openclaw-whatsapp version"},{"language":"bash","snippet":"which openclaw\n# Example output: /home/USER/.nvm/versions/node/v22.22.0/bin/openclaw"},{"language":"bash","snippet":"SKILL_DIR=\"$(dirname \"$(realpath \"$0\")\")\"  # or use absolute path to skill\n\n# Copy scripts\nsudo cp \"$SKILL_DIR/scripts/wa-notify.sh\" /usr/local/bin/wa-notify.sh\nsudo cp \"$SKILL_DIR/scripts/wa-notify-worker.sh\" /usr/local/bin/wa-notify-worker.sh\nsudo chmod +x /usr/local/bin/wa-notify.sh /usr/local/bin/wa-notify-worker.sh"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- name: openclaw-whatsapp description: WhatsApp bridge for OpenClaw — send/receive messages, auto-reply agents, QR pairing, message search, contact sync --- openclaw-whatsapp WhatsApp bridge that connects OpenClaw agents to WhatsApp. Send messages, auto-reply to DMs with AI, search message history, and sync contacts — all from a single Go binary. Quick Reference Full Setup (Self-Service) Follow these steps to set u","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":377,"uniquenessScore":64,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:53:37.756Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}