{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawpost-2",
    "name": "Clawpost",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Acidias/clawpost-2",
    "canonicalUrl": "https://clawhub.ai/Acidias/clawpost-2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawpost-2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawpost-2",
    "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",
      "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/clawpost-2"
    },
    "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/clawpost-2",
    "agentPageUrl": "https://openagent3.xyz/skills/clawpost-2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawpost-2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawpost-2/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": "Social Media Publisher Skill",
        "body": "ClawPost helps you create, manage, and publish content to LinkedIn and X (Twitter) — with AI-assisted writing, drafts, scheduling, and direct publishing via API."
      },
      {
        "title": "Getting Started",
        "body": "If the user doesn't have an account or API key yet, walk them through these steps:\n\nSign up at clawpost.dev — sign in with LinkedIn.\nConnect platforms — In the Dashboard, connect LinkedIn and/or X (Twitter) accounts.\nAdd credits — Go to Dashboard → Billing and top up credits (minimum $5). Credits are used for AI generation features.\nGenerate an API key — Go to Dashboard → Settings → API Keys → Generate New Key. The key starts with claw_.\nSet the environment variable:\nexport CLAW_API_KEY=\"claw_your_key_here\""
      },
      {
        "title": "Setup",
        "body": "Required environment variable:\n\nCLAW_API_KEY — your API key (starts with claw_). Generate one following the steps above.\n\nOptional:\n\nCLAW_API_URL — defaults to https://clawpost.dev. Only set this if using a self-hosted instance.\n\nAll endpoints are under {{CLAW_API_URL}}/api/claw/v1/ (default: https://clawpost.dev/api/claw/v1/)."
      },
      {
        "title": "Authentication",
        "body": "Every request needs the header:\n\nAuthorization: Bearer {{CLAW_API_KEY}}"
      },
      {
        "title": "Important: Passing JSON in shell commands",
        "body": "When sending JSON data with curl, always use a heredoc to avoid shell escaping issues with quotes and special characters:\n\ncurl -s -X POST URL \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"key\": \"value\"}\nEOF\n\nAll examples below use this pattern. Do not use -d '{...}' with single quotes — it breaks when content contains quotes, newlines, or special characters."
      },
      {
        "title": "Response Format",
        "body": "All responses follow this shape:\n\n{\n  \"success\": true,\n  \"message\": \"Human-readable summary\",\n  \"data\": { ... },\n  \"error\": { \"code\": \"ERROR_CODE\", \"details\": \"...\" }\n}\n\nAlways read the message field — it's designed to be relayed directly to the user."
      },
      {
        "title": "Check Status",
        "body": "Verify your API key works and see what's connected.\n\ncurl -s {{CLAW_API_URL}}/api/claw/v1/status \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "List Connected Platforms",
        "body": "curl -s {{CLAW_API_URL}}/api/claw/v1/platforms \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "Check Credits",
        "body": "curl -s {{CLAW_API_URL}}/api/claw/v1/credits \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "List Posts",
        "body": "Filter by status (draft, published, scheduled, failed) and platform (linkedin, twitter).\n\ncurl -s \"{{CLAW_API_URL}}/api/claw/v1/posts?status=draft&platform=linkedin&limit=10\" \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "X Post History",
        "body": "Retrieve your X (Twitter) post history from the cached profile data. This is a read-only endpoint - no credits are used.\n\nQuery parameters:\n\ntype - posts, replies, or all (default: all)\nlimit - max results, 1-100 (default: 20)\nperiod - 7d, 30d, 90d, or all (default: all)\n\ncurl -s \"{{CLAW_API_URL}}/api/claw/v1/history/x?type=posts&period=30d&limit=10\" \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nThe response includes a summary object with aggregated metrics (totalPosts, totalReplies, totalLikes, totalRetweets, totalRepliesReceived, totalImpressions, topPost) and a posts array with individual tweet details, metrics, media, and reply context."
      },
      {
        "title": "Get Single Post",
        "body": "curl -s {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nEach post includes an availableActions array (e.g., [\"publish\", \"schedule\", \"update\", \"delete\"]).\n\nPost Object Fields\n\nEvery post includes a postType field:\n\n\"original\" — a regular post composed by the user\n\"quote\" — a quote tweet of another post (X only)\n\"reply\" — a reply to another post (X only)\n\"remix\" — an original tweet inspired by another post (X only)\n\nWhen postType is \"quote\", \"reply\", or \"remix\", the post also includes a reference object with the original tweet's context:\n\n{\n  \"postType\": \"quote\",\n  \"content\": \"User's commentary text\",\n  \"reference\": {\n    \"tweetId\": \"1234567890\",\n    \"text\": \"The original tweet text that was quoted\",\n    \"author\": \"originalAuthor\"\n  }\n}\n\nThis lets you see exactly what was quoted/replied to alongside the user's own text."
      },
      {
        "title": "Create a Draft",
        "body": "curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/drafts \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Your post text here\", \"platform\": \"linkedin\"}\nEOF\n\nPlatform: \"linkedin\" or \"twitter\". Twitter content must be ≤ 280 characters."
      },
      {
        "title": "Update a Draft",
        "body": "curl -s -X PUT {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Updated post text\"}\nEOF"
      },
      {
        "title": "Delete a Draft",
        "body": "curl -s -X DELETE {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "Publish a Draft",
        "body": "curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/publish \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\""
      },
      {
        "title": "Direct Publish (No Draft Step)",
        "body": "curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/publish \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Publishing this directly!\", \"platform\": \"linkedin\"}\nEOF"
      },
      {
        "title": "Schedule a Draft",
        "body": "curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/schedule \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"scheduledAt\": \"2026-06-15T10:00:00Z\"}\nEOF"
      },
      {
        "title": "Direct Schedule (No Draft Step)",
        "body": "curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/schedule \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Scheduled post!\", \"platform\": \"linkedin\", \"scheduledAt\": \"2026-06-15T10:00:00Z\"}\nEOF"
      },
      {
        "title": "AI Generate Post",
        "body": "Let AI write a post based on your prompt. Optional: tone and platform.\n\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/generate \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"prompt\": \"Write about the importance of code reviews\", \"platform\": \"linkedin\"}\nEOF"
      },
      {
        "title": "AI Refine Post",
        "body": "Improve existing content with instructions.\n\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/refine \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Original post text...\", \"instructions\": \"Make it shorter and punchier\", \"platform\": \"linkedin\"}\nEOF"
      },
      {
        "title": "Workflow Tips",
        "body": "Quick publish: Use /publish to post immediately without creating a draft.\nReview flow: Create a draft with /drafts, refine with /ai/refine, then publish with /posts/ID/publish.\nCross-post: Make separate calls for LinkedIn and Twitter — each is a separate post.\nCheck before publishing: Call /platforms to verify the target platform is connected.\nTwitter limit: Tweets must be ≤ 280 characters. The API will reject longer content with a clear message."
      },
      {
        "title": "Error Codes",
        "body": "CodeMeaningUNAUTHORIZEDInvalid or revoked API keyNOT_FOUNDPost or resource doesn't existVALIDATION_ERRORBad input (missing content, too long, invalid date)CONFLICTCan't perform action (e.g., already published)PLATFORM_NOT_CONNECTEDTarget social platform isn't linkedINSUFFICIENT_CREDITSNot enough credits for AI operationsNO_AI_KEYNo AI API key configuredRATE_LIMITEDToo many requests (60/min general, 10/min publish)INTERNAL_ERRORSomething went wrong server-side"
      }
    ],
    "body": "Social Media Publisher Skill\n\nClawPost helps you create, manage, and publish content to LinkedIn and X (Twitter) — with AI-assisted writing, drafts, scheduling, and direct publishing via API.\n\nGetting Started\n\nIf the user doesn't have an account or API key yet, walk them through these steps:\n\nSign up at clawpost.dev — sign in with LinkedIn.\nConnect platforms — In the Dashboard, connect LinkedIn and/or X (Twitter) accounts.\nAdd credits — Go to Dashboard → Billing and top up credits (minimum $5). Credits are used for AI generation features.\nGenerate an API key — Go to Dashboard → Settings → API Keys → Generate New Key. The key starts with claw_.\nSet the environment variable:\nexport CLAW_API_KEY=\"claw_your_key_here\"\n\nSetup\n\nRequired environment variable:\n\nCLAW_API_KEY — your API key (starts with claw_). Generate one following the steps above.\n\nOptional:\n\nCLAW_API_URL — defaults to https://clawpost.dev. Only set this if using a self-hosted instance.\n\nAll endpoints are under {{CLAW_API_URL}}/api/claw/v1/ (default: https://clawpost.dev/api/claw/v1/).\n\nAuthentication\n\nEvery request needs the header:\n\nAuthorization: Bearer {{CLAW_API_KEY}}\n\nImportant: Passing JSON in shell commands\n\nWhen sending JSON data with curl, always use a heredoc to avoid shell escaping issues with quotes and special characters:\n\ncurl -s -X POST URL \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"key\": \"value\"}\nEOF\n\n\nAll examples below use this pattern. Do not use -d '{...}' with single quotes — it breaks when content contains quotes, newlines, or special characters.\n\nResponse Format\n\nAll responses follow this shape:\n\n{\n  \"success\": true,\n  \"message\": \"Human-readable summary\",\n  \"data\": { ... },\n  \"error\": { \"code\": \"ERROR_CODE\", \"details\": \"...\" }\n}\n\n\nAlways read the message field — it's designed to be relayed directly to the user.\n\nEndpoints\nCheck Status\n\nVerify your API key works and see what's connected.\n\ncurl -s {{CLAW_API_URL}}/api/claw/v1/status \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nList Connected Platforms\ncurl -s {{CLAW_API_URL}}/api/claw/v1/platforms \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nCheck Credits\ncurl -s {{CLAW_API_URL}}/api/claw/v1/credits \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nList Posts\n\nFilter by status (draft, published, scheduled, failed) and platform (linkedin, twitter).\n\ncurl -s \"{{CLAW_API_URL}}/api/claw/v1/posts?status=draft&platform=linkedin&limit=10\" \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nX Post History\n\nRetrieve your X (Twitter) post history from the cached profile data. This is a read-only endpoint - no credits are used.\n\nQuery parameters:\n\ntype - posts, replies, or all (default: all)\nlimit - max results, 1-100 (default: 20)\nperiod - 7d, 30d, 90d, or all (default: all)\ncurl -s \"{{CLAW_API_URL}}/api/claw/v1/history/x?type=posts&period=30d&limit=10\" \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\n\nThe response includes a summary object with aggregated metrics (totalPosts, totalReplies, totalLikes, totalRetweets, totalRepliesReceived, totalImpressions, topPost) and a posts array with individual tweet details, metrics, media, and reply context.\n\nGet Single Post\ncurl -s {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\n\nEach post includes an availableActions array (e.g., [\"publish\", \"schedule\", \"update\", \"delete\"]).\n\nPost Object Fields\n\nEvery post includes a postType field:\n\n\"original\" — a regular post composed by the user\n\"quote\" — a quote tweet of another post (X only)\n\"reply\" — a reply to another post (X only)\n\"remix\" — an original tweet inspired by another post (X only)\n\nWhen postType is \"quote\", \"reply\", or \"remix\", the post also includes a reference object with the original tweet's context:\n\n{\n  \"postType\": \"quote\",\n  \"content\": \"User's commentary text\",\n  \"reference\": {\n    \"tweetId\": \"1234567890\",\n    \"text\": \"The original tweet text that was quoted\",\n    \"author\": \"originalAuthor\"\n  }\n}\n\n\nThis lets you see exactly what was quoted/replied to alongside the user's own text.\n\nCreate a Draft\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/drafts \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Your post text here\", \"platform\": \"linkedin\"}\nEOF\n\n\nPlatform: \"linkedin\" or \"twitter\". Twitter content must be ≤ 280 characters.\n\nUpdate a Draft\ncurl -s -X PUT {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Updated post text\"}\nEOF\n\nDelete a Draft\ncurl -s -X DELETE {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nPublish a Draft\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/publish \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\"\n\nDirect Publish (No Draft Step)\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/publish \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Publishing this directly!\", \"platform\": \"linkedin\"}\nEOF\n\nSchedule a Draft\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/schedule \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"scheduledAt\": \"2026-06-15T10:00:00Z\"}\nEOF\n\nDirect Schedule (No Draft Step)\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/schedule \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Scheduled post!\", \"platform\": \"linkedin\", \"scheduledAt\": \"2026-06-15T10:00:00Z\"}\nEOF\n\nAI Generate Post\n\nLet AI write a post based on your prompt. Optional: tone and platform.\n\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/generate \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"prompt\": \"Write about the importance of code reviews\", \"platform\": \"linkedin\"}\nEOF\n\nAI Refine Post\n\nImprove existing content with instructions.\n\ncurl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/refine \\\n  -H \"Authorization: Bearer {{CLAW_API_KEY}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @- <<'EOF'\n{\"content\": \"Original post text...\", \"instructions\": \"Make it shorter and punchier\", \"platform\": \"linkedin\"}\nEOF\n\nWorkflow Tips\nQuick publish: Use /publish to post immediately without creating a draft.\nReview flow: Create a draft with /drafts, refine with /ai/refine, then publish with /posts/ID/publish.\nCross-post: Make separate calls for LinkedIn and Twitter — each is a separate post.\nCheck before publishing: Call /platforms to verify the target platform is connected.\nTwitter limit: Tweets must be ≤ 280 characters. The API will reject longer content with a clear message.\nError Codes\nCode\tMeaning\nUNAUTHORIZED\tInvalid or revoked API key\nNOT_FOUND\tPost or resource doesn't exist\nVALIDATION_ERROR\tBad input (missing content, too long, invalid date)\nCONFLICT\tCan't perform action (e.g., already published)\nPLATFORM_NOT_CONNECTED\tTarget social platform isn't linked\nINSUFFICIENT_CREDITS\tNot enough credits for AI operations\nNO_AI_KEY\tNo AI API key configured\nRATE_LIMITED\tToo many requests (60/min general, 10/min publish)\nINTERNAL_ERROR\tSomething went wrong server-side"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Acidias/clawpost-2",
    "publisherUrl": "https://clawhub.ai/Acidias/clawpost-2",
    "owner": "Acidias",
    "version": "0.1.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawpost-2",
    "downloadUrl": "https://openagent3.xyz/downloads/clawpost-2",
    "agentUrl": "https://openagent3.xyz/skills/clawpost-2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawpost-2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawpost-2/agent.md"
  }
}