OpenClaw · Codex · Claude Code

Why AI Agents love
SocialClaw

SocialClaw is not just a posting endpoint. It gives AI agents a stable control plane for account discovery, media handoff, validation, schedule execution, and post inspection — driven entirely from the CLI, API, MCP, or an OpenClaw skill.

Start free Read the API docs

OpenClaw · Codex · Claude Code

Built for OpenClaw & CLI workflows

SocialClaw fits naturally into OpenClaw-compatible agent stacks, Codex, Claude Code, and other CLI agents. Agents handle planning and content. SocialClaw handles connected accounts, workspace auth, hosted media, publish rules, and delivery state.

terminal

# Install the CLI
npm install -g socialclaw

# Authenticate the workspace
socialclaw login --api-key $SOCIALCLAW_API_KEY \
  --base-url https://getsocialclaw.com

# Upload the image, reuse the returned publicUrl
socialclaw assets upload --file ./launch.png --json

# Validate and publish a Facebook Page post
socialclaw validate -f facebook-page-post.json --json
socialclaw apply -f facebook-page-post.json --json

facebook-page-post.json

{
  "timezone": "UTC",
  "posts": [
    {
      "account": "facebook:page:1234567890123",
      "name": "Launch post",
      "description": "New release is live.",
      "media_link": "https://getsocialclaw.com/media/asset_xxx/launch.png",
      "publish_at": "2026-03-24T14:00:00Z",
      "settings": { "pagePostMode": "photo" }
    }
  ]
}

GitHub ClawHub

How it works

From connected account to published post

Three steps from a fresh workspace to live, tracked social posts — driven entirely from the CLI or an OpenClaw skill.

1

First, connect your social media accounts

Bring Facebook, Instagram, YouTube, TikTok, Pinterest, Snapchat, Telegram, LinkedIn, Reddit, WordPress, and more into one place.

2

Run from the CLI or OpenClaw skill

Use the SocialClaw CLI in scripts and terminals, or call the same hosted service through the OpenClaw skill.

3

Publish, analyze and schedule content

Validate schedules, upload media, apply runs, and inspect posts, jobs, and analytics from one workspace.

A stable control plane for agents

Use SocialClaw as the social execution layer inside your agent product.

Why agents use SocialClaw for social publishing

SocialClaw is not just a posting endpoint. It gives agents a stable control plane for account discovery, media handoff, validation, schedule execution, and post inspection.

Connect accounts once at the workspace level

Query what each connected account can actually do

Upload media and get reusable hosted delivery URLs

Validate before publish instead of failing at send time

Inspect runs, posts, attempts, and analytics after execution

Use structured JSON outputs in terminal and automation workflows

This is what makes SocialClaw agent-friendly. An agent can discover connected targets, inspect provider-specific limits, preview effective publish settings, and validate media handling before it tries to publish.

discover

# List connected accounts
socialclaw accounts list --json

# Ask what an account supports
socialclaw accounts capabilities \
  --account-id <ACCOUNT_ID> --json

# Inspect publish settings
socialclaw accounts settings \
  --account-id <ACCOUNT_ID> --json

SocialClaw keeps account connection inside the workspace. End users connect accounts in the dashboard or through the CLI flow, and agents work against those connected resources through a workspace API key.

connect

# Log into the workspace
socialclaw login --api-key $SOCIALCLAW_API_KEY \
  --base-url https://getsocialclaw.com

# Start an account connection flow
socialclaw accounts connect --provider facebook --open
socialclaw accounts connect --provider linkedin --open

# Check connection state
socialclaw accounts list --json

SocialClaw supports direct local media upload from the CLI. The response returns a hosted public URL that can be reused as media_link in schedule files.

upload

# Upload a local image
socialclaw assets upload --file ./launch.png --json

# Upload a local video
socialclaw assets upload --file ./release-video.mp4 --json

SocialClaw is designed for agents that need more than a blind post command. A publish flow can validate schedule shape first, apply a run, inspect post state, reconcile provider status, and refresh analytics after publish.

publish

# Validate and apply a schedule
socialclaw validate -f campaign.json --json
socialclaw apply -f campaign.json --json

# Inspect the run and resulting post
socialclaw runs inspect --run-id <RUN_ID> --json
socialclaw posts get --post-id <POST_ID> --json

# Refresh and read analytics
socialclaw analytics post --post-id <POST_ID> --json

Use cases