Install
openclaw skills install @lintqiu/focusavatar数字人生成 CLI 工具,凭 accessKeyId/accessKeySecret 调用后端 API,支持提交任务(MP3/MP4/文字→视频)与查询任务结果(orderNo);不存储用户数据,凭证仅通过请求头发送。
openclaw skills install @lintqiu/focusavatar命令行数字人生成工具,通过 accessKeyId 与 accessKeySecret 调用后端 API,完成「MP3 + MP4 模板 + 文字」到数字人视频的生成与结果查询。安装或首次使用前请先前往控制台获取 accessKeyId 和 accessKeySecret。
orderNo 查询任务状态与视频链接。使用前必读:所有 API 调用均需认证,请先获取凭证:
使用方式:
运行脚本时按提示输入,或
设置环境变量免输入(将 你的accessKeyId、你的accessKeySecret 替换为控制台复制的真实值):
Windows(PowerShell,当前窗口有效):
$env:FOCUSAVATAR_ACCESS_KEY_ID = "你的accessKeyId"
$env:FOCUSAVATAR_ACCESS_KEY_SECRET = "你的accessKeySecret"
Windows(CMD,当前窗口有效):
set FOCUSAVATAR_ACCESS_KEY_ID=你的accessKeyId
set FOCUSAVATAR_ACCESS_KEY_SECRET=你的accessKeySecret
Windows(永久):
设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 用户变量 → 新建 FOCUSAVATAR_ACCESS_KEY_ID、FOCUSAVATAR_ACCESS_KEY_SECRET 并填入对应值。
Linux / macOS(当前终端有效):
export FOCUSAVATAR_ACCESS_KEY_ID="你的accessKeyId"
export FOCUSAVATAR_ACCESS_KEY_SECRET="你的accessKeySecret"
Linux / macOS(永久):
将上述两行写入 ~/.bashrc 或 ~/.zshrc,再执行 source ~/.bashrc 或 source ~/.zshrc。
认证通过请求头 X-Access-Key-Id、X-Access-Key-Secret 传递;本技能不保存、不上传凭证到除后端以外的任何地方。
POST {BASE_URL}/skill/api/submit
mp3, mp4, textvideoUrl 或 orderNo(需轮询)POST {BASE_URL}/skill/api/api/result
orderNostatus、progress、videoUrl、message 等BASE_URL 由环境变量 FOCUSAVATAR_API 指定(未设置时默认示例:https://yunji.focus-jd.cn)。
npx skills add https://github.com/lintqiu/focusavatar -s focusavatar -y 下载安装
首次安装完成后:使用前请先前往指定地址获取 accessKeyId 与 accessKeySecret。
→ 控制台地址:https://login.joycoreai.com/ 或部署方提供的地址(注册 → 购买/开通 → 创建密钥)。
获取后可在使用技能时按提示输入,或设置环境变量 FOCUSAVATAR_ACCESS_KEY_ID、FOCUSAVATAR_ACCESS_KEY_SECRET 免输入。
安装后通过 OpenClaw 或技能入口启动本技能即可。
| 步骤 | 说明 |
|---|---|
| ① 设置凭证 | 自动:已设置环境变量则无需输入。一步一步:未设置时按提示输入 accessKeyId、accessKeySecret。 |
| ② 选择模式 | 两种模式:[1] 提交任务(走 focusavatar 原流程) / [2] 查询任务结果(需提供 orderNo)。 |
| ③ 设置 MP3 地址 | 选「提交任务」时,一步输入 MP3 路径或 URL。 |
| ④ 设置 MP4 地址 | 一步输入 MP4 路径或 URL。 |
| ⑤ 设置文字内容 | 一步输入需要合成的文字内容。 |
| ⑥ 确认并提交 | 确认后提交;提交任务需等待约 5–10 分钟;查询任务输入 orderNo 即返回结果。 |
顺序:凭证(①)→ 模式(②)→ 若提交任务:MP3(③)→ MP4(④)→ 文字(⑤)→ 确认提交(⑥);若查询则输入 orderNo。
1. 通过 OpenClaw Skills 安装到本地
npx。未安装可前往 https://nodejs.org/ 下载安装。https://github.com/lintqiu/focusavatar 替换为实际技能仓库地址,例如 https://github.com/lintqiu/focusavatar):
npx skills add https://github.com/lintqiu/focusavatar -s focusavatar -y 下载安装
-s focusavatar 为技能名称,-g 表示按全局/规范安装,-y 表示默认确认、非交互。.openclaw/workspace/skills/focusavatar,以 OpenClaw 实际约定为准)。2. 运行环境与依赖
python3 --version 或 python --version。pip3 install requests 或 python3 -m pip install requestspip install requests 或 py -m pip install requests3. 权限与网络
FOCUSAVATAR_API 指定的后端(未设置时使用默认地址),请确保本机可访问该地址(防火墙、代理允许出站)。FOCUSAVATAR_API 指定),数据处理与存储由该后端及所属方负责。