# Send Video Captioning by ReelWords to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "video-captions-reelwords",
    "name": "Video Captioning by ReelWords",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Kmasterrr/video-captions-reelwords",
    "canonicalUrl": "https://clawhub.ai/Kmasterrr/video-captions-reelwords",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/video-captions-reelwords",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-captions-reelwords",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/reelwords_caption_job.py",
      "references/api.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "video-captions-reelwords",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T16:37:44.014Z",
      "expiresAt": "2026-05-17T16:37:44.014Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-captions-reelwords",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-captions-reelwords",
        "contentDisposition": "attachment; filename=\"video-captions-reelwords-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "video-captions-reelwords"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/video-captions-reelwords"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/video-captions-reelwords",
    "downloadUrl": "https://openagent3.xyz/downloads/video-captions-reelwords",
    "agentUrl": "https://openagent3.xyz/skills/video-captions-reelwords/agent",
    "manifestUrl": "https://openagent3.xyz/skills/video-captions-reelwords/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/video-captions-reelwords/agent.md"
  }
}
```
## Documentation

### ReelWords Captions

Generate stylized captions for videos using the ReelWords Caption API: create a caption render job, poll until complete, then download the rendered output.

### 1) Create a ReelWords account + API key

Sign up / log in: https://reelwords.ai
Open the account menu (top-right) → API Keys → New key
Copy the key (it will look like rw_...).

### 2) Provide the API key to OpenClaw

Provide the API key to the process as REELWORDS_API_KEY.

Common options:

Set REELWORDS_API_KEY as an environment variable (best when running the script directly)
If you run via OpenClaw/Clawdbot, store it in ~/.clawdbot/openclaw.json under skills.entries.reelwords-captions.env so the runtime can populate env vars for the skill.

Option A: environment variable

export REELWORDS_API_KEY="rw_..."

Option B: openclaw.json (recommended)

Edit ~/.clawdbot/openclaw.json and add an entry:

{
  "skills": {
    "entries": {
      "reelwords-captions": {
        "enabled": true,
        "env": {
          "REELWORDS_API_KEY": "rw_..."
        }
      }
    }
  }
}

### Security note

Treat your API key like a password:

don’t commit it to git
don’t paste it into public chats
rotate it in ReelWords if you suspect it leaked

### Usage

Base URL: https://api.reelwords.ai

You can use either the included helper script (simplest), or call the REST endpoints directly.

### Option 1: All-in-one helper script (create → poll → download)

From this skill directory:

python3 scripts/reelwords_caption_job.py \\
  --video-url "https://cdn.reelwords.ai/sample.mp4" \\
  --style-id "style1" \\
  --add-emojis \\
  --max-words-per-line 6 \\
  --position-y 82 \\
  --font-size 54 \\
  --highlight-color "#FFD803" \\
  --hook-color "#FF5CAA" \\
  --out captioned.mp4

Notes:

The script prints the final job JSON to stdout.
Download logic:

prefers result.downloadUrl when present
otherwise falls back to GET /api/v1/caption-jobs/{id}/video (which typically redirects to a signed URL)

### Option 2: Raw API examples (curl)

1) Create job

curl -sS https://api.reelwords.ai/api/v1/caption-jobs \\
  -H "x-api-key: $REELWORDS_API_KEY" \\
  -H "content-type: application/json" \\
  -d '{
    "videoUrl": "https://cdn.reelwords.ai/sample.mp4",
    "preferences": {
      "style": {
        "styleId": "style1"
      }
    }
  }'

Response includes an id (save it as $JOB_ID).

2) Poll status

curl -sS https://api.reelwords.ai/api/v1/caption-jobs/$JOB_ID \\
  -H "x-api-key: $REELWORDS_API_KEY" \\
  -H "accept: application/json"

Poll until status becomes completed (or the response includes failureReason/failureMessage).

3) Download rendered video

Preferred (when present):

download from result.downloadUrl

Fallback (works in most tenants):

curl -L https://api.reelwords.ai/api/v1/caption-jobs/$JOB_ID/video \\
  -H "x-api-key: $REELWORDS_API_KEY" \\
  -o captioned.mp4

### Workflow (high level)

Create caption job: POST /api/v1/caption-jobs

videoUrl (required)
preferences.style.styleId (required)
optional preferences (emojis, max words per line, colors, font sizing, etc.)


Poll job status: GET /api/v1/caption-jobs/{id} until:

completed: result.downloadUrl is usually present (downloadable)
failed: failureReason / failureMessage present


Download:

result.downloadUrl, or
GET /api/v1/caption-jobs/{id}/video (redirects to a signed URL)

### References

API summary + curl examples: references/api.md

### Notes

Auth header is x-api-key: <token>.
If you hit usage limits, treat HTTP 402 as “out of credits / limit reached” and surface the response cleanly.
If ReelWords adds new fields, prefer passing them through in the JSON payload rather than hardcoding assumptions.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Kmasterrr
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T16:37:44.014Z
- Expires at: 2026-05-17T16:37:44.014Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/video-captions-reelwords)
- [Send to Agent page](https://openagent3.xyz/skills/video-captions-reelwords/agent)
- [JSON manifest](https://openagent3.xyz/skills/video-captions-reelwords/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/video-captions-reelwords/agent.md)
- [Download page](https://openagent3.xyz/downloads/video-captions-reelwords)