Claude 访客：新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次，仅用于 API 用量。

OPENCLAW 指南

在 OpenClaw 中使用 RunAPI

通过 RunAPI 将 OpenClaw 连接到 250+ 个 AI 模型。只用一把 API key，就能直接从 OpenClaw agent 生成视频、图像、音乐和音频。

复制 prompt · 一把 RunAPI key · 模型目录链接

Setup prompt

Configure this OpenClaw workspace to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

{
  agents: {
    defaults: {
      model: { primary: "runapi/gpt-5.5" },
      models: {
        "runapi/gpt-5.5": { alias: "RunAPI GPT 5.5" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      runapi: {
        baseUrl: "https://runapi.ai/v1",
        apiKey: "${RUNAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.5",
            name: "RunAPI GPT 5.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.5
openclaw

OpenClaw 可用模型

HappyHorse/happyhorse-1.0-i2v

HappyHorse API 调用文生视频、图生视频和视频编辑生成，支持 720p/1080p 输出和角色参考图。

Qwen 2/qwen-2-edit-image

Qwen 2 API 调用阿里巴巴视觉模型家族的文生图和图像编辑。

Producer/fuzz-0.8

Producer API 支持根据指定歌词或纯音乐制作说明生成 FUZZ 音乐。

ElevenLabs/text-to-dialogue-v3

ElevenLabs 通过 RunAPI 提供多语言语音合成和多说话人对话生成。

Qwen/qwen3.5-122b-a10b

通过 RunAPI 调用 Qwen API：开放权重的 Qwen3.5、Qwen3.6、Qwen3-VL 和 Qwen3-Coder-Next 语言模型，使用 OpenAI 兼容的 Chat Completions。

Qwen/qwen3.5-27b

通过 RunAPI 调用 Qwen API：开放权重的 Qwen3.5、Qwen3.6、Qwen3-VL 和 Qwen3-Coder-Next 语言模型，使用 OpenAI 兼容的 Chat Completions。

工作原理

3 步完成连接

配置

将 RunAPI API 密钥添加到 OpenClaw 配置中。一个密钥即可访问所有模型。
选择模型

选择智能体可以使用的模型。按模态、质量或成本筛选。
生成

OpenClaw 智能体通过 RunAPI 的统一 API 生成媒体。结果通过 webhook 或轮询返回。

使用场景

自动化内容

让 OpenClaw 自动生成营销视频、产品图片和音频内容。

多模态工作流

在一次 agent 对话中串联视频、图片和音乐生成。

成本优化路由

OpenClaw 可以比较模型价格并选择最具成本效益的选项。

OpenClaw 配置问题

OpenClaw 可以把 RunAPI 当作自定义模型 provider 吗？

可以。OpenClaw 通过 models.providers 支持自定义 OpenAI 兼容 provider。为 RunAPI 配置 /v1 base URL，把 api 设为 openai-completions，并在 agents.defaults.model.primary 中选择带 provider 前缀的模型引用。

models.providers 里的模型 ID 要带 provider 前缀吗？

不要。在 models.providers.runapi.models 内使用 provider 内部 ID，例如 gpt-5.2。只有在 OpenClaw 默认模型或命令里选择模型时，才使用 runapi/gpt-5.2 这种带 provider 前缀的引用。

RunAPI API key 应该存在哪里？

把 key 存在 RUNAPI_API_KEY，并在 OpenClaw 配置里读取它。这样凭证不会进入版本控制，也能让同一份配置用于本地 shell、服务器和自动化环境。

还能保留现有 OpenClaw 模型作为 fallback 吗？

可以。保持 models.mode 为 merge，并把 RunAPI 作为其中一个 provider 加进去。现有 provider 仍可用；需要恢复链路时，把 fallback 放进 agents.defaults.model.fallbacks。

OpenClaw 无需安装额外技能就能通过 RunAPI 生成图片吗？

可以。为聊天配置的 RUNAPI_API_KEY 和 /v1 端点同样接受图片生成请求。指定 flux-kontext-pro 或 imagen-4 等模型，OpenClaw 即可通过现有 RunAPI 提供商调用，无需 GitHub 技能或独立 API 密钥。完整指南请参阅 OpenClaw 图片生成页面。

OpenClaw 智能体如何知道图片或视频任务已完成？

图片、视频和音乐任务均为异步任务。RunAPI 在首次调用时返回任务 ID。OpenClaw 智能体轮询状态端点直至任务完成，然后接收输出 URL。使用 RunAPI SDK 时，轮询会自动处理。

以 agent 运行 RunAPI 的其他方式

工作流自动化

Hermes Agent

通过 Hermes 路由生成步骤，让它按任务选择模型。同一把 key、同一余额，无需额外设置。

团队助手

WorkBuddy

让共享工作区助手访问视频、图像和 LLM 模型，并为每个 key 设置消费限额。

SDK 或 MCP

自行构建

通过 RunAPI SDK 或 MCP server ——工具、轮询和 webhook 均已包含。

需要团队接入支持？

我们可以帮助你完成企业设置、集成和技术问题。

联系我们