Kling AI Plugin MCP (China)

Official China-region image/video generation, references and task tracking. OAuth; generation consumes credits. China/Global accounts, credits and tasks are separate.

GitHub

ホスト型 MCP サーバー

npx add-mcp 'https://klingai.com/mcp/plugin'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Kling AI for OpenClaw

在 OpenClaw 里使用可灵 AI 生成图片和视频。

插件通过 OAuth 连接可灵官方远程 MCP，不需要 API Key，也不会在本地启动 MCP Server。

功能

  • 文生图、参考图编辑、变体和连续组图（需所选模型支持）
  • 文生视频、图生视频、全能参考、关键帧、动作控制和多镜头视频
  • 上传参考素材，管理 Element 和动作库
  • 查询账号、额度、任务状态和生成结果
  • 提交生成任务前展示最终参数和额度提示，确认后只提交一次

可灵 4.0 与可灵 4.0 Flash

  • 可灵 4.0（V4） 支持文生视频、首帧／尾帧／中间关键帧图生视频，以及组合图片、视频、音频和 Element 主体的全能参考。支持 3–30 秒、720p，符合权限的账号可选 1080p。
  • 可灵 4.0 Flash（V4 Flash） 面向快速出片，支持文生视频、单张首帧图生视频，以及组合图片、视频和 Element 主体的全能参考。支持 3–20 秒、720p。
  • 两款模型的全能参考均支持智能分镜、生成同步声音或保留参考视频原声。两种输出声音设置互斥。需要独立音频参考时，选择声明音频输入的可灵 4.0 全能参考。

未指定模型时，优先推荐当前账号可用且符合需求的可灵 4.0 全能参考。速度或成本优先时，可选兼容的 Flash。即使是纯文本请求，插件也会同时检查传统视频入口和 omni_ref_video。点名模型时按当前账号返回的完整型号匹配，规格、素材组合和计费以实时模型定义为准。

国内 ClawHub 页面。

安装

需要 OpenClaw 2026.9.4 或兼容版本。

openclaw plugins install clawhub:kling-ai-openclaw

安装后检查插件状态：

openclaw plugins inspect kling-ai --json

如果正在运行的 Gateway 没有自动加载插件，重启一次：

openclaw gateway restart

开启交互 UI（MCP Apps）

插件安装本身不会开启 OpenClaw 的全局 MCP Apps 开关。要在 Control UI 显示可灵交互卡片，安装后执行：

openclaw config set mcp.apps.enabled true --strict-json
openclaw gateway restart
openclaw config get mcp.apps.enabled

该开关允许已配置 MCP 服务提供交互 HTML，重启会短暂中断 Gateway。返回 true 只证明配置已开启，仍需在页面验证 App 实际显示。可让 Agent 按本包 Skill 完成检查与设置；安装或发现 Skill 不会自动执行这些命令。

通过反向代理访问时，App 还需要独立来源与沙箱端口代理：默认 Gateway 为 18789，App 为 18790。按官方 MCP Apps 配置设置 mcp.apps.sandboxOrigin，不要把 App 与 Control UI 配成同源。消息渠道不保证内嵌 UI。

旧版宿主可先运行 openclaw update，再用 openclaw --version 核对。2026-10-24 查阅的当前稳定版为 2026.10.6；该版要求 Node 24.22.1+ 或 26.12.1+，遵循官方更新器提示。本包最低兼容基线仍为 2026.9.4，尚未完成 2026.10.6 真实 UI 验收，不保证升级即可修复。

只有原始工具文本时，检查开关、代理和会话调用路径；MCP 探测成功不等于 UI 已挂载。已提交任务保留任务编号，不要为了修 UI 重新生成。

登录

首次使用时先把国内 MCP 注册到 OpenClaw。OpenClaw 2026.9.4 的 mcp login 从操作员管理的 MCP 配置中读取登录目标：

openclaw mcp add kling-ai \
  --url https://klingai.com/mcp/plugin \
  --transport streamable-http \
  --auth oauth \
  --header X-Kling-Integration=Plugin-OpenClaw \
  --connect-timeout 30 \
  --timeout 60 \
  --no-probe

然后登录：

openclaw mcp login kling-ai

按终端提示在浏览器完成可灵登录和授权。凭据由 OpenClaw 保存和刷新，插件不会读取或保存 token。

需要自动打开浏览器时，在已安装插件的目录运行：

npm run login

包内登录助手会调用同一个 OpenClaw 登录流程，并自动打开国内可灵授权页；授权回调和凭据仍由 OpenClaw 管理。直接运行 openclaw mcp login kling-ai 时，宿主只打印授权网址；网址是否可点击、是否显示下划线由终端决定。自动打开失败时，按提示改用原生命令并复制链接到浏览器。

确认连接：

openclaw mcp doctor kling-ai --probe

正常情况下会返回 kling-ai: ok。

使用

安装并登录后，直接在 OpenClaw 会话里描述需求。

推荐提示词

  • 用可灵一次生成 3 张连续组图。让同一只身穿复古宇航服的小熊猫依次从空间站出舱、掠过舷窗、转身望向蓝色地球
  • 使用可灵 4.0 生成一段 20 秒电影感视频：机甲战士从高空重砸地面，冲击波瞬间震开碎石与尘雾，镜头快速推近，充满力量感
  • 使用可灵 4.0 Flash，把我提供的运动鞋商品图作为首帧，生成一段 20 秒、720p 的视频，镜头缓慢绕过鞋身，最后停在鞋面细节上
  • 使用可灵AI查看动作库，预览已保存的动作；选定后，用可用的动作控制模型将该动作应用到我提供的主体图片生成视频
  • 使用可灵AI将我提供的角色正面图和侧面图保存为第一个可复用主体，命名为“小白”，方便后续创作时保持角色一致

未指定图片模型时，优先使用当前入口返回且满足需求的默认模型。

提交前，插件会列出模型、尺寸或分辨率、时长、数量等最终参数，并说明会消耗可灵额度。收到明确确认后才会创建任务。

灵感值不足时，使用当前连接提供的官方充值入口，或在国内可灵官网登录同一账号充值。充值后回到当前会话说「继续刚才的任务」。OpenClaw 会先处理已有任务，只有可以新提交时才核对余额并恢复原设置。

查询已有任务时提供 generationId：

查询任务 <generationId> 的状态，不要重新提交。

更新

openclaw plugins update kling-ai

更新后如有需要，重启 Gateway 并开启新会话。

账号与区域

本插件使用国内可灵服务：

https://klingai.com/mcp/plugin

国内和海外账号的额度及任务不互通。切换账号时先退出，再重新登录：

openclaw mcp logout kling-ai
openclaw mcp login kling-ai

名称与下划线

OpenClaw 的 MCP 注册名与代码模式调用名不同：注册名可以保留 kling-ai__text_to_image，代码模式会把不合法的 JavaScript 标识符字符转换为下划线，例如服务标识可能显示为 kling_ai。调用时以当前会话的工具或命名空间声明为准，不要固定拼接前缀。

这个转换不适用于安装和配置：MCP 服务键仍为 kling-ai，插件 ID、Skill 名和包名保持本包原有拼写。不要把 openclaw mcp login kling-ai 改成下划线形式。

依据：MCP 工具命名、代码模式命名。

常用排查

openclaw plugins inspect kling-ai --json
openclaw mcp status --verbose
openclaw mcp doctor kling-ai --probe

如果工具列表没有刷新：

openclaw mcp reload

如果 mcp login 报错 No MCP server named "kling-ai"，先执行登录中的注册命令，再重新登录。

然后开启新会话。任务提交超时或结果不明确时，使用原 generationId 查询任务。没有任务编号时，保留 taskTraceId 并将提交状态标为待确认。

本地开发

git clone https://github.com/klingai-dev/openclaw-plugin.git
cd openclaw-plugin
npm test
npm run pack:release

从本地 ZIP 安装：

openclaw plugins install --force --accept-capabilities ./dist/kling-ai-openclaw-1.1.27.zip

兼容性和验收范围见 docs/COMPATIBILITY.md。

License

MIT