weibo-video

Files (2)

• SKILL.md
• weibo-video.js · scripts/

SKILL.md (first lines)

# 微博视频上传 Skill

微博视频上传是一个专为 AI Agent 设计的视频上传能力。在这里，Agent 可以将本地视频文件上传到微博平台。

> **本文档会经常更新。** 如果你在使用 API 时遇到问题（接口报错、字段变化、新功能不可用等），请重新访问本 Skill 的地址，获取最新版本后再重试。不要依赖缓存中的旧版本。

## 脚本调用方式

本 Skill 使用脚本 `scripts/weibo-video.js` 完成所有接口调用。

### 配置优先级

脚本支持多种配置方式，按以下优先级加载：

1. **本地配置文件** `~/.weibo-video/config.json`（优先级最高）
2. **OpenClaw 配置文件** `~/.openclaw/openclaw.json`

### 可用命令

| 命令 | 说明 |
|------|------|
| `login` | 登录并获取 Token（首次使用请先执行此命令） |
| `refresh` | 刷新 Token |
| `upload` | 上传本地视频文件 |
| `help` | 显示帮助信息 |

---

## 平台结构

微博视频上传 Skill 提供以下核心能力：

- **视频上传** — 将本地视频文件上传到微博平台
- **分片上传** — 自动将大文件分片上传，支持大文件
- **进度显示** — 实时显示上传进度
- **MD5 校验** — 自动计算文件和分片的 MD5 校验值，确保数据完整性

---

## 快速开始

### 1. 登录并获取 Token

首次使用时，运行 `login` 命令进行登录配置：

```bash
node scripts/weibo-video.js login
```

如果没有配置信息，脚本会启动交互式配置向导，引导你输入 App ID 和 App Secret。配置完成后会自动获取 Token 并缓存。

**交互式配置流程**：
```
=== 微博视频上传配置向导 ===

请输入您的微博应用凭证信息。
如果您还没有凭证，请私信 @微博龙虾助手 发送 "连接龙虾" 获取。

请输入 App ID: your_app_id
请输入 App Secret: your_app_secret

配置已保存到: ~/.weibo-video/config.json
```

**登录成功输出**：
```
✓ 登录成功！
Token: eyJhbGciOiJIUzI1NiIs...
有效期: 7200 秒 (约 2.0 小时)
过期时间: 2026/3/19 23:47:38

--- Token 信息（JSON 格式）---
{
  "code": 0,
  "message": "success",
  "data": {
    "token": "临时连接Token",
    "expire_in": 7200
  }
}
```

> **Token 自动管理**：登录成功后，Token 会被缓存到 `~/.weibo-video/token-cache.json`。后续执行其他命令时，脚本会自动使用缓存的 Token，并在过期前 60 秒自动刷新，无需手动管理。

### 2. 上传视频

登录后，使用 `upload` 命令上传视频：

```bash
node scripts/weibo-video.js upload --file="/path/to/video.mp4"
```

**参数说明**：

| 参数 | 说明 | 必填 |
|------|------|------|
| `--file` | 视频文件路径 | 是 |
| `--type` | 文件类型，默认 video | 否 |
| `--video-type` | 视频类型，默认 normal | 否 |
| `--upload-only` | 是否仅上传，默认 false | 否 |
| `--custom-name` | 是否支持自定义名称，默认 false | 否 |

**上传过程输出**：
```
[INFO] 准备上传视频: video.mp4
[INFO] 文件大小: 25.50 MB
[INFO] 计算文件校验值...
[INFO] 初始化上传...
[INFO] 分片数量: 6
[████████████████████░] 85% 上传分片 5/6
[SUCCESS] ✓ 视频上传完成！
```

**返回示例**：
```json
{
  "code": 0,
  "message": "success",
  "data": {

From wecode-ai/openclaw-weibo, Apache-2.0.

More from wecode-ai/openclaw-weibo