数字人口播生成

Polar Sponsor
爱发电 赞助
.NET 9.0

训练专属数字人,生成播报视频。

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_KEY
  • CHANJING_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 图片语法渲染: ![label](url)。
  • 若脚本输出中包含视频 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 仅用于可观测性;脚本应在退出前已完成监听器创建。

强制异步工作流

针对数字人训练、语音训练及口播视频合成操作:

  1. 执行 scripts/ 目录下对应的脚本。
  2. 由脚本完成任务提交、监听器创建,并在同一个 Python 进程内持续轮询状态。
  3. 从脚本最终输出中读取 submission.task_id、submission.watcher_status 和 submission.watcher_job_id。
  4. 若 completion.finished 为 true,优先采用本次运行中返回的已完成结果。
  5. 仅当 submission.watcher_status 为 scheduled 且 submission.watcher_job_id 非空时,方可告知用户已为超时场景启用自动通知。

不得在未确认 cron job_id 的前提下擅自承诺通知。

必需字段

训练数字人

必需字段:

  • name
  • training_video_file_id

可选字段:

  • callback_url
  • error_skip
  • extra_payload

训练语音

必需字段:

  • name
  • training_audio_url

可选字段:

  • callback_url
  • extra_payload

合成口播视频

始终必需字段:

  • title
  • digital_human_id

音频源(三选一):

  • TTS 模式:提供 script
  • 音频文件模式:提供 audio_file、audio_file_id 或 audio_url 中的任意一个

通用可选字段:

  • voice_id
  • background_file
  • background_file_id
  • background_url
  • video_width
  • video_height
  • callback_url
  • extra_payload

字幕相关可选字段:

  • subtitle_show
  • subtitle_font_type
  • subtitle_font_size
  • subtitle_font_color
  • subtitle_border_color
  • subtitle_border_width
  • subtitle_x
  • subtitle_y
  • subtitle_width
  • subtitle_height
  • subtitle_asr_type
  • subtitle_items_json

渲染相关可选字段:

  • model
  • resolution_rate
  • add_compliance_watermark
  • compliance_watermark_position

脚本列表

  • scripts/list_public_digital_humans.py
  • scripts/list_public_voices.py
  • scripts/list_fonts.py
  • scripts/list_my_digital_humans.py
  • scripts/list_my_voices.py
  • scripts/train_digital_human.py
  • scripts/train_voice.py
  • scripts/synthesize_talking_video.py
  • scripts/get_task.py
  • scripts/schedule_task_watch.py
  • scripts/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"

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习