| name | douyin-publish |
| description | Publish videos to Douyin (抖音) via open platform API with OAuth2 authentication. Supports video upload, cover image, hashtags, and privacy settings. Requires Douyin open platform OAuth2 credentials. |
| metadata | {"openclaw":{"emoji":"🎤","requires":{"bins":["python3"]}}} |
抖音视频发布（douyin-publish）
通过抖音开放平台 API 发布视频，支持视频上传、封面、话题标签。使用 OAuth2 认证。
前置条件
- 抖音开放平台创建应用，获取 client_key / client_secret
- 申请「视频管理」权限范围
- 首次运行需浏览器授权，后续自动使用 refresh token
配置
保存到 ~/.openclaw/credentials/douyin_config.json：
{
"client_key": "your_client_key",
"client_secret": "your_client_secret",
"redirect_uri": "https://localhost:8080/callback"
}
首次授权后 token 保存到 ~/.openclaw/credentials/douyin_token.json
使用方式
python3 ./skills/douyin-publish/scripts/publish_douyin.py \
--title "视频标题" \
--video video.mp4 \
--cover cover.jpg \
--tags 话题1,话题2
参数说明
| 参数 | 必填 | 说明 |
|---|
--title | 是 | 视频标题，最多 55 字 |
--video | 是 | 视频文件路径，支持 mp4，建议 9:16 |
--cover | 否 | 封面图 URL 或本地路径 |
--tags | 否 | 逗号分隔的话题标签 |
--private | 否 | 设为仅自己可见 |
Agent 工作流
- 检查抖音配置和 token
- 准备视频 + 标题
- 运行
publish_douyin.py 脚本
- 检查 stdout JSON 输出：
{"ok": true, "item_id": "xxx", "url": "https://www.douyin.com/video/xxx"} → 成功{"ok": false, "error": "AUTH_REQUIRED"} → 需要完成 OAuth2 授权{"ok": false, "error": "..."} → 其他错误
错误处理
| 错误 | 原因 | 处理 |
|---|
| AUTH_REQUIRED | 无有效 OAuth2 token | 提示用户完成授权 |
| UPLOAD_FAILED | 上传失败 | 检查文件格式，重试一次 |
| PUBLISH_FAILED | 发布失败 | 检查权限和内容合规性 |
| QUOTA_EXCEEDED | API 调用频率限制 | 等待后重试 |
发布记录（强制）
发布成功后，必须立即调用 published-track 技能记录发布信息：
./skills/published-track/scripts/record.sh \
--platform douyin \
--title "标题" \
--content-type video \
--source-folder "<原始文件夹路径>" \
--publish-url "<发布URL>" \
--publish-date "$(date +%Y-%m-%d)"
--source-folder 为原始内容所在的相对路径（如 output_articles/xxx 或 output_videos/xxx）。
--publish-url 为发布后获得的 URL，若发布失败则留空并在 --notes 中注明原因。
执行 ./skills/published-track/scripts/init-db.sh（幂等，重复执行无副作用）。
