训练专属数字人,生成播报视频。
Changing OpenClaw 技能
功能概述
Changing OpenClaw 技能是一项面向实际任务的技能,主要用于当 OpenClaw 使用此技能时, 应该使用此技术的平台 API , 而不是直接给 Changing 打电话;在使用脚本前读取这些引用 :. 引用/ set。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Chanjing OpenClaw 技能
当 OpenClaw 应调用本项目的平台 API,而非直接调用 Chanjing 时,请使用此技能。
使用脚本前,请先阅读以下参考文档:
- references/setup.md
- references/platform-api.md
环境变量
推荐设置:
CHANJING_PLATFORM_API_TOKEN
可选设置:
CHANJING_PLATFORM_BASE_URL
向后兼容的备用方案:
CHANJING_PLATFORM_API_KEYCHANJING_PLATFORM_API_SECRET
重要说明:
- 获取平台 token 时,务必引导用户访问
http://easyclaw.bar/shuziren/user/ - 切勿告知用户通过打开
http://easyclaw.bar/shuzirenapi获取 token CHANJING_PLATFORM_BASE_URL为可选参数,默认值为http://easyclaw.bar/shuzirenapi- 该平台 token 由本平台签发,而非由 Chanjing 的
app_id / secret_key签发
支持的操作
- 列出公开数字人
- 列出公开语音
- 列出字幕字体
- 列出我的数字人
- 列出我的语音
- 训练数字人
- 训练语音
- 合成口播视频(talking-head video)
- 查询任务详情
- 当
openclaw cron可用时,通过 OpenClaw 定时任务(cron jobs)自动监听异步任务完成状态 - 同步查询任务详情
重要规则
- 所有操作仅允许执行
scripts/目录下提供的 Python 入口脚本。 - 禁止手写 HTTP 请求、探测无关端点,或在模型中直接调用平台路由(如
/api/me、/api/me/*、鉴权相关路由,以及任何非 OpenClaw 路由)。 - 若所需能力未被
scripts/下任一现有脚本暴露,请立即中止,并先更新或新增对应脚本,不得临时构造直接 API 调用。 - 优先使用
scripts/下的脚本,而非手写 HTTP 请求。 - 若用户询问如何获取 token 或密钥,请指引其访问
http://easyclaw.bar/shuziren/user/。 - 监听器(watcher)采用 OpenClaw
cron的isolated模式运行;任务未完成期间返回NO_REPLY,用户仅在任务完成或失败时收到通知。 - 对于
train_digital_human.py、train_voice.py和synthesize_talking_video.py,命令中严禁添加--no-watch-task参数。 - 异步创建类脚本必须在同一命令执行过程中完成监听器创建,不可在提交任务后即终止。
- 异步创建类脚本会保持 Python 进程活跃,并持续轮询任务状态直至完成或超时,从而确保 OpenClaw 自身的后台轮询机制可捕获最终结果。
schedule_task_watch.py当前优先使用原生 EasyClaw/OpenClaw CLI 形式cron create --thread(如可用),仅对旧版客户端降级回退至传统cron add命令。- 除非监听器创建成功并返回非空的 cron
job_id,否则不得视创建脚本执行完毕。 - 禁止将
get_task.py --sync用作定时通知的替代方案。get_task.py --sync仅适用于一次性手动状态查询。 - 若监听器创建成功并返回
job_id,请明确告知用户任务已入队,将在完成后主动通知。 - 若监听器创建失败或未返回
job_id,请告知用户任务提交成功,但自动通知机制未启用。 - 一旦平台已接受某用户意图对应的任务 ID,则严禁对该意图重复调用创建接口。
- 对于“先撰写文案再生成视频”类请求,需先完成文案草稿,然后**仅提交一次**视频合成请求,并传入该最终文案。
- 视频提交后,须原样回显用于合成的最终文案全文,不得改写、缩略或截断。
- 仅当监听器命令实际返回非空
job_id后,方可承诺将主动通知用户。 - 视频合成时,仅提供必需字段;除非用户明确要求高级控制,否则不传可选字段。
- 无需的可选字段应完全省略,以便平台 API 在提交至 Chanjing 前应用其自身默认值。
- AI 合规水印默认关闭。除非用户明确要求添加水印,否则不得发送
add_compliance_watermark或compliance_watermark_position字段。 - 使用 TTS 驱动已训练数字人时,
voice_id为可选字段;平台 API 可根据数字人的audio_man_id自动解析绑定的语音。 - 若用户需要字幕字体,请先查询字体列表,并将所选字体的
id作为subtitle_font_type传入。 - 若启用字幕但未指定
subtitle_font_type,平台在可用时默认使用思源宋体 CN。 - 若启用字幕但未指定
subtitle_border_width,平台默认值为2。 - 字幕相关字段在平台 API 中统一以
subtitle_*形式存在,后端会将其映射至 Chanjing 上游字段,如font_id、color、stroke_color、stroke_width和subtitles。 - 若技能中未显式配置字幕设置,仍应默认启用字幕,使平台 API 默认逻辑生效。
响应格式规范
- 若脚本输出中包含图片 URL,请在最终回答中以内联方式渲染图片,而非仅用文字描述。
- 优先使用
_openclaw_media字段;若不存在,则依次回退至原始字段:如cover_url、preview_image_url、avatar_url、image_url、poster_url、thumbnail_url、thumb_url、pic_url。 - 使用 Markdown 图片语法渲染:
。 - 若脚本输出中包含视频 URL(如
video_url或preview_url),请显著展示该直链 URL,并在可用时同时内联渲染封面图。 - 列举多个资源时,文字摘要应简洁,且对最相关的 1 至 3 项资源以内联方式渲染媒体内容,不得完全省略媒体。
- 当存在媒体 URL 时,禁止仅以“我找到了以下数字人”等表述作答;媒体本身必须在响应中直接呈现。
- 对于
scripts/train_digital_human.py、scripts/train_voice.py和scripts/synthesize_talking_video.py,优先解析顶层submission对象。submission.watch_command仅用于可观测性;脚本应在退出前已完成监听器创建。
强制异步工作流
针对数字人训练、语音训练及口播视频合成操作:
- 执行
scripts/目录下对应的脚本。 - 由脚本完成任务提交、监听器创建,并在同一个 Python 进程内持续轮询状态。
- 从脚本最终输出中读取
submission.task_id、submission.watcher_status和submission.watcher_job_id。 - 若
completion.finished为 true,优先采用本次运行中返回的已完成结果。 - 仅当
submission.watcher_status为scheduled且submission.watcher_job_id非空时,方可告知用户已为超时场景启用自动通知。
不得在未确认 cron job_id 的前提下擅自承诺通知。
必需字段
训练数字人
必需字段:
nametraining_video_file_id
可选字段:
callback_urlerror_skipextra_payload
训练语音
必需字段:
nametraining_audio_url
可选字段:
callback_urlextra_payload
合成口播视频
始终必需字段:
titledigital_human_id
音频源(三选一):
- TTS 模式:提供
script - 音频文件模式:提供
audio_file、audio_file_id或audio_url中的任意一个
通用可选字段:
voice_idbackground_filebackground_file_idbackground_urlvideo_widthvideo_heightcallback_urlextra_payload
字幕相关可选字段:
subtitle_showsubtitle_font_typesubtitle_font_sizesubtitle_font_colorsubtitle_border_colorsubtitle_border_widthsubtitle_xsubtitle_ysubtitle_widthsubtitle_heightsubtitle_asr_typesubtitle_items_json
渲染相关可选字段:
modelresolution_rateadd_compliance_watermarkcompliance_watermark_position
脚本列表
scripts/list_public_digital_humans.pyscripts/list_public_voices.pyscripts/list_fonts.pyscripts/list_my_digital_humans.pyscripts/list_my_voices.pyscripts/train_digital_human.pyscripts/train_voice.pyscripts/synthesize_talking_video.pyscripts/get_task.pyscripts/schedule_task_watch.pyscripts/cron_watch_task.py
示例
列出字体:
python "{baseDir}/scripts/list_fonts.py"
训练数字人:
python "{baseDir}/scripts/train_digital_human.py" --name "Brand Host" --video-file-id "file_xxx"
仅使用必需字段进行 TTS 模式合成:
python "{baseDir}/scripts/synthesize_talking_video.py" --title "Demo" --digital-human-id "human_xxx" --script "hello"
指定字幕字体合成:
python "{baseDir}/scripts/synthesize_talking_video.py" --title "Demo" --digital-human-id "human_xxx" --script "hello" --subtitle-show --subtitle-font-type "103"
使用本地音频文件合成:
python "{baseDir}/scripts/synthesize_talking_video.py" --title "Demo" --digital-human-id "human_xxx" --audio-file "C:\path\audio.wav"
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习
最新文章