{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-setup-guide",
    "name": "OpenClaw Production Setup Guide",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/aliahmadaziz/openclaw-setup-guide",
    "canonicalUrl": "https://clawhub.ai/aliahmadaziz/openclaw-setup-guide",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-setup-guide",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-setup-guide",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-setup-guide",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T21:37:16.659Z",
      "expiresAt": "2026-05-07T21:37:16.659Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-setup-guide",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-setup-guide",
        "contentDisposition": "attachment; filename=\"openclaw-setup-guide-1.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "openclaw-setup-guide"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-setup-guide"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-setup-guide",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenClaw Production Setup Guide",
        "body": "A 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."
      },
      {
        "title": "What This Covers",
        "body": "Base Install — VPS setup, Node.js, OpenClaw installation, WhatsApp pairing\nAI Assistant — Personality, model chain (primary + fallback), workspace files (SOUL.md, USER.md, IDENTITY.md)\nInfrastructure — Google OAuth (Calendar, Gmail, Drive, Sheets), webhook server, Cloudflare tunnel, rclone encrypted backups, git backup\nAutomation — Cron jobs, event queue (SQLite-backed with retries + dead-letter), heartbeat system, two-layer delivery pattern\nHardening — CrowdSec IDS, secret rotation, config snapshots, rollback scripts, OpenClaw update safety\nVerification — 21-point automated validation, troubleshooting guide"
      },
      {
        "title": "Security & Permissions Notice",
        "body": "This guide involves setting up production infrastructure and requires handling sensitive credentials:\n\nAPI Keys: Anthropic (Claude), Brave Search (optional)\nOAuth Tokens: Google Cloud (Calendar, Gmail, Drive, Sheets) — 5 token files\nSSH: Root access to VPS, key-based authentication, SSH hardening\nWebhook Secrets: Random tokens for Calendar push, AgentMail, alerts\nWhatsApp: Device pairing via QR code\nCloudflare: Tunnel token for webhook ingress\nBackup 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."
      },
      {
        "title": "Prerequisites",
        "body": "A VPS (Ubuntu 24.04 recommended, 4GB RAM minimum)\nA domain with Cloudflare DNS (for webhook tunnel)\nA WhatsApp account for pairing\nGoogle Cloud project with OAuth credentials\nAn Anthropic API key (Claude)"
      },
      {
        "title": "Full Guide",
        "body": "The complete guide with step-by-step instructions, code blocks, and verification checkpoints is hosted at:\n\nhttps://aliahmadaziz.github.io/openclaw-guide/\n\nSource: https://github.com/aliahmadaziz/openclaw-guide"
      },
      {
        "title": "Usage",
        "body": "When 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\nClear prerequisites\nCopy-pasteable commands\nVerification checkpoints (✅) after every major step\nTroubleshooting sections"
      },
      {
        "title": "Key Design Decisions",
        "body": "Two-layer cron delivery: Critical crons send via message tool directly (primary) + announce (backup). No message ever gets lost.\nEvent queue: All webhook events (email, calendar, alerts) go through a SQLite queue with 3 retries and dead-letter alerting.\nConfig snapshots: Gold-standard snapshots for instant rollback if something breaks.\nEncrypted backups: Hourly git push + nightly full workspace to Google Drive via rclone crypt.\nCapacity rule: 10 SP/engineer total, 8 planned, 2 contingency (for sprint tracking)."
      },
      {
        "title": "Credits",
        "body": "Built from a real production deployment running 35+ cron jobs, 60+ scripts, 5 Google OAuth tokens, and processing thousands of messages monthly."
      },
      {
        "title": "Tags",
        "body": "setup, installation, guide, vps, whatsapp, production, google-calendar, gmail, security, crowdsec, backup, cron, automation, beginner"
      }
    ],
    "body": "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\nWhat This Covers\nBase Install — VPS setup, Node.js, OpenClaw installation, WhatsApp pairing\nAI Assistant — Personality, model chain (primary + fallback), workspace files (SOUL.md, USER.md, IDENTITY.md)\nInfrastructure — Google OAuth (Calendar, Gmail, Drive, Sheets), webhook server, Cloudflare tunnel, rclone encrypted backups, git backup\nAutomation — Cron jobs, event queue (SQLite-backed with retries + dead-letter), heartbeat system, two-layer delivery pattern\nHardening — CrowdSec IDS, secret rotation, config snapshots, rollback scripts, OpenClaw update safety\nVerification — 21-point automated validation, troubleshooting guide\nSecurity & Permissions Notice\n\nThis guide involves setting up production infrastructure and requires handling sensitive credentials:\n\nAPI Keys: Anthropic (Claude), Brave Search (optional)\nOAuth Tokens: Google Cloud (Calendar, Gmail, Drive, Sheets) — 5 token files\nSSH: Root access to VPS, key-based authentication, SSH hardening\nWebhook Secrets: Random tokens for Calendar push, AgentMail, alerts\nWhatsApp: Device pairing via QR code\nCloudflare: Tunnel token for webhook ingress\nBackup 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\nPrerequisites\nA VPS (Ubuntu 24.04 recommended, 4GB RAM minimum)\nA domain with Cloudflare DNS (for webhook tunnel)\nA WhatsApp account for pairing\nGoogle Cloud project with OAuth credentials\nAn Anthropic API key (Claude)\nFull Guide\n\nThe complete guide with step-by-step instructions, code blocks, and verification checkpoints is hosted at:\n\nhttps://aliahmadaziz.github.io/openclaw-guide/\n\nSource: https://github.com/aliahmadaziz/openclaw-guide\n\nUsage\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\nClear prerequisites\nCopy-pasteable commands\nVerification checkpoints (✅) after every major step\nTroubleshooting sections\nKey Design Decisions\nTwo-layer cron delivery: Critical crons send via message tool directly (primary) + announce (backup). No message ever gets lost.\nEvent queue: All webhook events (email, calendar, alerts) go through a SQLite queue with 3 retries and dead-letter alerting.\nConfig snapshots: Gold-standard snapshots for instant rollback if something breaks.\nEncrypted backups: Hourly git push + nightly full workspace to Google Drive via rclone crypt.\nCapacity rule: 10 SP/engineer total, 8 planned, 2 contingency (for sprint tracking).\nCredits\n\nBuilt from a real production deployment running 35+ cron jobs, 60+ scripts, 5 Google OAuth tokens, and processing thousands of messages monthly.\n\nTags\n\nsetup, installation, guide, vps, whatsapp, production, google-calendar, gmail, security, crowdsec, backup, cron, automation, beginner"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aliahmadaziz/openclaw-setup-guide",
    "publisherUrl": "https://clawhub.ai/aliahmadaziz/openclaw-setup-guide",
    "owner": "aliahmadaziz",
    "version": "1.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-setup-guide",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-setup-guide",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-setup-guide/agent.md"
  }
}