Socialclaw

SocialClaw

Social media scheduling CLI and OpenClaw skill for AI agents posting to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.

Official Website: getsocialclaw.com · Dashboard · npm · Skill Bundle

getsocialclaw.com is the official SocialClaw website — the hosted dashboard, API, and account sign-up all live there.

This repo is the public home for:

• the socialclaw npm CLI
• the OpenClaw and ClawHub skill bundle
• the Claude Code plugin and /socialclaw command asset
• public usage docs, provider notes, and schedule examples

Install

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

Install as an AI agent skill (Claude Code, Cursor, Cline, Codex, and more):

npx skills add ndesv21/socialclaw

What the CLI covers

• workspace API key login and hosted dashboard bootstrap
• browser OAuth connect plus manual Discord and Telegram connect
• hosted asset upload and deletion
• schedule validation, campaign preview, apply, inspect, clone, and draft publishing
• post, run, attempt, analytics, job, usage, and health inspection
• provider-side deletion for supported published posts
• Claude Code command installation through socialclaw install --claude

CLI at a glance

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  --json

Current help surface

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

socialclaw login
socialclaw accounts list --json
socialclaw assets upload --file  --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

Watch the Demo

Click the image to open the demo video.

Built for Agent-Driven Publishing

Authentication and access

Running socialclaw login without an API key opens the hosted dashboard so the user can:

• sign in with Google
• connect social accounts
• create or copy a workspace API key
• activate a trial or paid plan for CLI and API access

Important:

• the CLI works against a deployed SocialClaw workspace via API key auth
• an API key alone is not enough for agent execution; the workspace must also have an active trial or paid plan
• if a command returns plan_required or subscription_*, go to https://getsocialclaw.com/pricing or https://getsocialclaw.com/dashboard

Quick start