How to Install and Use Upload Post in OpenClaw

Open your terminal and run the ClawHub install command for Upload Post. This downloads the skill from the ClawHub registry, validates its package signature, and registers it with your local OpenClaw configuration. The install command completes in a few seconds and shows you the required configuration key: UPLOAD_POST_API_KEY. You will get this in the next step. The skill installs successfully without the key but produces an error when you try to use it before the key is configured — this is expected behavior. If you see `clawhub: command not found`, verify your OpenClaw PATH configuration. The ClawHub binary ships with OpenClaw and is typically found at `/usr/local/bin/clawhub` on macOS/Linux. Reinstalling OpenClaw from openclaw.ai will restore a missing ClawHub binary.

1clawhub install upload-post

Before getting the API key, ensure your social media accounts are connected in Upload Post. Log into app.uploadpost.com and navigate to the Accounts or Channels section. Connect each platform you want to publish to — Twitter/X, LinkedIn, Instagram, Facebook, etc. Each platform will walk you through an OAuth authorization flow. Complete these connections before generating the API key so you can test all your platforms in the steps that follow. Once your accounts are connected, navigate to Settings and look for the API Keys or Developer section. Click 'Generate API Key' or 'Create new key'. Give it a label like 'OpenClaw' to identify its purpose. Copy the generated key immediately — some services only display it once. Your Upload Post API key provides full posting access to all connected social accounts. Treat it as you would a password — don't share it, don't commit it to version control, and regenerate it immediately if you suspect it has been exposed.

Add your Upload Post API key to OpenClaw's configuration. Use the `clawhub config set` command for the quickest setup, or add the key manually to your OpenClaw `.env` file located in `~/.openclaw/` on macOS/Linux. After setting the key, run `clawhub reload` to apply the configuration without restarting OpenClaw. Verify the key is properly set by running `clawhub config get UPLOAD_POST_API_KEY` — this returns the key value (partially masked) if configured correctly. If you use OpenClaw on multiple machines or share it with a team, each instance needs its own API key configured. Generate a separate key per instance in Upload Post's settings for easier access management.

1# Option A: Add to ~/.openclaw/.env
2UPLOAD_POST_API_KEY=your-upload-post-api-key-here
3
4# Option B: Set via clawhub config
5clawhub config set UPLOAD_POST_API_KEY your-upload-post-api-key-here
6
7# Verify configuration
8clawhub config get UPLOAD_POST_API_KEY
9
10# Apply without restart
11clawhub reload

Open OpenClaw chat and write a prompt to publish a test post. For your first test, publish to one platform with simple text content to verify the end-to-end connection. Once confirmed, you can move to multi-platform posts. The Upload Post skill publishes content the moment OpenClaw sends the API request — there is no preview or confirmation step by default. If you want to review content before it goes live, include 'draft mode' or 'show me what will be posted before publishing' in your prompt. OpenClaw will present the content for your review and wait for explicit confirmation. A successful publish returns a confirmation from Upload Post that includes the post ID, the platform it was published to, and a direct link to the live post. Save the post ID if you might need to reference or delete the post later. RapidDev can help you set up a multi-platform publishing workflow in OpenClaw that combines Upload Post for instant publishing with Postiz for scheduled content, giving you full control over your social media pipeline.

The most powerful Upload Post workflow is publishing platform-adapted content simultaneously. Each social platform has different character limits, audience expectations, and media requirements. You can instruct OpenClaw to craft platform-specific versions of the same core message and publish them all in a single prompt. Twitter/X: 280 characters, punchy, conversational, hashtags welcome. LinkedIn: professional tone, longer-form acceptable (up to 3,000 characters), no excessive hashtags. Instagram: visual-first, caption under 2,200 characters, hashtag-heavy (up to 30). Facebook: conversational, medium length, link-friendly. You can also request that OpenClaw attach images or media to posts through Upload Post if you have the media URL available. The skill passes media attachments through to each platform's media upload API automatically. For high-frequency publishing workflows — content agencies or brands posting dozens of times per week — configure the skill's default platform list so you don't need to specify platforms in every prompt.

1# Configure default platforms in skill config
2# ~/.openclaw/skills/upload-post.yaml
3upload-post:
4  default_platforms:
5    - twitter
6    - linkedin
7    - facebook
8  require_confirmation: false  # set true to review before publishing
9  include_link_preview: true   # generate link preview cards when URLs are included