{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawctl",
    "name": "Clawctl",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/lludlow/clawctl",
    "canonicalUrl": "https://clawhub.ai/lludlow/clawctl",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawctl",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawctl",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CLAUDE.md",
      "README.md",
      "SKILL.md",
      "clawctl/__init__.py",
      "clawctl/cli.py",
      "clawctl/db.py"
    ],
    "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/clawctl"
    },
    "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/clawctl",
    "agentPageUrl": "https://openagent3.xyz/skills/clawctl/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawctl/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawctl/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": "Setup",
        "body": "clawctl init                        # create the database\nexport CLAW_AGENT=your-name         # set identity (falls back to $USER with warning)\nexport CLAW_DB=~/.openclaw/clawctl.db  # optional, this is the default"
      },
      {
        "title": "Operational Rhythm",
        "body": "Follow this pattern every session:\n\nclawctl checkin — register presence, see unread count\nclawctl inbox --unread — read messages before picking up work\nclawctl next — find highest-priority actionable task (or clawctl list --mine)\nclawctl claim <id> then clawctl start <id> — take ownership and begin\nclawctl msg <agent> \"update\" --task <id> — coordinate during work\nclawctl done <id> -m \"what I did\" then clawctl next — complete and move on\n\nOnly claim tasks assigned to you or matching your role. Completing an already-done task is a safe no-op."
      },
      {
        "title": "Decision Tree",
        "body": "SituationCommandNew taskclawctl add \"Subject\" -d \"Details\"Find workclawctl next then clawctl claim <id>Blockedclawctl block <id> --by <blocker-id> and notify via clawctl msgFinishedclawctl done <id> -m \"Result\"Hand offclawctl msg <agent> \"Ready for you\" --task <id> --type handoffReady for reviewclawctl review <id>Catch upclawctl feed --last 20 or clawctl summaryLink artifactsAdd --meta '{\"note\":\"path/to/file\"}' to done, claim, start, or block"
      },
      {
        "title": "Task Statuses",
        "body": "pending → claimed → in_progress → done\n                  ↘ blocked ↗    ↘ cancelled\n                  ↘ review  ↗\n\nlist excludes done/cancelled by default. Use --all for history (newest first)."
      },
      {
        "title": "Tasks",
        "body": "CommandDescriptionadd SUBJECTCreate task. -d desc, -p 0|1|2 priority, --for AGENT assign, --parent IDlistActive tasks. --mine, --status STATUS, --owner AGENT, --allnextHighest-priority actionable task for current agentclaim IDClaim task. --force overrides ownership, --meta JSONstart IDBegin work (in_progress). --meta JSONdone IDComplete. -m note, --force, --meta JSONreview IDMark ready for review. --meta JSONcancel IDCancel task. --meta JSONblock ID --by OTHERMark blocked. --meta JSONboardKanban board grouped by status"
      },
      {
        "title": "Messages",
        "body": "CommandDescriptionmsg AGENT BODYSend message. --task ID, --type TYPE (comment, status, handoff, question, answer, alert)broadcast BODYAlert all agentsinboxRead messages. --unread for unread only"
      },
      {
        "title": "Fleet",
        "body": "CommandDescriptioncheckinHeartbeat — update presence, report unread countregister NAMERegister agent. --role TEXTfleetAll agents with status and current taskwhoamiIdentity, role, and DB path"
      },
      {
        "title": "Monitoring",
        "body": "CommandDescriptionfeedActivity log. --last N, --agent NAME, --metasummaryFleet overview with counts and recent eventsdashboardWeb UI. --port INT, --stop, --verbose"
      }
    ],
    "body": "Setup\nclawctl init                        # create the database\nexport CLAW_AGENT=your-name         # set identity (falls back to $USER with warning)\nexport CLAW_DB=~/.openclaw/clawctl.db  # optional, this is the default\n\nOperational Rhythm\n\nFollow this pattern every session:\n\nclawctl checkin — register presence, see unread count\nclawctl inbox --unread — read messages before picking up work\nclawctl next — find highest-priority actionable task (or clawctl list --mine)\nclawctl claim <id> then clawctl start <id> — take ownership and begin\nclawctl msg <agent> \"update\" --task <id> — coordinate during work\nclawctl done <id> -m \"what I did\" then clawctl next — complete and move on\n\nOnly claim tasks assigned to you or matching your role. Completing an already-done task is a safe no-op.\n\nDecision Tree\nSituation\tCommand\nNew task\tclawctl add \"Subject\" -d \"Details\"\nFind work\tclawctl next then clawctl claim <id>\nBlocked\tclawctl block <id> --by <blocker-id> and notify via clawctl msg\nFinished\tclawctl done <id> -m \"Result\"\nHand off\tclawctl msg <agent> \"Ready for you\" --task <id> --type handoff\nReady for review\tclawctl review <id>\nCatch up\tclawctl feed --last 20 or clawctl summary\nLink artifacts\tAdd --meta '{\"note\":\"path/to/file\"}' to done, claim, start, or block\nTask Statuses\npending → claimed → in_progress → done\n                  ↘ blocked ↗    ↘ cancelled\n                  ↘ review  ↗\n\n\nlist excludes done/cancelled by default. Use --all for history (newest first).\n\nCommands\nTasks\nCommand\tDescription\nadd SUBJECT\tCreate task. -d desc, -p 0|1|2 priority, --for AGENT assign, --parent ID\nlist\tActive tasks. --mine, --status STATUS, --owner AGENT, --all\nnext\tHighest-priority actionable task for current agent\nclaim ID\tClaim task. --force overrides ownership, --meta JSON\nstart ID\tBegin work (in_progress). --meta JSON\ndone ID\tComplete. -m note, --force, --meta JSON\nreview ID\tMark ready for review. --meta JSON\ncancel ID\tCancel task. --meta JSON\nblock ID --by OTHER\tMark blocked. --meta JSON\nboard\tKanban board grouped by status\nMessages\nCommand\tDescription\nmsg AGENT BODY\tSend message. --task ID, --type TYPE (comment, status, handoff, question, answer, alert)\nbroadcast BODY\tAlert all agents\ninbox\tRead messages. --unread for unread only\nFleet\nCommand\tDescription\ncheckin\tHeartbeat — update presence, report unread count\nregister NAME\tRegister agent. --role TEXT\nfleet\tAll agents with status and current task\nwhoami\tIdentity, role, and DB path\nMonitoring\nCommand\tDescription\nfeed\tActivity log. --last N, --agent NAME, --meta\nsummary\tFleet overview with counts and recent events\ndashboard\tWeb UI. --port INT, --stop, --verbose"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/lludlow/clawctl",
    "publisherUrl": "https://clawhub.ai/lludlow/clawctl",
    "owner": "lludlow",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawctl",
    "downloadUrl": "https://openagent3.xyz/downloads/clawctl",
    "agentUrl": "https://openagent3.xyz/skills/clawctl/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawctl/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawctl/agent.md"
  }
}