Drive Supapost from

OpenClaw.

Install the skill

The Supapost skill is a standard OpenClaw SKILL.md file. There are two ways to install it:

Option A, universal installer (recommended)

Use the vercel-labs/skills CLI. It writes the skill into ~/.agents/skills/supapost, which OpenClaw reads automatically on startup. Works across 45+ agents, not just OpenClaw, so if you also use Claude Code or Cursor the same skill serves all of them.

npx skills add supapost-dev/skills

Pick OpenClaw (and any other agents you use) when the CLI asks, and you're done.

Option B, ClawHub

OpenClaw's own skill registry is ClawHub. The Supapost skill is published at clawhub.ai/supapost-dev/supapost-skill, passes the automated security scan, and installs with:

clawhub skill add supapost-dev/supapost-skill

If someone already has the separate ClawHub CLI installed for registry workflows, the equivalent command is:

clawhub install supapost-skill

ClawHub adds automated security scanning and easier discovery inside the OpenClaw UI. The native openclaw skills install flow is the best default because it uses OpenClaw's built-in workspace-aware installer. If you already use the standalone clawhub CLI for publishing or syncing, that works too.

Connect the MCP

Installing the skill teaches the OpenClaw agent how Supapost works. To actually call Supapost tools, connect the Supapost MCP server. Supapost supports both remote HTTP (OAuth) and local stdio (API key). For OpenClaw, the remote transport is almost always the right choice, no Node install, no key to manage, browser-based sign-in.

{
  "mcpServers": {
    "supapost": {
      "url": "https://mcp.supapo.st"
    }
  }
}

The first time your OpenClaw agent calls a Supapost tool, your browser opens supapo.st/mcp/authorize. Sign in with Google, approve the OpenClaw client, and the access token is stored locally. Every subsequent tool call is authenticated automatically.

Prefer API keys? Create one at app.supapo.st/settings/developer (keys start with sp_live_) and pass it as a Bearer header:

{
  "mcpServers": {
    "supapost": {
      "url": "https://mcp.supapo.st",
      "headers": { "Authorization": "Bearer sp_live_..." }
    }
  }
}

Verify

Ask your OpenClaw agent to run list_models. You should see a JSON list of available image and video models. If you get a 401, the access token needs refreshing ( re-run the MCP add) or your API key is invalid.

Golden workflows

Generate a full TikTok deck from a prompt

1. Ask OpenClaw: "Build a 10-slide TikTok deck about budget meal prep for students, warm colours."
2. The agent calls generate_slides with the prompt. Supapost returns a project with slide backgrounds, text layers, and a ready-to-edit URL.
3. OpenClaw hands back the URL. Review and tweak in the Supapost editor, then schedule.

Create a consistent AI influencer

1. Ask: "Create an influencer named Clara, late 20s, London coffee shop aesthetic."
2. The agent calls generate_image with the description, picks the best result, and calls create_influencer with that URL as the identity anchor.
3. Every subsequent generate_image with influencerId: Clara produces scenes with the same face. The agent can describe outfits, lighting, and location without re-describing the character.

Queue a week of posts

1. Ask: "Schedule the Clara deck to TikTok every weekday at 9am for two weeks."
2. The agent calls list_social_accounts, resolves your TikTok account id, then schedule_post ten times with the correct ISO 8601 datetimes.
3. Cloudflare Queues handles delivery with automatic retries. You get notified when each post goes live.

Combining Supapost with OpenClaw's other tools

OpenClaw can talk to Slack, WhatsApp, home servers, and other MCP-compliant services in the same session. A common pattern: generate a draft deck with Supapost, have OpenClaw drop a preview into a Slack channel for team review, then tell OpenClaw to schedule it once approved. The Supapost skill and MCP don't care what other tools are loaded, use whatever makes your workflow faster.

Troubleshooting

• Skill not triggering. Ensure ~/.agents/skills/supapost/SKILL.md exists. Run npx skills list to verify OpenClaw sees it.
• 401 Invalid access token. Remove and re-add the MCP in OpenClaw's config, then let the browser flow run again.
• Tools time out. Generation jobs are async; the tool returns a job id. The skill tells the agent to surface that to you rather than block waiting.
• Missing env or bin. Remote MCP needs no local runtime. For stdio (Option B, Bearer), make sure Node 18+ is installed and npx -y @supapost/mcp runs successfully in your terminal.

FAQ