社交媒体发布技能

ClawPost 帮助您创建、管理并发布内容至 LinkedIn 和 X（Twitter）——支持 AI 辅助写作、草稿管理、定时发布，以及通过 API 直接发布。

快速开始

若用户尚未注册账号或未获取 API 密钥，请引导其完成以下步骤：

1. 注册账号：访问 clawpost.dev，使用 LinkedIn 账号登录。
2. 绑定平台：在控制台（Dashboard）中，绑定 LinkedIn 和/或 X（Twitter）账号。
3. 充值积分：进入控制台 → Billing 页面，为账户充值（最低 $5）。AI 生成类功能将消耗积分。
4. 生成 API 密钥：进入控制台 → Settings → API Keys → Generate New Key。密钥以 claw_ 开头。
5. 设置环境变量：

   export CLAW_API_KEY="claw_your_key_here"
   

配置

必需的环境变量：

• CLAW_API_KEY — 您的 API 密钥（以 claw_ 开头），请按上述步骤生成。

可选环境变量：

• CLAW_API_URL — 默认为 https://clawpost.dev。仅当使用自托管实例时才需设置该值。

所有接口均位于 {{CLAW_API_URL}}/api/claw/v1/ 下（默认地址为 https://clawpost.dev/api/claw/v1/）。

认证方式

每次请求均需携带如下请求头：

Authorization: Bearer {{CLAW_API_KEY}}

重要提示：在 Shell 命令中传递 JSON 数据

使用 curl 发送 JSON 数据时，务必使用 heredoc 语法，以避免因引号和特殊字符导致的 Shell 转义问题：

curl -s -X POST URL 
  -H "Authorization: Bearer {{CLAW_API_KEY}}" 
  -H "Content-Type: application/json" 
  -d @- <<'EOF'
{"key": "value"}
EOF

下方所有示例均采用此模式。请切勿使用 -d '{...}'（单引号包裹）的方式 —— 当内容中包含引号、换行符或特殊字符时，该方式将失效。

响应格式

所有响应均遵循如下结构：

{
  "success": true,
  "message": "人类可读的摘要信息",
  "data": { ... },
  "error": { "code": "ERROR_CODE", "details": "..." }
}

请始终读取 message 字段 —— 该字段专为直接向终端用户展示而设计。

接口列表

检查服务状态

验证您的 API 密钥是否有效，并查看已连接的平台。

curl -s {{CLAW_API_URL}}/api/claw/v1/status 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

列出已连接平台

curl -s {{CLAW_API_URL}}/api/claw/v1/platforms 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

查询积分余额

curl -s {{CLAW_API_URL}}/api/claw/v1/credits 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

列出帖子

支持按状态（draft、published、scheduled、failed）和平台（linkedin、twitter）筛选。

curl -s "{{CLAW_API_URL}}/api/claw/v1/posts?status=draft&platform=linkedin&limit=10" 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

X 帖子历史记录

从缓存的个人资料数据中检索您的 X（Twitter）帖子历史。此为只读接口，不消耗积分。

支持的查询参数：

• type — 可选值：posts、replies 或 all（默认为 all）
• limit — 最大返回条数，范围为 1–100（默认为 20）
• period — 时间范围：7d、30d、90d 或 all（默认为 all）

curl -s "{{CLAW_API_URL}}/api/claw/v1/history/x?type=posts&period=30d&limit=10" 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

响应中包含一个 summary 对象（含聚合指标：totalPosts、totalReplies、totalLikes、totalRetweets、totalRepliesReceived、totalImpressions、topPost），以及一个 posts 数组（含每条推文的详细信息、互动数据、媒体资源及回复上下文）。

获取单个帖子详情

curl -s {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

每条帖子均包含一个 availableActions 数组（例如：["publish", "schedule", "update", "delete"]）。

帖子对象字段说明

每条帖子均包含 postType 字段：

• "original" — 用户原创的普通帖子
• "quote" — 引用另一条帖子的 Quote Tweet（仅限 X）
• "reply" — 回复另一条帖子（仅限 X）
• "remix" — 受另一条帖子启发而创作的原创推文（仅限 X）

当 postType 为 "quote"、"reply" 或 "remix" 时，帖子还会包含一个 reference 对象，用于提供原始推文的上下文信息：

{
  "postType": "quote",
  "content": "用户的评论文本",
  "reference": {
    "tweetId": "1234567890",
    "text": "被引用的原始推文内容",
    "author": "originalAuthor"
  }
}

该机制可让您清晰识别用户内容所引用或回复的具体原始推文。

创建草稿

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": "您的帖子正文", "platform": "linkedin"}
EOF

平台参数："linkedin" 或 "twitter"。X 内容长度不得超过 280 字符。

更新草稿

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": "更新后的帖子正文"}
EOF

删除草稿

curl -s -X DELETE {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

发布草稿

curl -s -X POST {{CLAW_API_URL}}/api/claw/v1/posts/POST_ID/publish 
  -H "Authorization: Bearer {{CLAW_API_KEY}}"

直接发布（跳过草稿步骤）

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": "立即发布此内容！", "platform": "linkedin"}
EOF

定时发布草稿

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

直接定时发布（跳过草稿步骤）

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": "定时发布的帖子！", "platform": "linkedin", "scheduledAt": "2026-06-15T10:00:00Z"}
EOF

AI 生成帖子

根据您的提示词由 AI 自动生成帖子。可选参数：tone 和 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": "撰写一篇关于代码审查重要性的文章", "platform": "linkedin"}
EOF

AI 优化帖子

基于指定指令对已有内容进行润色提升。

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": "原始帖子正文...", "instructions": "使其更简短有力", "platform": "linkedin"}
EOF

工作流建议

1. 快速发布：使用 /publish 接口，无需创建草稿即可立即发布。
2. 审阅流程：先调用 /drafts 创建草稿，再用 /ai/refine 进行优化，最后通过 /posts/ID/publish 发布。
3. 跨平台发布：LinkedIn 和 X 需分别调用对应接口 —— 每个平台视为独立帖子。
4. 发布前检查：调用 /platforms 确认目标平台已成功绑定。
5. X 字数限制：推文内容不得超过 280 字符。API 将明确拒绝超长内容并返回清晰错误信息。

错误码说明