安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install kaka-cardcrafter
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 kaka-cardcrafter。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Kaka AI CardCrafter 将 AI 编码代理连接到 Kaka Open Platform，以创建三种视觉内容：带有标题、正文和 3–15 个带插图页面的小红书风格帖子；多种平台格式的封面；以及从文本生成的知识卡片。此 Openclaw Skills 集成支持远程 MCP 工具或 REST API，具有异步生成、状态轮询和页面级重新生成功能。
对于帖子图形，默认工作流让用户有机会在图像生成开始之前审查并修改大纲。封面和卡片作为一步生成任务提交。结果与记录关联，可以在 Kaka Web 平台上查看。生成按能量计费，失败的生成将根据技能文档自动退款。

应用场景

根据主题草拟小红书帖子，审查其标题、正文和逐页图像描述，然后在批准后生成插画。
在单个请求中为一个或多个支持的社交和发布平台创建封面。
将提供的文本转换为选定视觉样式和宽高比的一组知识卡片。
当异步作业返回部分结果时重新生成特定页面。
在创建内容之前检查账户能量余额并检索可用样式或封面平台规范。
使用 Openclaw Skills 通过远程 MCP 或 REST 将内容创作工作流连接到 Kaka。

工作原理

确认 KAKA_API_KEY 已配置且以 kc- 开头。如果它丢失或 API 请求返回 401，请停止并引导用户创建密钥，而不是重试。
将请求路由到适当的场景：病毒式帖子图形、平台封面或知识卡片。如果用户想要选择样式，请列出该场景的样式；对于封面，检索可用的平台规范。
对于帖子图形，默认情况下提交没有 auto 的大纲请求。以 Markdown 形式呈现返回的标题、正文和页面描述，以便用户进行审查。
通过更新记录的完整 pages 数组来应用请求的大纲更改。此大纲编辑不消耗能量。仅在用户确认后生成图像，除非他们明确请求使用 auto: true 立即生成。
对于封面和卡片，直接提交选定的规范和内容；这些工作流没有大纲后审查阶段。
图像生成后每 15–30 秒轮询一次 GET /records/:record_id，直到状态为 completed、partial 或 error。作业通常需要 2–5 分钟。
将完成的图像 URL 作为 Markdown 图像列表呈现。对于 partial 结果，识别失败的页面并询问是否单独重新生成它们，然后轮询生成的作业。

配置指南

在 Kaka 账户中创建 API 密钥：打开 https://card.bingotech2022.com，登录，访问 API 访问页面，然后生成密钥。kc- 密钥仅显示一次。
设置所需的环境变量，如果需要，覆盖默认的 API 基础 URL：
export KAKA_API_KEY=kc-your-copied-key

可选；默认为 https://api.cardcrafter.cn

export KAKA_BASE_URL=https://api.cardcrafter.cn
选择连接方法。如果远程 MCP 可用，请在 https://api.cardcrafter.cn/mcp 配置 MCP 服务器，并使用 Authorization: Bearer $KAKA_API_KEY。其工具对应于 REST 操作，包括账户/样式查找、生成和记录检索。WorkBuddy 设置指南可在 https://www.cardcrafter.cn/platforms/workbuddy 获取。
否则，在 ${KAKA_BASE_URL:-https://api.cardcrafter.cn}/openapi/v1 调用 REST API，在每个请求上发送 Authorization: Bearer $KAKA_API_KEY。使用以下命令检查账户和能量余额：
curl -sS "${KAKA_BASE_URL:-https://api.cardcrafter.cn}/openapi/v1/me" \ -H "Authorization: Bearer $KAKA_API_KEY" 在创建封面之前，检索 /covers/platforms 以选择有效的平台标识符。对于样式选择，视情况使用 /styles?scene=viral、/styles?scene=cover 或 /styles?scene=card。卡片生成需要 style_id。
对于用 curl 发出的同步大纲请求，设置 --max-time 300；大纲操作可能需要几分钟。图像生成是异步的，需要记录轮询。

数据架构

每个内容创建作业由单个 record 表示，并通过 GET /openapi/v1/records/{record_id} 检索。
场景 REST 端点 关键输入 输出
病毒式帖子图形 /viral/outlines, /viral/outlines/{record_id}, /viral/images 必需的 topic；可选的 style、page_count (3–15)、参考 image_urls (1–4)、auto 和 callback_url 3:4 格式的标题、正文和 3–15 个带插图的页面
平台封面 /covers/platforms, /covers 必需的 title 和 1–5 个有效的 platforms；可选的 subtitle 和 style_type 请求的平台格式的封面，例如 2.35:1、3:4 或 9:16
知识卡片 /cards 必需的源 text 和 style_id；可选的 ratio（9:16、3:4 或 1:1；默认 9:16） 经服务精炼并渲染为多页卡片的文本
记录公开了诸如 draft、generating_outline、generating_images、completed、partial 或 error 的 status。它们的 pages[] 数据可以包含指向持久 OSS 托管图像的 image_url 值。单页重新生成是异步的，使用 /viral/images/regenerate、/covers/regenerate 或 /cards/regenerate，带有 record_id 和页面索引；重新生成请求也可以接受反馈。
大纲编辑替换完整的 pages 数组且不扣除能量。生成按请求或图像消耗能量；失败的生成会自动退款，并且记录也可在 Kaka Web 平台上看到。非 2xx 响应使用带有 code 和 message 的错误对象。

高级特性

远程 MCP 支持提供对应于 REST 操作的工具，包括账户查找、样式列表、生成和记录检索。
优先审查的帖子创建将大纲生成与图像生成分开；用户可以在生成前请求修改，且大纲更新不消耗能量。
异步记录轮询支持长时间运行的图像作业，具有完成、部分和失败生成的终端状态。
页面级重新生成针对失败或不需要的输出，而无需用户重新创建整个多页集。
封面生成每个请求支持 1–5 个平台规范，而知识卡片提供 9:16、3:4 和 1:1 的比例。
错误处理区分无效凭据 (401)、能量不足 (402)、无效记录 (403/404)、活动或完成的作业 (409)、无效参数 (422)、配额或速率限制 (429) 以及服务错误 (5xx)。401 需要用户设置而不是重复重试。
样式和平台发现端点帮助代理呈现有效选择而不是猜测标识符。如果未请求样式，请在支持的地方使用服务默认值。

name: kaka-cardcrafter description: 生成小红书爆款图文（标题+正文+多页配图）、公众号/平台多规格封面、知识卡片。分步创作、逐页出图、单页重生，通过卡咔开放平台远程 MCP 或 REST API 完成。 version: 1.0.0