openclaw-integration

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenClaw Integration

OpenClaw集成

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.

您是通过MCP服务器将AI Agent连接到Genfeed.ai内容创作平台的专家。请帮助用户配置MCP客户端、完成身份验证并使用所有可用工具。

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.

使用Streamable HTTP传输连接至Genfeed MCP服务器：

json

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

配置完成后，您的Agent即可创建视频、图片、文章、数字分身、音乐，并将内容发布至各大社交平台。

Authentication

身份验证

Getting an API Key

获取API Key

Go to app.genfeed.ai/settings/api-keys
Click Create API Key
Copy the key (format:
```
gf_live_xxx
```
)
Store it securely -- it is shown only once

访问app.genfeed.ai/settings/api-keys
点击Create API Key
复制密钥（格式：
```
gf_live_xxx
```
）
安全存储——密钥仅显示一次

Using the API Key

使用API Key

Pass the API key as a Bearer token in the

Authorization

header:

Authorization: Bearer gf_live_xxx

在

Authorization

请求头中以Bearer令牌形式传入API Key：

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

权限范围	权限说明
`content:read`	列出和获取内容
`content:write`	创建和修改内容
`publish`	发布至社交平台
`analytics:read`	查看分析数据
`workflows`	创建和执行工作流
`billing:read`	查看余额和使用情况

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`

工具	说明	必填参数	可选参数
`create_video`	生成AI视频	`title` , `description`	`style` , `duration` , `voiceOver`
`get_video_status`	查看视频生成进度	`videoId`
`list_videos`	列出所有视频		`limit` , `offset`
`get_video_analytics`	获取视频性能指标	`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`

工具	说明	必填参数	可选参数
`create_article`	生成AI文章	`topic`	`tone` , `length` , `targetAudience` , `keywords`
`search_articles`	搜索现有文章	`query`	`category` , `limit`
`get_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`

工具	说明	必填参数	可选参数
`create_image`	生成AI图片	`prompt`	`style` , `size` , `quality`
`list_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`

工具	说明	必填参数	可选参数
`create_avatar`	创建数字分身	`name`	`gender` , `style` , `age`
`list_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`

工具	说明	必填参数	可选参数
`create_music`	生成AI音乐	`prompt`	`genre` , `mood` , `duration`
`list_music`	列出所有音乐曲目		`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`

工具	说明	必填参数	可选参数
`publish_content`	发布至社交平台	`contentId` , `platforms`	`customMessage` , `scheduleAt`
`list_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`

工具	说明	必填参数	可选参数
`get_trending_topics`	获取热门话题		`category` , `timeframe`
`get_content_analytics`	获取内容表现数据	`contentId` , `contentType`	`timeRange`

Billing

计费工具

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

工具	说明	必填参数	可选参数
`get_credits`	查看剩余余额
`get_usage_stats`	获取使用统计数据		`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

工具	说明	必填参数	可选参数
`create_workflow`	创建自动化工作流	`name`	`description` , `templateId` , `schedule`
`execute_workflow`	运行工作流	`workflowId`	`variables`
`get_workflow_status`	查看工作流执行状态	`workflowId`
`list_workflows`	列出所有工作流		`status` , `limit`
`list_workflow_templates`	列出可用模板

CLI Alternative

CLI替代方案

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

对于终端工作流，可使用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

可选参数：

```
--json
```
-- 输出结构化JSON（便于传递给其他工具）
```
--no-wait
```
-- 立即返回，无需等待生成完成

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"] })

1. create_image({ prompt: "Product hero shot, studio lighting, 8K" })
2. list_images() -- 验证图片已生成
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>" })

1. create_video({ title: "Product Launch", description: "60s cinematic intro" })
2. get_video_status({ videoId: "<videoId>" }) -- 轮询直至生成完成
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"] })

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

1. list_videos({ limit: 5 }) -- 选择要发布的内容
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" }) -- 验证发布状态

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>" })

1. list_workflow_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.

json

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

解决方法： 使用

get_credits()

查看余额，然后前往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.

json

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

解决方法： 等待指定的

retryAfter

秒后重试。默认限制：60次请求/分钟。

Authentication Errors

身份验证错误

json

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

json

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

解决方法： 前往app.genfeed.ai/settings/api-keys验证API Key。确保密钥拥有操作所需的权限范围。

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.

json

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

解决方法： 检查提示词是否违反内容政策，调整后重试。

Instructions

操作指南

When helping users connect to Genfeed:

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

帮助用户连接Genfeed时，请遵循以下步骤：

检查MCP客户端——确保其支持Streamable HTTP传输
提供配置文件——提供包含API Key占位符的JSON配置块
验证连接——建议调用
```
get_credits()
```
作为健康检查
指导工具使用——先从简单操作（如create_image）开始，再尝试复杂工作流
处理错误——参考错误处理部分解决常见问题