socialclaw

SocialClaw 是一款面向 AI Agent 的社交媒体排期技能，可将内容发布到 X、LinkedIn、Instagram、Facebook Pages、TikTok、Discord、Telegram、YouTube、Reddit、WordPress 和 Pinterest

SocialClaw 是一项以工作区为范围的社交内容发布服务，地址为 https://getsocialclaw.com。

这项技能是什么

这项技能是托管式 SocialClaw 服务的指令层。

它不包含 SocialClaw 后端或服务提供商集成。 它会指导兼容 OpenClaw 的 Agent 如何：

• 获取或使用工作区 API 密钥
• 调用 SocialClaw HTTP API
• 了解服务提供商和账号类型相关的注意事项
• 在已安装独立的 socialclaw CLI 时选择使用它

这项技能无需 CLI 也能运行。CLI 只是同一托管服务的可选客户端。

用户想要以下操作时，请使用这项技能：

• 在 SocialClaw 工作区中连接或断开社交账号
• 上传媒体并获取 SocialClaw 托管的分发 URL
• 验证、预览、应用或检查已排期的帖子和营销活动
• 检查已连接账号的功能、发布设置、操作、任务、运行状况或分析数据

请勿将这项技能用于编辑 SocialClaw 代码库本身。此软件包用于操作已部署的 SocialClaw 工作区。

默认设置

• 基础 URL：https://getsocialclaw.com
• 身份验证：在 Authorization: Bearer <key> 中使用工作区 API 密钥
• 首选接口：已安装时使用 socialclaw CLI
• 回退接口：SocialClaw HTTP API

运行时要求

• 必需的环境变量：SC_API_KEY
• 托管基础 URL：https://getsocialclaw.com
• 可选 CLI：已安装时使用 socialclaw（或 social）
• 工作区状态：要通过工作区密钥运行 CLI/API，必须拥有有效的试用计划或付费计划

可选 CLI

SocialClaw 还提供了一个独立的 npm CLI 软件包，名为 socialclaw。

如果已安装 CLI，或用户需要命令行示例，请优先使用它。CLI 是托管式 SocialClaw 服务的客户端。它可以：

• 在本地存储工作区 API 密钥
• 启动连接流程
• 上传素材
• 验证、预览和应用排期
• 检查帖子、运行记录、分析数据、用量和工作区运行状况
• 使用 socialclaw install --claude 安装打包的 Claude Code 命令

CLI 是可选的。这项技能无需 CLI 也能运行。

如果用户明确要求使用 CLI，但尚未安装：

npm install -g socialclaw

快速开始

如果用户还没有工作区 API 密钥：

open https://getsocialclaw.com/dashboard

然后告知他们：

• 使用 Google 登录
• 打开 API 密钥部分
• 创建或复制工作区 API 密钥

设置：

export SC_API_KEY="<workspace-key>"

如果已安装 CLI，请使用它登录：

socialclaw login --api-key <workspace-key>

否则，通过 HTTP 验证密钥：

curl -sS \
  -H "Authorization: Bearer $SC_API_KEY" \
  "https://getsocialclaw.com/v1/keys/validate"

如果运行失败，并出现 plan_required、subscription_inactive、subscription_past_due、subscription_paused 或 subscription_canceled，请引导用户访问：

• https://getsocialclaw.com/pricing
• https://getsocialclaw.com/dashboard

操作规则

1. 首先确认用户是否拥有 SocialClaw 工作区 API 密钥。
2. 如果用户还没有密钥，请引导他们前往 https://getsocialclaw.com/dashboard，使用 Google 登录并创建密钥。
3. 仅有工作区 API 密钥不足以执行操作。如果出现与账单相关的错误，请引导用户前往定价页面或仪表板中的账单页面，而不是重试命令。
4. 切勿向用户索要服务提供商应用密钥。最终用户应在 SocialClaw 内连接账号。
5. 优先明确说明服务提供商和账号类型：
   • Facebook 公共主页，而不是 Facebook 个人资料
   • 关联 Facebook 公共主页的 Instagram 商业账号
   • 独立的 Instagram 专业账号
   • LinkedIn 个人资料和 LinkedIn 公共主页是不同的服务提供商
   • Pinterest 以画板为核心；在假定存在分区、目录或高级界面前，先检查功能和操作
6. 如果不支持某项服务提供商工作流，请直接说明，不要编造变通方案。
7. 除非账号功能或操作明确标示支持，否则将 Pinterest 产品、合集和灵感界面视为受功能限制或处于 beta 阶段。
8. 避免在聊天中复述完整的 API 密钥。

主要工作流

1. 确认用户拥有工作区 API 密钥。
2. 如有需要，引导用户前往仪表板，使用 Google 登录并创建密钥。
3. 验证工作区访问权限。
4. 列出账号或启动连接流程。
5. 检查目标账号的功能和设置。
6. 如有需要，上传媒体。
7. 验证或预览帖子／营销活动。
8. 应用该内容。
9. 根据需要检查帖子、运行记录、分析数据，或重试／协调状态。

服务提供商专属发布说明

TikTok 照片帖子

TikTok 照片／图库帖子比视频帖子有更严格的要求。在安排或应用 TikTok 照片帖子之前：

• 帖子仅使用图片素材；不要混用图片和视频。
• 每个图库的图片数量不得超过 TikTok 关联账号的功能上限，通常最多为 35 张。
• 上传前，将照片调整为符合 TikTok 要求的尺寸。竖版照片幻灯片优先使用 1080x1920 的 JPEG，或其他符合 TikTok 标准的宽高比和尺寸。超大或不常见的尺寸可能通过 SocialClaw 验证和 TikTok 的初步接收，但之后仍会因 picture_size_check_failed 而失败。
• 对于照片图库，如果用户希望 TikTok 选择推荐音乐，请设置 settings.autoAddMusic: true。TikTok 的 Content Posting API 不支持选择特定音频。
• 除非用户明确提出需要，否则不要设置可见的 name／标题。对于 TikTok 帖子，面向用户的文案应放在 description 中；否则，仪表板或预览中可能会显示多余的标题字段。
• 发布 TikTok 照片图库后，不要认为 providerStatus: accepted 就代表内容已公开显示。稍等片刻后再协调帖子状态：

socialclaw posts reconcile --post-id <post-id> --json

将 providerStatus: published 且 reconciliationStatus: confirmed 视为更可靠的成功信号。如果协调结果返回 picture_size_check_failed，请重新生成经过缩放／填充的图片，上传修正后的素材，然后重新安排发布。

必要示例

如果已安装 CLI，优先使用以下命令：

保存工作区密钥：

socialclaw login --api-key <workspace-key>

启动连接流程：

socialclaw accounts connect --provider youtube --open

启动 Pinterest OAuth 连接：

socialclaw accounts connect --provider pinterest --open

使用机器人令牌和聊天目标手动连接 Telegram：

socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json

使用频道 webhook URL 手动连接 Discord：

socialclaw accounts connect --provider discord --webhook-url <discord-webhook-url> --json

列出已连接的账号：

socialclaw accounts list --json

上传媒体：

socialclaw assets upload --file ./image.png --json

验证发布安排：

socialclaw validate -f schedule.json --json

应用发布安排：

socialclaw apply -f schedule.json --json

安装 Claude Code 命令：

socialclaw install --claude

检查帖子：

socialclaw posts get --post-id <post-id> --json

连接工作流

对于基于浏览器的账户关联：

• CLI：
  • socialclaw accounts connect --provider <provider> --open
  • 然后执行 socialclaw accounts status --connection-id <id> --json
• API：
  • POST /v1/connections/start
  • 将授权 URL 返回给用户；如果有可用的浏览器工具，也可以直接打开
  • 轮询 GET /v1/connections/:connectionId

支持的提供商：

• x
• facebook
• instagram_business
• instagram
• linkedin
• linkedin_page
• pinterest
• tiktok
• discord
• telegram
• youtube
• reddit
• wordpress

Telegram 和 Discord 是基于浏览器的 OAuth 流程的例外。

Telegram 需要手动连接，并提供：

• Telegram 机器人令牌
• 目标 chat_id 或 @channelusername

对于 Telegram：

• CLI：
  • socialclaw accounts connect --provider telegram --bot-token <token> --chat-id <@channel|chat_id> --json
• API：
  • 使用 {"provider":"telegram","botToken":"...","chatId":"..." } 调用 POST /v1/connections/start

Discord 需要手动连接，并提供：

• Discord 频道 Webhook URL

对于 Discord：

• CLI：
  • socialclaw accounts connect --provider discord --webhook-url <discord-webhook-url> --json
• API：
  • 使用 {"provider":"discord","webhookUrl":"..." } 调用 POST /v1/connections/start

接下来阅读

• 有关 HTTP 回退方案，请阅读 references/workflows.md。
• 有关可选的 CLI 和命令示例，请阅读 references/cli.md。
• 有关提供商／账户类型注意事项，请阅读 references/providers.md。