Socialclaw

SocialClaw

面向 AI Agent 的社交媒体排期命令行工具和 OpenClaw 技能，可发布内容到 X、LinkedIn、Instagram、Facebook Pages、TikTok、Discord、Telegram、YouTube、Reddit、WordPress 和 Pinterest。

官方网站：getsocialclaw.com · 控制面板 · npm · 技能包

getsocialclaw.com 是 SocialClaw 的官方网站——托管控制面板、API 和账户注册都在此提供。

此仓库是以下内容的公开主页：

• socialclaw npm 命令行工具
• OpenClaw 和 ClawHub 技能包
• Claude Code 插件和 /socialclaw 命令资源
• 公开使用文档、服务商说明和排期示例

安装

npm install -g socialclaw
socialclaw login
socialclaw accounts list --json

安装为 AI Agent 技能（Claude Code、Cursor、Cline、Codex 等）：

npx skills add ndesv21/socialclaw

命令行工具涵盖的功能

• 工作区 API 密钥登录和托管控制面板初始化
• 浏览器 OAuth 连接，以及手动连接 Discord 和 Telegram
• 托管资源上传和删除
• 排期验证、活动预览、应用、检查、克隆和草稿发布
• 帖子、运行、尝试、分析、作业、用量和运行状况检查
• 删除服务商端已发布的受支持帖子
• 通过 socialclaw install --claude 安装 Claude Code 命令

命令行工具概览

socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file ./image.png --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw posts delete --post-id <post-id> --json

____             _       _      ____ _
/ ___|  ___   ___(_) __ _| |    / ___| | __ ___      __
\___ \ / _ \ / __| |/ _` | |   | |   | |/ _` \ \ /\ / /
 ___) | (_) | (__| | (_| | |   | |___| | (_| |\ V  V /
|____/ \___/ \___|_|\__,_|_|    \____|_|\__,_| \_/\_/

socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file <path> --json
socialclaw campaigns preview -f <schedule.(yaml|yml|json)> --json
socialclaw validate -f <schedule.(yaml|yml|json)> --json
socialclaw apply -f <schedule.(yaml|yml|json)> --json
socialclaw posts get --post-id <id> --json
socialclaw posts delete --post-id <id> --json
socialclaw status --run-id <id> --json
socialclaw analytics post --post-id <id> --json

观看演示

_{点击图片即可打开演示视频。}

专为 Agent 驱动的发布而构建

身份验证和访问权限

不带 API 密钥运行 socialclaw login 会打开托管控制面板，用户可以：

• 使用 Google 登录
• 连接社交账户
• 创建或复制工作区 API 密钥
• 激活试用或付费方案，以访问命令行工具和 API

重要提示：

• 命令行工具通过 API 密钥身份验证，连接到已部署的 SocialClaw 工作区
• 仅有 API 密钥不足以执行 Agent；工作区还必须有有效的试用或付费方案
• 如果命令返回 plan_required 或 subscription_*，请前往 https://getsocialclaw.com/pricing 或 https://getsocialclaw.com/dashboard

快速开始

socialclaw login
socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts list --json
socialclaw accounts capabilities --provider pinterest --json
socialclaw accounts connect --provider pinterest --open
socialclaw accounts connect --provider discord --webhook-url <webhook-url> --json
socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
socialclaw assets upload --file ./image.png --json
socialclaw campaigns preview -f schedule.json --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json
socialclaw posts delete --post-id <post-id> --json
socialclaw workspace health --json
socialclaw usage --json

Agent 集成

MCP 服务

该软件包附带一个 Model Context Protocol 服务。任何 MCP 客户端（Claude Code、Claude Desktop、Cursor 等）都可以通过已连接的工作区账号使用 17 个以验证为先的发布工具：列出账号和功能、上传媒体、验证并预览计划、使用幂等键应用计划、发布草稿，以及检查帖子、尝试记录、运行记录、分析数据、用量和运行状况。

Claude Code：

claude mcp add socialclaw \
  --env SOCIALCLAW_API_KEY=sc_live_your_key \
  -- npx -y socialclaw mcp

Claude Desktop、Cursor 和其他通过 JSON 配置的客户端：

{
  "mcpServers": {
    "socialclaw": {
      "command": "npx",
      "args": ["-y", "socialclaw", "mcp"],
      "env": {
        "SOCIALCLAW_API_KEY": "sc_live_your_key"
      }
    }
  }
}

如果你已运行过 socialclaw login --api-key <key>，服务会复用已保存的凭据，无需 env 块。完整工具列表请参阅 getsocialclaw.com/mcp。

Claude Code 插件

在 Claude Code 中安装打包好的 Claude Code 插件：

/plugin marketplace add ndesv21/socialclaw
/plugin install socialclaw@socialclaw

这会安装来自 skills/socialclaw/ 的市场插件，其元数据来自 .claude-plugin/。如果你希望 Claude 在用户要求连接账号、上传媒体、安排帖子、检查投递情况或查看分析数据时自动调用 SocialClaw，这是最简便的选择。

Claude 斜杠命令和技能文件

如果你想使用明确的 /socialclaw 命令，而不是完整的插件流程：

socialclaw install --claude

这会将捆绑的命令文件 skill/claude/socialclaw.md 安装到 ~/.claude/commands/socialclaw.md。

如果你想要轻量级的 Claude Code 配置，可以采用此方式，它能够：

• 提供一个清晰的 SocialClaw 命令
• 明确保留工作区 API 密钥的使用流程
• 仍可让 Claude 使用相同的托管 SocialClaw API 和 CLI 工作流

OpenClaw 和 ClawHub

与 OpenClaw 兼容的技能包位于 skill/。

此技能包适用于 OpenClaw 和其他兼容的 Agent 运行时；这些运行时能够加载 SKILL.md、使用工作区 API 密钥，并通过以下任一方式调用：

• 直接调用 SocialClaw HTTP API
• 使用 socialclaw CLI 作为托管服务的客户端

这是要发布到 ClawHub 以便 OpenClaw 用户发现的技能包。

其他 Agent

SocialClaw 不局限于某一种 Agent 框架。该仓库还包含位于 skill/agents/openai.yaml 的 Agent 清单，并且 CLI 适用于任何能够执行 shell 命令或发送 HTTP 请求的运行时。

因此，SocialClaw 非常适合：

• Codex 和终端原生 Agent 工作流
• 通过插件或命令文件使用 Claude Code
• OpenClaw 和 ClawHub 技能
• 需要通过一个稳定发布入口发布到各社交渠道的自定义内部 Agent

实际上，这些方式都遵循相同的模式：

• 在 SocialClaw 中连接客户账号
• 创建工作区 API 密钥
• 通过托管服务上传媒体、验证、应用、检查、分析，并可选择删除受支持的帖子

支持的服务商

• X
• Facebook Pages
• Instagram Business
• Instagram 独立专业账户
• LinkedIn 个人主页
• LinkedIn 页面
• Pinterest
• TikTok
• Discord
• Telegram
• YouTube
• Reddit
• WordPress

Pinterest 在公共 CLI 和技能包中以 pinterest 服务商的形式提供。其主要发布目标以画板为中心，支持标准 Pin、视频 Pin、多图 Pin、创建画板以及发现分区或目录，还支持 Pin 和账户分析。产品、合集和灵感内容应视为受功能限制或处于 beta 阶段，而不应默认每个工作区都支持。

TikTok 每篇帖子支持一个视频或一个照片图库。照片图库最多可包含 35 张图片，并支持 autoAddMusic 和 photoCoverIndex；TikTok 的 Content Posting API 不支持选择特定的 TikTok 歌曲或声音。对于照片图库，请在上传前规范化图片，最好使用 1080x1920 的 JPEG 竖版幻灯片，或其他符合 TikTok 标准的宽高比和尺寸。尺寸过大或不常见的图片可能通过 SocialClaw 验证并获 TikTok 初步接受，但之后仍可能失败并返回 picture_size_check_failed；发布后请核对照片帖子，确认 TikTok 报告 PUBLISH_COMPLETE。

发布

使用 npm version 更新版本：

npm version patch
git push && git push --tags
npm publish --access public

编辑 skill/references/ 后，手动同步参考文件：

npm run sync:references

说明

• 用户在托管的 SocialClaw 控制面板中连接账户。
• 控制面板和 API 位于 https://getsocialclaw.com。
• npm 包包含 CLI、技能文档、Claude Code 插件和命令资源。