{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawdbot-skill-update",
    "name": "Clawdbot Skill Update",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update",
    "canonicalUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawdbot-skill-update",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-update",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "PUBLISH.md",
      "QUICK_REFERENCE.md",
      "README.md",
      "SKILL.md",
      "TEST.md",
      "UPDATE_CHECKLIST.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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clawdbot-skill-update"
    },
    "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/clawdbot-skill-update",
    "agentPageUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Clawdbot Update Skill",
        "body": "Comprehensive backup, update, and restore workflow for Clawdbot installations."
      },
      {
        "title": "Repository",
        "body": "GitHub: https://github.com/clawdbot/clawdbot\nUpstream: origin/main\nLocal Clone: ~/code/clawdbot (default)"
      },
      {
        "title": "Description",
        "body": "This skill provides a complete, modular update workflow for Clawdbot with dynamic workspace detection:\n\nConfiguration files\nAgent states and sessions\nCredentials and auth tokens\nAll agent workspaces (auto-detected from config)\nCron jobs and sandboxes\nGit repository state"
      },
      {
        "title": "Key Features",
        "body": "✅ Dynamic Workspace Detection - Reads workspace paths from config\n✅ Multi-Agent Support - Handles multiple agents automatically\n✅ Safe Rollback - Full restore capability\n✅ Git Integration - Tracks versions and remotes\n✅ Validation - Pre/post checks included\n✅ Dry Run - Preview before backup"
      },
      {
        "title": "Files",
        "body": "config.json - Skill configuration (repo URLs, paths)\nbackup-clawdbot-dryrun.sh - Dry run preview (no changes)\nbackup-clawdbot-full.sh - Dynamic full backup script\nrestore-clawdbot.sh - Dynamic restore script\nvalidate-setup.sh - Pre/post update validation\ncheck-upstream.sh - Check for available updates\nUPDATE_CHECKLIST.md - Step-by-step update checklist\nQUICK_REFERENCE.md - Quick command reference\nSKILL.md - This file\nREADME.md - Quick start guide"
      },
      {
        "title": "Dynamic Features",
        "body": "Both backup and restore scripts now:\n\nRead workspace paths from ~/.clawdbot/clawdbot.json\nSupport any number of agents\nHandle missing workspaces gracefully\nGenerate safe filenames from agent IDs"
      },
      {
        "title": "When to Use",
        "body": "Trigger this skill when asked to:\n\n\"update clawdbot\"\n\"upgrade to latest version\"\n\"backup clawdbot before update\"\n\"restore clawdbot from backup\"\n\"rollback clawdbot update\""
      },
      {
        "title": "1. Preview Backup (Dry Run)",
        "body": "~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh\n\nShows:\n\nWhat files would be backed up\nEstimated backup size\nWorkspace detection results\nDisk space availability\nFiles that would be skipped\n\nNo files are created or modified!"
      },
      {
        "title": "2. Create Full Backup",
        "body": "~/.skills/clawdbot-update/backup-clawdbot-full.sh\n\nBacks up:\n\n~/.clawdbot/clawdbot.json (config)\n~/.clawdbot/sessions/ (session state)\n~/.clawdbot/agents/ (multi-agent state)\n~/.clawdbot/credentials/ (auth tokens)\n~/.clawdbot/cron/ (scheduled jobs)\n~/.clawdbot/sandboxes/ (sandbox state)\nAll agent workspaces (dynamically detected!)\nGit commit and status\n\nOutput: ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/"
      },
      {
        "title": "3. Update Clawdbot",
        "body": "Follow the checklist:\n\ncat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md\n\nKey steps:\n\nCreate backup\nStop gateway\nPull latest code\nAdjust config for breaking changes\nRun doctor\nTest functionality\nStart gateway as daemon"
      },
      {
        "title": "4. Restore from Backup",
        "body": "~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS\n\nRestores:\n\nAll configuration\nAll state files\nAll workspaces\nOptionally: git version"
      },
      {
        "title": "Multi-Agent Setup",
        "body": "This skill is designed for multi-agent setups with:\n\nMultiple agents with separate workspaces\nSandbox configurations\nProvider routing (WhatsApp/Telegram/Discord/Slack/etc.)"
      },
      {
        "title": "Breaking Changes in v2026.1.8",
        "body": "CRITICAL:\n\nDM Lockdown: DMs now default to pairing policy instead of open\nGroups: telegram.groups and whatsapp.groups are now allowlists\nSandbox: Default scope changed to \"agent\" from implicit\nTimestamps: Now UTC format in agent envelopes"
      },
      {
        "title": "Backup Validation",
        "body": "After backup, always verify:\n\nBACKUP_DIR=~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS\ncat \"$BACKUP_DIR/BACKUP_INFO.txt\"\nls -lh \"$BACKUP_DIR\"\n\nShould contain:\n\n✅ clawdbot.json\n✅ credentials.tar.gz\n✅ workspace-*.tar.gz (one per agent)"
      },
      {
        "title": "Config Changes Required",
        "body": "Example: Switch WhatsApp to pairing:\n\njq '.whatsapp.dmPolicy = \"pairing\"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json\n\nExample: Set explicit sandbox scope:\n\njq '.agent.sandbox.scope = \"agent\"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json"
      },
      {
        "title": "Standard Update Flow",
        "body": "# 1. Check for updates\n~/.skills/clawdbot-update/check-upstream.sh\n\n# 2. Validate current setup\n~/.skills/clawdbot-update/validate-setup.sh\n\n# 3. Dry run\n~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh\n\n# 4. Backup\n~/.skills/clawdbot-update/backup-clawdbot-full.sh\n\n# 5. Stop gateway\ncd ~/code/clawdbot\npnpm clawdbot gateway stop\n\n# 6. Update code\ngit checkout main\ngit pull --rebase origin main\npnpm install\npnpm build\n\n# 7. Run doctor\npnpm clawdbot doctor --yes\n\n# 8. Test\npnpm clawdbot gateway start  # foreground for testing\n\n# 9. Deploy\npnpm clawdbot gateway stop\npnpm clawdbot gateway start --daemon"
      },
      {
        "title": "Rollback Flow",
        "body": "# Quick rollback\n~/.skills/clawdbot-update/restore-clawdbot.sh <backup-dir>\n\n# Manual rollback\ncd ~/code/clawdbot\ngit checkout <old-commit>\npnpm install && pnpm build\ncp <backup-dir>/clawdbot.json ~/.clawdbot/\npnpm clawdbot gateway restart"
      },
      {
        "title": "Functionality Tests",
        "body": "Provider DMs work (check pairing policy)\n Group mentions respond\n Typing indicators work\n Agent routing works\n Sandbox isolation works\n Tool restrictions enforced"
      },
      {
        "title": "New Features",
        "body": "pnpm clawdbot agents list\npnpm clawdbot logs --tail 50\npnpm clawdbot providers list --usage\npnpm clawdbot skills list"
      },
      {
        "title": "Monitoring",
        "body": "# Live logs\npnpm clawdbot logs --follow\n\n# Or Web UI\nopen http://localhost:3001/logs\n\n# Check status\npnpm clawdbot status\npnpm clawdbot gateway status"
      },
      {
        "title": "Common Issues",
        "body": "Gateway won't start:\n\npnpm clawdbot logs --grep error\npnpm clawdbot doctor\n\nAuth errors:\n\n# OAuth profiles might need re-login\npnpm clawdbot providers login <provider>\n\nSandbox issues:\n\n# Check sandbox config\njq '.agent.sandbox' ~/.clawdbot/clawdbot.json\n\n# Check per-agent sandbox\njq '.routing.agents[] | {name, sandbox}' ~/.clawdbot/clawdbot.json"
      },
      {
        "title": "Emergency Restore",
        "body": "If something goes wrong:\n\n# 1. Stop gateway\npnpm clawdbot gateway stop\n\n# 2. Full restore\nLATEST_BACKUP=$(ls -t ~/.clawdbot-backups/ | head -1)\n~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/$LATEST_BACKUP\n\n# 3. Restart\npnpm clawdbot gateway start"
      },
      {
        "title": "Via ClawdHub",
        "body": "clawdbot skills install clawdbot-update"
      },
      {
        "title": "Manual",
        "body": "git clone <repo-url> ~/.skills/clawdbot-update\nchmod +x ~/.skills/clawdbot-update/*.sh"
      },
      {
        "title": "License",
        "body": "MIT - see LICENSE"
      },
      {
        "title": "Author",
        "body": "Pascal Schott (@pasogott)\n\nContribution for Clawdbot\nhttps://github.com/clawdbot/clawdbot"
      }
    ],
    "body": "Clawdbot Update Skill\n\nComprehensive backup, update, and restore workflow for Clawdbot installations.\n\nRepository\nGitHub: https://github.com/clawdbot/clawdbot\nUpstream: origin/main\nLocal Clone: ~/code/clawdbot (default)\nDescription\n\nThis skill provides a complete, modular update workflow for Clawdbot with dynamic workspace detection:\n\nConfiguration files\nAgent states and sessions\nCredentials and auth tokens\nAll agent workspaces (auto-detected from config)\nCron jobs and sandboxes\nGit repository state\nKey Features\n\n✅ Dynamic Workspace Detection - Reads workspace paths from config\n✅ Multi-Agent Support - Handles multiple agents automatically\n✅ Safe Rollback - Full restore capability\n✅ Git Integration - Tracks versions and remotes\n✅ Validation - Pre/post checks included\n✅ Dry Run - Preview before backup\n\nFiles\nconfig.json - Skill configuration (repo URLs, paths)\nbackup-clawdbot-dryrun.sh - Dry run preview (no changes)\nbackup-clawdbot-full.sh - Dynamic full backup script\nrestore-clawdbot.sh - Dynamic restore script\nvalidate-setup.sh - Pre/post update validation\ncheck-upstream.sh - Check for available updates\nUPDATE_CHECKLIST.md - Step-by-step update checklist\nQUICK_REFERENCE.md - Quick command reference\nSKILL.md - This file\nREADME.md - Quick start guide\nDynamic Features\n\nBoth backup and restore scripts now:\n\nRead workspace paths from ~/.clawdbot/clawdbot.json\nSupport any number of agents\nHandle missing workspaces gracefully\nGenerate safe filenames from agent IDs\nWhen to Use\n\nTrigger this skill when asked to:\n\n\"update clawdbot\"\n\"upgrade to latest version\"\n\"backup clawdbot before update\"\n\"restore clawdbot from backup\"\n\"rollback clawdbot update\"\nUsage\n1. Preview Backup (Dry Run)\n~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh\n\n\nShows:\n\nWhat files would be backed up\nEstimated backup size\nWorkspace detection results\nDisk space availability\nFiles that would be skipped\n\nNo files are created or modified!\n\n2. Create Full Backup\n~/.skills/clawdbot-update/backup-clawdbot-full.sh\n\n\nBacks up:\n\n~/.clawdbot/clawdbot.json (config)\n~/.clawdbot/sessions/ (session state)\n~/.clawdbot/agents/ (multi-agent state)\n~/.clawdbot/credentials/ (auth tokens)\n~/.clawdbot/cron/ (scheduled jobs)\n~/.clawdbot/sandboxes/ (sandbox state)\nAll agent workspaces (dynamically detected!)\nGit commit and status\n\nOutput: ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/\n\n3. Update Clawdbot\n\nFollow the checklist:\n\ncat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md\n\n\nKey steps:\n\nCreate backup\nStop gateway\nPull latest code\nAdjust config for breaking changes\nRun doctor\nTest functionality\nStart gateway as daemon\n4. Restore from Backup\n~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS\n\n\nRestores:\n\nAll configuration\nAll state files\nAll workspaces\nOptionally: git version\nImportant Notes\nMulti-Agent Setup\n\nThis skill is designed for multi-agent setups with:\n\nMultiple agents with separate workspaces\nSandbox configurations\nProvider routing (WhatsApp/Telegram/Discord/Slack/etc.)\nBreaking Changes in v2026.1.8\n\nCRITICAL:\n\nDM Lockdown: DMs now default to pairing policy instead of open\nGroups: telegram.groups and whatsapp.groups are now allowlists\nSandbox: Default scope changed to \"agent\" from implicit\nTimestamps: Now UTC format in agent envelopes\nBackup Validation\n\nAfter backup, always verify:\n\nBACKUP_DIR=~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS\ncat \"$BACKUP_DIR/BACKUP_INFO.txt\"\nls -lh \"$BACKUP_DIR\"\n\n\nShould contain:\n\n✅ clawdbot.json\n✅ credentials.tar.gz\n✅ workspace-*.tar.gz (one per agent)\nConfig Changes Required\n\nExample: Switch WhatsApp to pairing:\n\njq '.whatsapp.dmPolicy = \"pairing\"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json\n\n\nExample: Set explicit sandbox scope:\n\njq '.agent.sandbox.scope = \"agent\"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json\n\nWorkflow\nStandard Update Flow\n# 1. Check for updates\n~/.skills/clawdbot-update/check-upstream.sh\n\n# 2. Validate current setup\n~/.skills/clawdbot-update/validate-setup.sh\n\n# 3. Dry run\n~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh\n\n# 4. Backup\n~/.skills/clawdbot-update/backup-clawdbot-full.sh\n\n# 5. Stop gateway\ncd ~/code/clawdbot\npnpm clawdbot gateway stop\n\n# 6. Update code\ngit checkout main\ngit pull --rebase origin main\npnpm install\npnpm build\n\n# 7. Run doctor\npnpm clawdbot doctor --yes\n\n# 8. Test\npnpm clawdbot gateway start  # foreground for testing\n\n# 9. Deploy\npnpm clawdbot gateway stop\npnpm clawdbot gateway start --daemon\n\nRollback Flow\n# Quick rollback\n~/.skills/clawdbot-update/restore-clawdbot.sh <backup-dir>\n\n# Manual rollback\ncd ~/code/clawdbot\ngit checkout <old-commit>\npnpm install && pnpm build\ncp <backup-dir>/clawdbot.json ~/.clawdbot/\npnpm clawdbot gateway restart\n\nTesting After Update\nFunctionality Tests\n Provider DMs work (check pairing policy)\n Group mentions respond\n Typing indicators work\n Agent routing works\n Sandbox isolation works\n Tool restrictions enforced\nNew Features\npnpm clawdbot agents list\npnpm clawdbot logs --tail 50\npnpm clawdbot providers list --usage\npnpm clawdbot skills list\n\nMonitoring\n# Live logs\npnpm clawdbot logs --follow\n\n# Or Web UI\nopen http://localhost:3001/logs\n\n# Check status\npnpm clawdbot status\npnpm clawdbot gateway status\n\nTroubleshooting\nCommon Issues\n\nGateway won't start:\n\npnpm clawdbot logs --grep error\npnpm clawdbot doctor\n\n\nAuth errors:\n\n# OAuth profiles might need re-login\npnpm clawdbot providers login <provider>\n\n\nSandbox issues:\n\n# Check sandbox config\njq '.agent.sandbox' ~/.clawdbot/clawdbot.json\n\n# Check per-agent sandbox\njq '.routing.agents[] | {name, sandbox}' ~/.clawdbot/clawdbot.json\n\nEmergency Restore\n\nIf something goes wrong:\n\n# 1. Stop gateway\npnpm clawdbot gateway stop\n\n# 2. Full restore\nLATEST_BACKUP=$(ls -t ~/.clawdbot-backups/ | head -1)\n~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/$LATEST_BACKUP\n\n# 3. Restart\npnpm clawdbot gateway start\n\nInstallation\nVia ClawdHub\nclawdbot skills install clawdbot-update\n\nManual\ngit clone <repo-url> ~/.skills/clawdbot-update\nchmod +x ~/.skills/clawdbot-update/*.sh\n\nLicense\n\nMIT - see LICENSE\n\nAuthor\n\nPascal Schott (@pasogott)\n\nContribution for Clawdbot\nhttps://github.com/clawdbot/clawdbot"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update",
    "publisherUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update",
    "owner": "pasogott",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawdbot-skill-update",
    "downloadUrl": "https://openagent3.xyz/downloads/clawdbot-skill-update",
    "agentUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent.md"
  }
}