SocialClaw
GitHub Dashboard

Frequently Asked Questions

What is SocialClaw?

How do AI agents use SocialClaw to publish social media content?

Can I use SocialClaw from the CLI or an OpenClaw-compatible tool?

Which social platforms does SocialClaw support?

How do customers connect their social media accounts?

Can I embed social publishing inside my SaaS product?

Does SocialClaw handle scheduling, media hosting, and post tracking?

Does SocialClaw support direct media upload from the CLI?

Is SocialClaw JSON-only

What social media connections does SocialClaw currently support?



                                                  ,i
                      ,i,
                      ,f:
                   ,.
                   i,                ..
                                    .ff.
                                    1CL;
                                   ;CCCf.                                 ,L;
                            .     :CCCLf;                            ..   .:,
         ,:.                it:  :CCGCCLC1;:,,.                      ;:
         1G1                .ff::G888888@@88880GLf1;,.
          .:i.               tCG8880000000@@@@@@@@@@80Cf1:.
            ;L,            .10800CGGCGCGfC0G088888@@@@@@@@8Ct:
             1C:        .;L0800GGGCLLLLLfffLLLLLffC00C0888@@@8C;
    .        .LC;    ,;f080GCCLLLLfLffGCfLCCCLLLLCLffffG@@@@8@@@C,
    ,         tLLGffLGG0CLfffffffffffGCffLCLffffC@8LffffLG008888@8:
              fLCCii1fLLLLffffffffffLGffLLCLfffC0@0ffffffffffLLLLLt
             :GC:     ,ifLLfffffffffLGffLLLffffG8Gfffffffffffffffff,
            :Lf,         ;ffffffLLLLfGLfffffffffffffffffffffffLLCLL:                       .;
           :1:            ;LLLLLLLLLfLGfCffffffffLLLfffLCCG0088@0t:                        .:
           .            .:Lf1ifCCLLLLfCCLCCLfffffCCLffG00000GGGCf1i.
                        .:,.  .:tLCLLffCCLLLLLffffLLfLLLLffffffffLi
                                 ,ifLLLfLLLLfLLLLLLLCCCCCLLLLLfti,
                                   .fLfLfLLLLLLLLLLLfftt1ii;::.
                                 ,itt,.,:;;tfi1i;;:,..
                                :fL1        1,
                               :Lf;         .1.
                      ;1.     :L1,           ..
                      if,    .1:



              .;,
              ,Li                                                       ,fi
                                                                        .1;

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.

 # 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 and use the returned publicUrl in
  facebook-page-post.json
  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


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

GitHub

ClawHub

For teams building agent products that need real social execution

AI marketing agents

   Give agent workflows a real publishing backend with

    connected accounts, hosted media, validation, and delivery state.

Embedded publishing
inside your SaaS

Let customers connect accounts once, then trigger

    scheduling and publishing from your product through one workspace API.

How it works

First, connect your social media accounts

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

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.

Publish, analyze and schedule content

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

Creator workflow tool

Power internal or creator-facing tools that turn drafts, assets, and calendars into actual published social output.

OpenClaw compatible tools

Add SocialClaw as the execution layer for OpenClaw agents

    that need account access, media delivery, and publish control.

OAuth account connection
Publishing pipeline
Retry and delivery status
Analytics and post inspection

AI Agents love
SocialClaw

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

Why agents use SocialClaw for social publishing

Clear scope and focused execution help teams launch faster and see real impact sooner.

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

Why agents use SocialClaw for social publishing

Clear scope and focused execution help teams launch faster and see real impact sooner.

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.
# List connected accounts
socialclaw accounts list --json

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

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

# Preview how SocialClaw will interpret the publish shape
socialclaw accounts action \
  --account-id <ACCOUNT_ID> \
  --action publish-preview \
  --input examples/account-action-publish-preview.json \
  --json
Connect accounts once. Reuse them across every workflow.
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.
# 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
socialclaw accounts connect --provider reddit --open

# Check connection state and list connected accounts
socialclaw accounts status --connection-id <CONNECTION_ID> --json
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 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.
# Validate and apply a schedule
socialclaw validate -f campaign.json --json
socialclaw apply -f campaign.json --idempotency-key launch_batch_1 --json

# Inspect the run
socialclaw status --run-id <RUN_ID> --json
socialclaw runs inspect --run-id <RUN_ID> --json

# Inspect the resulting post
socialclaw posts get --post-id <POST_ID> --json
socialclaw posts attempts --post-id <POST_ID> --json
socialclaw posts reconcile --post-id <POST_ID> --json

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


                                                  ,i
                      ,i,
                      ,f:
                   ,.
                   i,                ..
                                    .ff.
                                    1CL;
                                   ;CCCf.                                 ,L;
                            .     :CCCLf;                            ..   .:,
         ,:.                it:  :CCGCCLC1;:,,.                      ;:
         1G1                .ff::G888888@@88880GLf1;,.
          .:i.               tCG8880000000@@@@@@@@@@80Cf1:.
            ;L,            .10800CGGCGCGfC0G088888@@@@@@@@8Ct:
             1C:        .;L0800GGGCLLLLLfffLLLLLffC00C0888@@@8C;
    .        .LC;    ,;f080GCCLLLLfLffGCfLCCCLLLLCLffffG@@@@8@@@C,
    ,         tLLGffLGG0CLfffffffffffGCffLCLffffC@8LffffLG008888@8:
              fLCCii1fLLLLffffffffffLGffLLCLfffC0@0ffffffffffLLLLLt
             :GC:     ,ifLLfffffffffLGffLLLffffG8Gfffffffffffffffff,
            :Lf,         ;ffffffLLLLfGLfffffffffffffffffffffffLLCLL:                       .;
           :1:            ;LLLLLLLLLfLGfCffffffffLLLfffLCCG0088@0t:                        .:
           .            .:Lf1ifCCLLLLfCCLCCLfffffCCLffG00000GGGCf1i.
                        .:,.  .:tLCLLffCCLLLLLffffLLfLLLLffffffffLi
                                 ,ifLLLfLLLLfLLLLLLLCCCCCLLLLLfti,
                                   .fLfLfLLLLLLLLLLLfftt1ii;::.
                                 ,itt,.,:;;tfi1i;;:,..
                                :fL1        1,
                               :Lf;         .1.
                      ;1.     :L1,           ..
                      if,    .1:



              .;,
              ,Li                                                       ,fi
                                                                        .1;



                                                  ,i
                      ,i,
                      ,f:
                   ,.
                   i,                ..
                                    .ff.
                                    1CL;
                                   ;CCCf.                                 ,L;
                            .     :CCCLf;                            ..   .:,
         ,:.                it:  :CCGCCLC1;:,,.                      ;:
         1G1                .ff::G888888@@88880GLf1;,.
          .:i.               tCG8880000000@@@@@@@@@@80Cf1:.
            ;L,            .10800CGGCGCGfC0G088888@@@@@@@@8Ct:
             1C:        .;L0800GGGCLLLLLfffLLLLLffC00C0888@@@8C;
    .        .LC;    ,;f080GCCLLLLfLffGCfLCCCLLLLCLffffG@@@@8@@@C,
    ,         tLLGffLGG0CLfffffffffffGCffLCLffffC@8LffffLG008888@8:
              fLCCii1fLLLLffffffffffLGffLLCLfffC0@0ffffffffffLLLLLt
             :GC:     ,ifLLfffffffffLGffLLLffffG8Gfffffffffffffffff,
            :Lf,         ;ffffffLLLLfGLfffffffffffffffffffffffLLCLL:                       .;
           :1:            ;LLLLLLLLLfLGfCffffffffLLLfffLCCG0088@0t:                        .:
           .            .:Lf1ifCCLLLLfCCLCCLfffffCCLffG00000GGGCf1i.
                        .:,.  .:tLCLLffCCLLLLLffffLLfLLLLffffffffLi
                                 ,ifLLLfLLLLfLLLLLLLCCCCCLLLLLfti,
                                   .fLfLfLLLLLLLLLLLfftt1ii;::.
                                 ,itt,.,:;;tfi1i;;:,..
                                :fL1        1,
                               :Lf;         .1.
                      ;1.     :L1,           ..
                      if,    .1:



              .;,
              ,Li                                                       ,fi
                                                                        .1;



                                                  ,i
                      ,i,
                      ,f:
                   ,.
                   i,                ..
                                    .ff.
                                    1CL;
                                   ;CCCf.                                 ,L;
                            .     :CCCLf;                            ..   .:,
         ,:.                it:  :CCGCCLC1;:,,.                      ;:
         1G1                .ff::G888888@@88880GLf1;,.
          .:i.               tCG8880000000@@@@@@@@@@80Cf1:.
            ;L,            .10800CGGCGCGfC0G088888@@@@@@@@8Ct:
             1C:        .;L0800GGGCLLLLLfffLLLLLffC00C0888@@@8C;
    .        .LC;    ,;f080GCCLLLLfLffGCfLCCCLLLLCLffffG@@@@8@@@C,
    ,         tLLGffLGG0CLfffffffffffGCffLCLffffC@8LffffLG008888@8:
              fLCCii1fLLLLffffffffffLGffLLCLfffC0@0ffffffffffLLLLLt
             :GC:     ,ifLLfffffffffLGffLLLffffG8Gfffffffffffffffff,
            :Lf,         ;ffffffLLLLfGLfffffffffffffffffffffffLLCLL:                       .;
           :1:            ;LLLLLLLLLfLGfCffffffffLLLfffLCCG0088@0t:                        .:
           .            .:Lf1ifCCLLLLfCCLCCLfffffCCLffG00000GGGCf1i.
                        .:,.  .:tLCLLffCCLLLLLffffLLfLLLLffffffffLi
                                 ,ifLLLfLLLLfLLLLLLLCCCCCLLLLLfti,
                                   .fLfLfLLLLLLLLLLLfftt1ii;::.
                                 ,itt,.,:;;tfi1i;;:,..
                                :fL1        1,
                               :Lf;         .1.
                      ;1.     :L1,           ..
                      if,    .1:



              .;,
              ,Li                                                       ,fi
                                                                        .1;
The official social publishing layer for AI agents.

Social media scheduling for
OpenClaw AI agents.

ClawHub

GitHub

Sign in

SocialClaw

Frequently Asked Questions

SocialClaw is a social publishing layer for AI agents, workflows, and SaaS products. It handles connected accounts, media hosting, scheduling, publish execution, and delivery state from one workspace.