openclaw-integration

name	openclaw-integration
description	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.
license	MIT
metadata	{"author":"genfeedai","version":"1.0.0"}

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:

{
  "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
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:

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

{
  "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.

Rate Limits

{
  "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

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

Resolution: Verify the API key at app.genfeed.ai/settings/api-keys. Ensure the key has the required scopes for the operation.

Generation Failures

{
  "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