Install
openclaw skills install @laozhangai/datu-ai-poster-generatoropenclaw skills install @laozhangai/datu-ai-poster-generator当用户提到以下任一意图时,应优先使用本技能:
把文本、文档或已有图片转换为高质量信息海报,并支持继续修图。
当前能力包括:
16:9、21:9、4:3、1:1、3:4、9:16、9:21、1:3、3:14kmagic_wand、deep_research 或 magic_think。当用户提供或指向一张已有图片、海报、生成结果、截图、二维码、logo 或上一轮任务结果,并提出以下任一修改意图时,必须调用 POST /api/edit/create:
这种情况下不要调用 /api/datu/create,也不要调用 /api/datu/create-from-file 重新生成一张新图。
路由字段:
imageannotated_imageref_imagespromptparent_task_id只有当用户明确要求“解析这张图/截图里的内容,再生成一张新的大图/海报”时,图片才作为内容素材进入大图生成流程。
对于大图生成,外层代理必须遵守以下规则:
magic_wand=true 时,敏感信息检查通过后,不要先做摘要、提炼、压缩、重写或“整理版 Prompt”deep_research=true 只能在用户明确选择或确认后启用;深度研究会全网深度抓取并分析,通常需要额外 5-15 分钟,并额外消耗 5 积分research_report_download_url 时下载或提供深度研究报告文件magic_wand 都已明确,就直接创建任务,不要额外输出“整理后的执行方案”让用户确认magic_wand=false 时也不要改写用户输入,应直接传递用户给出的原始信息所有文本、文件、图片 URL 或参考图在提交到 https://datu.digilifeform.com 前,都应先做一次轻量敏感信息检查。以下内容如果明显出现,不应跳过确认上传到外部服务,而应先提醒并获得用户明确授权:
说明:
接口:
POST /api/datu/create
请求体:
{
"text": "用户提供的完整信息",
"aspect_ratio": "16:9",
"resolution": "4k",
"magic_wand": true,
"deep_research": false
}
字段说明:
text: 必填,最短支持 2 个字符aspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1resolution: 4kmagic_wand: 默认 truedeep_research: 默认 false。只能在用户明确选择或确认后设为 true。设为 true 时,Datu 会先进行全网深度抓取与分析,再生成大图;这会额外增加约 5-15 分钟,并额外消耗 5 积分注意:
magic_wand=true 不等于外层代理先提炼资料deep_research=true 会强制使用 magic_wand=truedeep_research=true 只能在用户明确选择或确认后启用深度研究请求示例:
{
"text": "请基于以下完整资料先做全网深度研究,再生成一张行业趋势信息海报:......",
"aspect_ratio": "16:9",
"resolution": "4k",
"magic_wand": true,
"deep_research": true
}
接口:
POST /api/datu/create-from-file
请求格式:multipart/form-data
字段:
fileaspect_ratioresolutionmagic_wanddeep_research支持上传:
pdfdocdocxtxtmdmarkdownpngjpgjpegwebpgif限制:
20MBdeep_research=true 时同样提交原始文件,由 Datu 内部解析、研究、整理和生成接口:
POST /api/edit/create
请求体:
{
"image": "https://cdn.example.com/original.png",
"annotated_image": "",
"ref_images": [],
"prompt": "把顶部主标题做得更醒目,整体改成深蓝金科技风",
"magic_think": true,
"aspect_ratio": "9:16",
"resolution": "4k",
"parent_task_id": null
}
字段说明:
image: 必填,原图 URLannotated_image: 可选,标注图 URLref_images: 可选,最多 4 张prompt: 必填,最短 2 个字符magic_think: 默认 trueaspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1resolution: 4k说明:当前版本已取消新建 8K 任务,不要再传 resolution=8k。
大图状态:
GET /api/datu/status/{task_id}
如果用户选择深度研究,状态或任务详情中可能包含:
{
"image_url": "https://cdn.example.com/datu/final.png",
"download_url": "/api/tasks/DT1234567890/download",
"research_report_download_url": "/api/tasks/DT1234567890/research-report-link"
}
遇到 research_report_download_url 时,应再请求:
GET /api/tasks/{task_id}/research-report-link
返回值中的 download_url 是短期有效的 Word .docx 报告下载地址。执行时应下载深度研究报告。最终回复用户时,如果用户选择深度研究,应同时给出图片结果和研究报告文件;报告文件建议命名为 research-report-{task_id}.docx。
修图状态:
GET /api/edit/status/{task_id}
本技能需要一个用户自行创建并控制的 Datu API Key。推荐在运行环境中配置:
DATU_API_KEY=your_api_key_here
宿主凭据要求:
DATU_API_KEY 持久凭据X-API-Key 发送DATU_API_KEY,应优先提示用户检查宿主的凭据/密钥库/技能授权设置,而不是让用户在聊天里反复粘贴 key所有请求都使用:
X-API-Key: your_api_key_here
基础地址:
https://datu.digilifeform.com
隐私提示:
https://datu.digilifeform.com 外部服务magic_wand 主流程开关,默认开启deep_research 深度研究开关;开启后结果应包含图片和 Word .docx 深度研究报告文件magic_think,与大图主开关分离9:16、9:21、1:3、3:1 已作为正式比例支持4k 生图 / 改图默认优先走新的高质量链路,失败时自动回退GET /api/skill/version推荐提醒文案:
检测到 Datu 大图技能有新版本 vX.Y.Z,建议在 ClawHub 更新后继续使用。
magic_wanddeep_researchmagic_wand错误:
用户要 Datu 大图,却改用其他生图工具直接生成
正确:
使用 /api/datu/create 或 /api/datu/create-from-file
magic_think 当成大图生成开关错误:
大图生成时发送 magic_think
正确:
大图生成用 magic_wand,修图才用 magic_think
错误:
把所有非 21:9 的请求都当成 16:9,或忽略用户明确选择的 9:16 / 9:21 / 1:3 / 3:1
正确:
保留用户明确选择的 9:16 / 9:21 / 1:3 / 3:1
错误:
用户给了一整段资料或一个文件,外层代理先整理成几条 bullet,再把这个缩写版发给 Datu
正确:
magic_wand=true 时,先做上传前安全检查;通过后不要压缩整理摘要总结用户信息,而是保真提交给大图技能
错误:
识别到文档中有密钥、身份证号或受限信息,但未提醒用户确认就提交到外部 API
正确:
先提醒风险并取得明确授权;用户不确认时停止上传或请用户提供脱敏版本
错误:
用户选择了 deep_research=true,但最终只返回图片链接,忽略 research_report_download_url
正确:
如果用户选择深度研究,任务完成后同时提供图片和 Word `.docx` 深度研究报告文件
错误:
用户之前已经提供并成功使用过 Datu API Key,但每次在飞书、微信等宿主里调用技能时仍要求重新提供
正确:
宿主收到用户提供的 key 后,应保存为 `DATU_API_KEY` 持久凭据;后续调用自动注入并通过 `X-API-Key` 发送。只有持久凭据缺失、被删除、失效或认证失败时,才提示用户重新配置。