抖音用户视频查询 Skill

获取指定抖音用户主页的视频列表。

Features

根据抖音用户主页 URL 获取视频列表
返回视频描述和发布时间
支持配置环境变量自动获取 apikey 和 cookie

Setup

配置环境变量

在 OpenClaw 配置中添加环境变量（~/.openclaw/openclaw.json）：

{
  "skills": {
    "douyin-user-videos": {
      "env": {
        "DOUYIN_API_KEY": "用户的GUID-apiKey",
        "DOUYIN_COOKIE": "抖音Cookie"
      }
    }
  }
}

或者通过命令行设置：

export DOUYIN_API_KEY="用户的GUID-apiKey"
export DOUYIN_COOKIE="抖音Cookie"

apikey 说明

apikey 是用户在学AI门户注册后获得的 GUID
每个用户有唯一的 apikey，用于计费和身份验证

Usage Examples

查询抖音用户视频

User: "获取 https://www.douyin.com/user/MS4wLjABAAAAxxx 的视频列表" User: "这个抖音博主发了哪些视频"

Action:

从用户消息中解析抖音主页 URL
调用 douyin_get_user_videos 工具（自动使用环境变量中的 apikey 和 cookie）
格式化返回视频列表

Tools

douyin_get_user_videos

获取抖音用户的视频列表。

Parameters:

url (string, required): 抖音用户主页 URL，格式如 https://www.douyin.com/user/MS4wLjABAAAAxxx

环境变量（自动使用）：

DOUYIN_API_KEY: 用户的 API Key (GUID)
DOUYIN_COOKIE: 抖音登录 Cookie

Returns:

{
  "success": true,
  "message": "获取视频列表成功",
  "data": [
    {
      "desc": "视频描述内容",
      "createTime": 1774504047,
      "beijingTime": "2026/3/26 13:47:27"
    }
  ]
}

Error Handling

无效 URL: 提示用户检查抖音链接格式
API Key 无效: 提示用户检查 DOUYIN_API_KEY 配置
Cookie 无效: 提示用户更新 DOUYIN_COOKIE
积分不足: 提示用户充值积分

Notes

Cookie 来自抖音网页登录状态，需要定期更新，获取方式：https://my.feishu.cn/wiki/HbTpwSDMMiu4mUkCsjwcXgCWn7Z
API Key 是用户的唯一标识，获取方式：https://my.feishu.cn/wiki/HbTpwSDMMiu4mUkCsjwcXgCWn7Z