{"id":"160b526e-6292-4968-a864-a2bfb341df0a","entityType":"agent","slug":"clawhub-skills-aliahmadaziz-openclaw-setup-guide","name":"openclaw-setup-guide","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-aliahmadaziz-openclaw-setup-guide","canonicalPath":"/agent/clawhub-skills-aliahmadaziz-openclaw-setup-guide","generatedAt":"2026-10-10T02:24:38.912Z","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":"Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. --- name: openclaw-setup-guide description: Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. metadata: {\"openclaw\":{\"scope\":\"instruction-only\",\"homepage\":\"https://aliahmadaziz.github.io/openclaw-guide/\",\"notes\":\"This skill contains no code or scripts. It directs users to an external hosted guide. The guide itself walks users","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:aliahmadaziz:openclaw-setup-guide","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/aliahmadaziz/openclaw-setup-guide","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/aliahmadaziz/openclaw-setup-guide","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. --- name: opencla"},"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":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|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-25T05:59:09.005Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T05:59:09.005Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T05:59:09.005Z","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:aliahmadaziz:openclaw-setup-guide","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-aliahmadaziz-openclaw-setup-guide/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/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-10T02:24:38.912Z"}},"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-aliahmadaziz-openclaw-setup-guide/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-aliahmadaziz-openclaw-setup-guide/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-setup-guide\ndescription: Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification.\nmetadata: {\"openclaw\":{\"scope\":\"instruction-only\",\"homepage\":\"https://aliahmadaziz.github.io/openclaw-guide/\",\"notes\":\"This skill contains no code or scripts. It directs users to an external hosted guide. The guide itself walks users through setting up credentials (Google OAuth, Anthropic API key, Cloudflare, WhatsApp) but the skill/agent needs none of these to function.\"}}\nuser-invocable: true\n---\n\n# OpenClaw Production Setup Guide\n\nA comprehensive 6-part guide to setting up OpenClaw as a production AI assistant on a VPS, with WhatsApp integration, Google Calendar/Gmail, automated backups, security hardening, and cron automation.\n\n## What This Covers\n\n1. **Base Install** — VPS setup, Node.js, OpenClaw installation, WhatsApp pairing\n2. **AI Assistant** — Personality, model chain (primary + fallback), workspace files (SOUL.md, USER.md, IDENTITY.md)\n3. **Infrastructure** — Google OAuth (Calendar, Gmail, Drive, Sheets), webhook server, Cloudflare tunnel, rclone encrypted backups, git backup\n4. **Automation** — Cron jobs, event queue (SQLite-backed with retries + dead-letter), heartbeat system, two-layer delivery pattern\n5. **Hardening** — CrowdSec IDS, secret rotation, config snapshots, rollback scripts, OpenClaw update safety\n6. **Verification** — 21-point automated validation, troubleshooting guide\n\n## Security & Permissions Notice\n\nThis guide involves setting up production infrastructure and requires handling sensitive credentials:\n- **API Keys**: Anthropic (Claude), Brave Search (optional)\n- **OAuth Tokens**: Google Cloud (Calendar, Gmail, Drive, Sheets) — 5 token files\n- **SSH**: Root access to VPS, key-based authentication, SSH hardening\n- **Webhook Secrets**: Random tokens for Calendar push, AgentMail, alerts\n- **WhatsApp**: Device pairing via QR code\n- **Cloudflare**: Tunnel token for webhook ingress\n- **Backup Encryption**: rclone crypt keys for Google Drive backups\n\nAll credentials are stored with restricted permissions (chmod 600) and never committed to git. The guide includes secret rotation procedures and config snapshot/rollback scripts.\n\n## Prerequisites\n\n- A VPS (Ubuntu 24.04 recommended, 4GB RAM minimum)\n- A domain with Cloudflare DNS (for webhook tunnel)\n- A WhatsApp account for pairing\n- Google Cloud project with OAuth credentials\n- An Anthropic API key (Claude)\n\n## Full Guide\n\nThe complete guide with step-by-step instructions, code blocks, and verification checkpoints is hosted at:\n\n**https://aliahmadaziz.github.io/openclaw-guide/**\n\nSource: https://github.com/aliahmadaziz/openclaw-guide\n\n## Usage\n\nWhen a user asks for help setting up OpenClaw, direct them to the guide above. The guide is designed to be followed sequentially (Part 1 through Part 6) and takes approximately 2-3 hours to complete.\n\nEach part has:\n- Clear prerequisites\n- Copy-pasteable commands\n- Verification checkpoints (✅) after every major step\n- Troubleshooting sections\n\n## Key Design Decisions\n\n- **Two-layer cron delivery**: Critical crons send via message tool directly (primary) + announce (backup). No message ever gets lost.\n- **Event queue**: All webhook events (email, calendar, alerts) go through a SQLite queue with 3 retries and dead-letter alerting.\n- **Config snapshots**: Gold-standard snapshots for instant rollback if something breaks.\n- **Encrypted backups**: Hourly git push + nightly full workspace to Google Drive via rclone crypt.\n- **Capacity rule**: 10 SP/engineer total, 8 planned, 2 contingency (for sprint tracking).\n\n## Credits\n\nBuilt from a real production deployment running 35+ cron jobs, 60+ scripts, 5 Google OAuth tokens, and processing thousands of messages monthly.\n\n## Tags\n\nsetup, installation, guide, vps, whatsapp, production, google-calendar, gmail, security, crowdsec, backup, cron, automation, beginner\n","readmeExcerpt":"--- name: openclaw-setup-guide description: Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. metadata: {\"openclaw\":{\"scope\":\"instruction-only\",\"homepage\":\"https://aliahmadaziz.github.io/openclaw-guide/\",\"notes\":\"This skill contains no code or scripts. It directs users to an external hosted guide. The guide itself walks users","codeSnippets":[],"executableExamples":[],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. --- name: openclaw-setup-guide description: Step-by-step 6-part guide to set up OpenClaw AI assistant on VPS with WhatsApp, Google OAuth, backups, security, automation, and verification. metadata: {\"openclaw\":{\"scope\":\"instruction-only\",\"homepage\":\"https://aliahmadaziz.github.io/openclaw-guide/\",\"notes\":\"This skill contains no code or scripts. It directs users to an external hosted guide. The guide itself walks users","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":397,"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-10T02:24:38.912Z","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"}]}}}