# Openclaw Integration

> Connect agents and workflows to Genfeed.ai through MCP or CLI for content generation, publishing, and platform tool access. Triggers on Genfeed MCP, OpenClaw, platform connection, content generation through Genfeed, and publishing via Genfeed.

- Skill: `genfeedai/openclaw-integration` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add genfeedai/openclaw-integration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/genfeedai/openclaw-integration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: genfeedai (https://skillmd.com/u/genfeedai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/genfeedai/openclaw-integration

---


# OpenClaw Integration

You are an expert at connecting AI agents to the Genfeed.ai content creation platform via its MCP server. Help users configure their MCP client, authenticate, and use all available tools.

## Quick Start

Connect to the Genfeed MCP server using Streamable HTTP transport:

```json
{
  "mcpServers": {
    "genfeed": {
      "type": "streamable-http",
      "url": "https://mcp.genfeed.ai/mcp",
      "headers": {
        "Authorization": "Bearer gf_live_YOUR_API_KEY"
      }
    }
  }
}
```

That's it. Once connected, your agent can create videos, images, articles, avatars, music, and publish content across social platforms.

## Authentication

### Getting an API Key

1. Go to [app.genfeed.ai/settings/api-keys](https://app.genfeed.ai/settings/api-keys)
2. Click **Create API Key**
3. Copy the key (format: `gf_live_xxx`)
4. Store it securely -- it is shown only once

### Using the API Key

Pass the API key as a Bearer token in the `Authorization` header:

```
Authorization: Bearer gf_live_xxx
```

### Key Scopes

| Scope | Permissions |
|-------|-------------|
| `content:read` | List and retrieve content |
| `content:write` | Create and modify content |
| `publish` | Publish to social platforms |
| `analytics:read` | View analytics data |
| `workflows` | Create and execute workflows |
| `billing:read` | Check credits and usage |

## Available Tools

### Video

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_video` | Generate an AI video | `title`, `description` | `style`, `duration`, `voiceOver` |
| `get_video_status` | Check video generation progress | `videoId` | |
| `list_videos` | List all videos | | `limit`, `offset` |
| `get_video_analytics` | Get video performance metrics | `videoId` | `timeRange` |

### Articles

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_article` | Generate an AI article | `topic` | `tone`, `length`, `targetAudience`, `keywords` |
| `search_articles` | Search existing articles | `query` | `category`, `limit` |
| `get_article` | Retrieve a single article | `articleId` | |

### Images

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_image` | Generate an AI image | `prompt` | `style`, `size`, `quality` |
| `list_images` | List all images | | `limit`, `offset` |

### Avatars

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_avatar` | Create a digital avatar | `name` | `gender`, `style`, `age` |
| `list_avatars` | List all avatars | | `limit` |

### Music

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_music` | Generate AI music | `prompt` | `genre`, `mood`, `duration` |
| `list_music` | List all music tracks | | `limit` |

### Publishing

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `publish_content` | Publish to social platforms | `contentId`, `platforms` | `customMessage`, `scheduleAt` |
| `list_posts` | List published posts | | `platform`, `limit` |

### Discovery

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `get_trending_topics` | Get trending topics | | `category`, `timeframe` |
| `get_content_analytics` | Get content performance | `contentId`, `contentType` | `timeRange` |

### Billing

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `get_credits` | Check remaining credits | | |
| `get_usage_stats` | Get usage statistics | | `timeRange` |

### Workflows

| Tool | Description | Required Params | Optional Params |
|------|-------------|-----------------|-----------------|
| `create_workflow` | Create an automation workflow | `name` | `description`, `templateId`, `schedule` |
| `execute_workflow` | Run a workflow | `workflowId` | `variables` |
| `get_workflow_status` | Check workflow execution status | `workflowId` | |
| `list_workflows` | List all workflows | | `status`, `limit` |
| `list_workflow_templates` | List available templates | | |

## CLI Alternative

For terminal-based workflows, use the Genfeed CLI:

```bash
genfeed generate image "A sunset over mountains" --json
genfeed generate video "Product Demo" --no-wait
genfeed status <id> --json
genfeed publish <contentId> --platforms instagram,twitter
```

Flags:

- `--json` -- Output structured JSON (useful for piping to other tools)
- `--no-wait` -- Return immediately without waiting for generation to complete

## Common Workflows

### Image Generation

```
1. create_image({ prompt: "Product hero shot, studio lighting, 8K" })
2. list_images() -- verify it appears
3. publish_content({ contentId: "<imageId>", platforms: ["instagram"] })
```

### Video Creation

```
1. create_video({ title: "Product Launch", description: "60s cinematic intro" })
2. get_video_status({ videoId: "<videoId>" }) -- poll until complete
3. get_video_analytics({ videoId: "<videoId>" })
```

### Content Pipeline

```
1. get_trending_topics({ category: "tech" })
2. create_article({ topic: "<trending topic>", tone: "professional" })
3. create_image({ prompt: "<article hero image>" })
4. publish_content({ contentId: "<articleId>", platforms: ["twitter", "linkedin"] })
```

### Publish to Social

```
1. list_videos({ limit: 5 }) -- find content to publish
2. publish_content({
     contentId: "<videoId>",
     platforms: ["youtube", "tiktok", "instagram"],
     customMessage: "Check out our latest creation!",
     scheduleAt: "2026-03-01T10:00:00Z"
   })
3. list_posts({ platform: "youtube" }) -- verify publication
```

### Workflow Automation

```
1. list_workflow_templates() -- browse available templates
2. create_workflow({
     name: "Daily Content",
     templateId: "<templateId>",
     schedule: "0 9 * * *"
   })
3. execute_workflow({ workflowId: "<workflowId>" })
4. get_workflow_status({ workflowId: "<workflowId>" })
```

## Error Handling

### Credit Exhaustion

```json
{
  "error": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits. Required: 10, Available: 3",
  "creditsRequired": 10,
  "creditsAvailable": 3
}
```

**Resolution:** Check balance with `get_credits()`, then top up at [app.genfeed.ai/settings/billing](https://app.genfeed.ai/settings/billing).

### Rate Limits

```json
{
  "error": "RATE_LIMITED",
  "message": "Too many requests. Retry after 30 seconds.",
  "retryAfter": 30
}
```

**Resolution:** Wait the specified `retryAfter` seconds before retrying. Default limits: 60 requests/minute.

### Authentication Errors

```json
{
  "error": "UNAUTHORIZED",
  "message": "Invalid or expired API key"
}
```

**Resolution:** Verify the API key at [app.genfeed.ai/settings/api-keys](https://app.genfeed.ai/settings/api-keys). Ensure the key has the required scopes for the operation.

### Generation Failures

```json
{
  "error": "GENERATION_FAILED",
  "message": "Content generation failed",
  "reason": "Content policy violation"
}
```

**Resolution:** Review the prompt for policy violations. Adjust content and retry.

## Instructions

When helping users connect to Genfeed:

1. **Check their MCP client** -- Ensure it supports Streamable HTTP transport
2. **Provide the config** -- Give them the JSON config block with their API key placeholder
3. **Verify connection** -- Suggest calling `get_credits()` as a health check
4. **Guide tool usage** -- Start with simple operations (create_image) before complex workflows
5. **Handle errors** -- Reference the error handling section for common issues