# Send Clawpost to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "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": { "downloadUrl": "/downloads/clawpost-2", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawpost-2", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "clawpost-2", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T15:35:47.491Z", "expiresAt": "2026-05-07T15:35:47.491Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawpost-2", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawpost-2", "contentDisposition": "attachment; filename=\"clawpost-2-0.1.3.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "clawpost-2" }, "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/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." ] } }, "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" } } ``` ## Documentation ### Social Media Publisher Skill ClawPost helps you create, manage, and publish content to LinkedIn and X (Twitter) — with AI-assisted writing, drafts, scheduling, and direct publishing via API. ### Getting Started If the user doesn't have an account or API key yet, walk them through these steps: Sign up at clawpost.dev — sign in with LinkedIn. Connect platforms — In the Dashboard, connect LinkedIn and/or X (Twitter) accounts. Add credits — Go to Dashboard → Billing and top up credits (minimum $5). Credits are used for AI generation features. Generate an API key — Go to Dashboard → Settings → API Keys → Generate New Key. The key starts with claw_. Set the environment variable: export CLAW_API_KEY="claw_your_key_here" ### Setup Required environment variable: CLAW_API_KEY — your API key (starts with claw_). Generate one following the steps above. Optional: CLAW_API_URL — defaults to https://clawpost.dev. Only set this if using a self-hosted instance. All endpoints are under {{CLAW_API_URL}}/api/claw/v1/ (default: https://clawpost.dev/api/claw/v1/). ### Authentication Every request needs the header: Authorization: Bearer {{CLAW_API_KEY}} ### Important: Passing JSON in shell commands When sending JSON data with curl, always use a heredoc to avoid shell escaping issues with quotes and special characters: curl -s -X POST URL \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"key": "value"} EOF All examples below use this pattern. Do not use -d '{...}' with single quotes — it breaks when content contains quotes, newlines, or special characters. ### Response Format All responses follow this shape: { "success": true, "message": "Human-readable summary", "data": { ... }, "error": { "code": "ERROR_CODE", "details": "..." } } Always read the message field — it's designed to be relayed directly to the user. ### Check Status Verify your API key works and see what's connected. curl -s {{CLAW_API_URL}}/api/claw/v1/status \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### List Connected Platforms curl -s {{CLAW_API_URL}}/api/claw/v1/platforms \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### Check Credits curl -s {{CLAW_API_URL}}/api/claw/v1/credits \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### List Posts Filter by status (draft, published, scheduled, failed) and platform (linkedin, twitter). curl -s "{{CLAW_API_URL}}/api/claw/v1/posts?status=draft&platform=linkedin&limit=10" \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### X Post History Retrieve your X (Twitter) post history from the cached profile data. This is a read-only endpoint - no credits are used. Query parameters: type - posts, replies, or all (default: all) limit - max results, 1-100 (default: 20) period - 7d, 30d, 90d, or all (default: all) curl -s "{{CLAW_API_URL}}/api/claw/v1/history/x?type=posts&period=30d&limit=10" \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" The 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. ### Get Single Post curl -s {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" Each post includes an availableActions array (e.g., ["publish", "schedule", "update", "delete"]). Post Object Fields Every post includes a postType field: "original" — a regular post composed by the user "quote" — a quote tweet of another post (X only) "reply" — a reply to another post (X only) "remix" — an original tweet inspired by another post (X only) When postType is "quote", "reply", or "remix", the post also includes a reference object with the original tweet's context: { "postType": "quote", "content": "User's commentary text", "reference": { "tweetId": "1234567890", "text": "The original tweet text that was quoted", "author": "originalAuthor" } } This lets you see exactly what was quoted/replied to alongside the user's own text. ### Create a Draft curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/drafts \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"content": "Your post text here", "platform": "linkedin"} EOF Platform: "linkedin" or "twitter". Twitter content must be ≤ 280 characters. ### Update a Draft curl -s -X PUT {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"content": "Updated post text"} EOF ### Delete a Draft curl -s -X DELETE {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### Publish a Draft curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/publish \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" ### Direct Publish (No Draft Step) curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/publish \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"content": "Publishing this directly!", "platform": "linkedin"} EOF ### Schedule a Draft curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/schedule \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"scheduledAt": "2026-06-15T10:00:00Z"} EOF ### Direct Schedule (No Draft Step) curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/schedule \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"content": "Scheduled post!", "platform": "linkedin", "scheduledAt": "2026-06-15T10:00:00Z"} EOF ### AI Generate Post Let AI write a post based on your prompt. Optional: tone and platform. curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/generate \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"prompt": "Write about the importance of code reviews", "platform": "linkedin"} EOF ### AI Refine Post Improve existing content with instructions. curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/ai/refine \\ -H "Authorization: Bearer {{CLAW_API_KEY}}" \\ -H "Content-Type: application/json" \\ -d @- <<'EOF' {"content": "Original post text...", "instructions": "Make it shorter and punchier", "platform": "linkedin"} EOF ### Workflow Tips Quick publish: Use /publish to post immediately without creating a draft. Review flow: Create a draft with /drafts, refine with /ai/refine, then publish with /posts/ID/publish. Cross-post: Make separate calls for LinkedIn and Twitter — each is a separate post. Check before publishing: Call /platforms to verify the target platform is connected. Twitter limit: Tweets must be ≤ 280 characters. The API will reject longer content with a clear message. ### Error Codes 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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: Acidias - Version: 0.1.3 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T15:35:47.491Z - Expires at: 2026-05-07T15:35:47.491Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/clawpost-2) - [Send to Agent page](https://openagent3.xyz/skills/clawpost-2/agent) - [JSON manifest](https://openagent3.xyz/skills/clawpost-2/agent.json) - [Markdown brief](https://openagent3.xyz/skills/clawpost-2/agent.md) - [Download page](https://openagent3.xyz/downloads/clawpost-2)