> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rawugc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Claw

> The recommended way to use the RawUGC API through the official Open Claw skill

## What is Open Claw?

[Open Claw](https://openclaw.ai) is a gateway-based AI agent platform that lets you chat with AI through a browser-based Control UI, Discord, Slack, and other messaging channels. It supports extensible **skills** — packaged instructions and tools that teach agents how to perform specific tasks.

[ClawHub](https://clawhub.ai) is Open Claw's public skill registry where you can discover, install, and share skills with the community.

The **official RawUGC skill** is the recommended way to interact with the RawUGC API through Open Claw. Instead of writing code or crafting API calls manually, you tell your agent what you want and the skill handles the rest.

<Card title="View on ClawHub" icon="download" href="https://clawhub.ai/tfcbot/ai-ugc">
  Get the official RawUGC skill → clawhub.ai/tfcbot/ai-ugc
</Card>

## Why use the skill instead of raw API calls?

|                      | Raw API                                      | Open Claw Skill                       |
| -------------------- | -------------------------------------------- | ------------------------------------- |
| **Setup**            | Write auth headers, base URLs, polling logic | One install + API key                 |
| **Video generation** | Build request payloads, handle async polling | "Generate a video of a sunset beach"  |
| **Error handling**   | Parse RFC 7807 errors, retry logic           | Automatic with plain-English feedback |

The skill is ideal for prototyping, content creation workflows, and anyone who wants to generate videos without writing integration code.

## Setup

### 1. Get your RawUGC API key

Go to [Account Settings](https://rawugc.com/account) and create a new API key. Copy the secret — it's only shown once.

### 2. Install the RawUGC skill

Install the skill from ClawHub:

```bash theme={null}
clawhub install tfcbot/ai-ugc
```

This downloads the skill into your workspace's `./skills` directory.

### 3. Configure your API key

Add your API key to Open Claw's skill configuration in `~/.openclaw/openclaw.json`:

```json theme={null}
{
  "skills": {
    "entries": {
      "rawugc-api": {
        "enabled": true,
        "env": {
          "RAWUGC_API_KEY": "sk_your_key_here"
        }
      }
    }
  }
}
```

Alternatively, export the environment variable in your shell profile (`~/.zshrc` or `~/.bashrc`):

```bash theme={null}
export RAWUGC_API_KEY=sk_your_key_here
```

Start a new Open Claw session for the skill to load.

## Available commands

Once installed, you get three slash commands:

### `/rawugc:generate-video`

Generate AI videos using any supported model. The agent will ask for your concept, help you pick the right model, confirm credit cost, and poll for completion automatically.

```
You: /rawugc:generate-video a golden retriever running through a field of sunflowers

Agent: I'll generate that with Sora 2 (6 credits). Submitting now...
       Task ID: task_abc123 — polling for completion.
       Done! Here's your video: https://storage.rawugc.com/videos/abc123.mp4
```

**Supported models:**

| Model                      | Type                       | Credits | Time    |
| -------------------------- | -------------------------- | ------- | ------- |
| `sora-2-text-to-video`     | Text to Video              | 6       | 1-3 min |
| `sora-2-image-to-video`    | Image to Video             | 6       | 2-4 min |
| `veo3`                     | Text/Image to Video        | 6       | 2-4 min |
| `veo3_fast`                | Text/Image to Video (fast) | 6       | 1-3 min |
| `kling-2.6/motion-control` | Motion transfer            | 18      | 2-5 min |

### `/rawugc:check-video`

Check the status of a generation task. Pass a task ID directly or let the agent show your recent pending tasks.

```
You: /rawugc:check-video task_abc123

Agent: Completed — Video URL: https://storage.rawugc.com/videos/abc123.mp4
```

### `/rawugc:my-videos`

List your recent video generations in a table with status, model, prompt, and result URLs.

## Example workflows

### Generate a batch of product videos

```
You: I need 3 product showcase videos for my e-commerce store.
     1. A skincare serum bottle rotating on a marble surface
     2. A pair of sneakers with dynamic lighting
     3. A watch with cinematic close-ups

Agent: I'll generate all 3 with Veo 3 Fast (6 credits each, 18 total).
       Submitting...
```

## Keeping the skill updated

Update the RawUGC skill (and all other installed skills) with:

```bash theme={null}
clawhub update --all
```

## When to use the API directly

The Open Claw skill covers the most common workflows, but you may want the [REST API](/quickstart) directly when:

* **Building a production integration** — embed video generation in your own app or SaaS
* **Automating at scale** — programmatic batch generation with custom retry logic
* **Webhook consumers** — receiving completion callbacks in your own backend
* **Custom pipelines** — chaining video generation with other services

See the [API Reference](/api-reference) and [Code Examples](/sdks) for direct integration guides.

## Troubleshooting

### "Authentication failed"

Make sure `RAWUGC_API_KEY` is configured. Check your Open Claw config:

```bash theme={null}
cat ~/.openclaw/openclaw.json
```

Or verify the environment variable is set:

```bash theme={null}
echo $RAWUGC_API_KEY
```

If empty, add it to your config or shell profile and start a new session.

### "Insufficient credits"

Purchase more credits at [rawugc.com/billing](https://rawugc.com/billing).

### "Rate limit exceeded"

API keys are limited to 10 requests per minute. The skill handles polling intervals automatically, but if you're running many concurrent generations, space them out.

### Skill not loading

Skills are snapshotted when a session starts. If you just installed the skill, start a new Open Claw session for it to appear. Verify installation:

```bash theme={null}
clawhub search rawugc
```

Or check the skill page on ClawHub: [clawhub.ai/tfcbot/ai-ugc](https://clawhub.ai/tfcbot/ai-ugc)
