# OpenClaw

> OpenClaw social media automation. Added in one command.

Canonical page: https://www.socialfaktory.com/agents/openclaw

Register SocialFaktory as a streamable-http MCP server from the OpenClaw CLI or its settings, and every session can price, generate, schedule and publish for your brand.

- **21** Tools
- **3** Scopes

## Point your client at the endpoint

Mint a personal access token first. The secret is shown once, and it works on this endpoint only.

Endpoint: `POST https://www.socialfaktory.com/mcp`

### OpenClaw CLI

```bash
openclaw mcp set socialfaktory '{"url":"https://www.socialfaktory.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer sfp_…"}}'
```


### OpenClaw config file

`openclaw.json`

```json
{
  "mcp": {
    "servers": {
      "socialfaktory": {
        "url": "https://www.socialfaktory.com/mcp",
        "transport": "streamable-http",
        "headers": { "Authorization": "Bearer sfp_…" }
      }
    }
  }
}
```


## What the agent can do

- `list_brands` (Read)
- `list_channels` (Read)
- `get_channel_requirements` (Read)
- `list_formats` (Read)
- `get_generation` (Read)
- `list_generations` (Read)
- `get_text_generation` (Read)
- `quote_generation` (Read)
- `create_generation` (Generate)
- `generate_text` (Generate)
- `create_upload` (Generate)
- `complete_upload` (Generate)
- `get_upload` (Read)
- `list_media` (Read)
- `create_posts` (Publish)
- `send_post` (Publish)
- `list_posts` (Read)
- `delete_post` (Publish)
- `check_reference` (Read)
- `get_wallet` (Read)
- `list_actors` (Read)


## How permissions work

- Every token can read. Add generate for anything that spends credits, and publish for creating, scheduling, sending and deleting posts.
- Pin a token to one brand and it sees only that brand, with its channels, generations, posts and text. The credit wallet, uploads, actors and products stay shared across the account.
- Set a monthly credit cap and the token starts no paid call once the month's spend reaches it.
- Every call that spends or publishes carries an idempotency key. A replay inside 24 hours returns the first result instead of doing the work twice.
- 120 calls a minute per token, and 300 requests every 5 minutes per address.

## What it won't do

- Clone a video from a link. That one runs in the app only.
- Generate still images or carousels. Neither is available through an agent yet.
- Connect a social channel. Connecting one is a browser sign-in, so it stays in the app.
- Start a paid call that would pass the cap you set on the token, or change your plan.

## A typical run

1. **Mint the token**: Pick its scopes, pin it to a brand, set a monthly cap. The secret is shown once.
2. **Ask for a price**: quote_generation prices a video for free. It's an optional check, and a render runs without one.
3. **Generate**: create_generation makes the video and charges its price. generate_text reserves a few credits and settles what the write used. Both hand back an id you read the result from.
4. **Schedule it**: create_posts composes one post per channel, and send_post puts it on its channel now or at its time.

## Questions

### How do I add the server?

Run openclaw mcp set with a JSON entry that carries the endpoint, the streamable-http transport and the Authorization header, or write the same entry under mcp.servers in openclaw.json.

### Is there a path through the interface?

Yes. The Control UI has Settings, then MCP, then Add server, which takes the same URL and header.

### Can I expose only some tools?

Yes. OpenClaw can include a subset of the tools for a session, and the scope on the token is the harder limit underneath it.

### Can I run it on a schedule?

Yes. Point a scheduled session at the same server. Idempotency keys make a repeated call safe.

### Where does the token go?

In an Authorization header on the server entry. Mint it in your settings, and revoke it there if it ever leaks.

### What happens if a render fails?

The generation reports the failure. A service failure is refunded in full, and a run refused for content policy or a bad reference link keeps what it already spent and refunds the rest.

## More for developers

- For AI agents: https://www.socialfaktory.com/agents.md
- MCP server: https://www.socialfaktory.com/agents/mcp-server.md
- Claude: https://www.socialfaktory.com/agents/claude.md
- ChatGPT: https://www.socialfaktory.com/agents/chatgpt.md
- Codex: https://www.socialfaktory.com/agents/codex.md
- Meta Muse: https://www.socialfaktory.com/agents/muse.md
- Read the MCP reference: https://www.socialfaktory.com/docs/mcp.md
- AI assistant: https://www.socialfaktory.com/features/ai-assistant.md