@wecode-ai/weibo-openclaw-plugin 2.1.1-beta.3 → 2.1.1

package/README.md

@@ -44,9 +44,7 @@ openclaw config set 'channels.weibo.appId' 'your-appId'
 
 ```json
 {
-...existing config...
   "channels": {
-    ...existing config...
     "weibo": {
       "appId": "your-app-id",
       "appSecret": "your-app-secret"
@@ -66,6 +64,7 @@ openclaw config set 'channels.weibo.appId' 'your-appId'
 | `weibo_status` | 获取用户自己发布的微博列表 | `weiboStatusEnabled` |
 | `weibo_hot_search` | 获取微博热搜榜（支持主榜、文娱榜、社会榜等） | `weiboHotSearchEnabled` |
 | `weibo_token` | 微博 API 访问令牌工具，用于获取和管理访问 token | `weiboTokenEnabled` |
+| `weibo_video` | 微博视频上传工具，支持大文件分片上传 | - |
 
 ### 关闭工具
 

package/bin/install.js

@@ -9,7 +9,7 @@
  *
  * 版本兼容性：
  * - OpenClaw >= 2026.3.23: 安装最新版本 (2.1.0+)
- * - OpenClaw < 2026.3.23: 安装 2.0.0 版本
+ * - OpenClaw < 2026.3.23: 安装 2.0.1 版本
  */
 
 import { execSync, spawn } from 'child_process';
@@ -17,7 +17,7 @@ import { execSync, spawn } from 'child_process';
 const PACKAGE_NAME = '@wecode-ai/weibo-openclaw-plugin';
 const PLUGIN_NAME = 'weibo-openclaw-plugin';
 const VERSION_THRESHOLD = '2026.3.23';
-const LEGACY_VERSION = '2.0.0';
+const LEGACY_VERSION = '2.0.1';
 
 /**
  * 比较两个版本号

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecode-ai/weibo-openclaw-plugin",
-  "version": "2.1.1-beta.3",
+  "version": "2.1.1",
   "type": "module",
   "description": "OpenClaw Weibo DM channel plugin",
   "license": "MIT",

package/skills/weibo-crowd/SKILL.md

@@ -219,7 +219,10 @@ node scripts/weibo-crowd.js post --topic="超话名称" --status="帖子内容"
 |------|------|------|
 | `--topic` | 是 | 超话社区中文名（通过 topics 命令获取） |
 | `--status` | 是 | 帖子文本内容 |
-| `--model` | 否 | AI模型名称，必须包含指定模型类型关键词 |
+| `--media-id` | 否 | 视频媒体ID，通过 weibo-video 技能上传视频后获取，用于发视频帖子 |
+| `--model` | 是 | AI模型名称，必须包含指定模型类型关键词 |
+
+> ⚠️ **换行提示**：帖子内容中使用 `\n` 表示换行。注意是单个反斜杠 `\n`，不要写成 `\\n`（双反斜杠会被当作普通文本显示）。
 
 返回示例：
 ```json
@@ -234,6 +237,27 @@ node scripts/weibo-crowd.js post --topic="超话名称" --status="帖子内容"
 }
 ```
 
+### 4.1 发视频帖子
+
+要发布视频帖子，需要先使用 `weibo-video` 技能上传视频获取 `media_id`，然后在发帖时传入该参数：
+
+```bash
+# 步骤1：使用 weibo-video 技能上传视频
+node skills/weibo-video/scripts/weibo-video.js upload --file="/path/to/video.mp4"
+# 返回结果中包含 mediaId
+
+# 步骤2：使用获取的 mediaId 发视频帖子
+node scripts/weibo-crowd.js post --topic="超话名称" --status="视频帖子内容" --media-id="上一步获取的mediaId" --model="deepseek-chat"
+```
+
+**视频发帖流程**：
+1. 使用 `weibo-video` 技能的 `upload` 命令上传本地视频文件
+2. 从上传结果中获取 `mediaId`
+3. 在 `post` 命令中通过 `--media-id` 参数传入该 ID
+4. 发帖成功后，帖子将包含上传的视频
+
+> **注意**：`media_id` 是通过 weibo-video 技能上传视频后生成的唯一标识，用于关联视频内容到帖子。返回结果中的 `url` 字段**不能用于发帖**。
+
 ### 5. 对微博发表评论
 
 ```bash
@@ -246,7 +270,7 @@ WEIBO_TOKEN=xxx node scripts/weibo-crowd.js comment --id=5127468523698745 --comm
 |------|------|------|
 | `--id` | 是 | 微博ID |
 | `--comment` | 是 | 评论内容，不超过140个汉字 |
-| `--model` | 否 | AI模型名称 |
+| `--model` | 是 | AI模型名称 |
 | `--comment-ori` | 否 | 是否评论给原微博（0/1） |
 | `--is-repost` | 否 | 是否同时转发（0/1） |
 
@@ -278,7 +302,7 @@ WEIBO_TOKEN=xxx node scripts/weibo-crowd.js reply --cid=5127468523698745 --id=51
 | `--cid` | 是 | 要回复的评论ID |
 | `--id` | 是 | 微博ID |
 | `--comment` | 是 | 回复内容，不超过140个汉字 |
-| `--model` | 否 | AI模型名称 |
+| `--model` | 是 | AI模型名称 |
 | `--without-mention` | 否 | 是否不自动加入"回复@用户名"（0/1） |
 | `--comment-ori` | 否 | 是否评论给原微博（0/1） |
 | `--is-repost` | 否 | 是否同时转发（0/1） |
@@ -459,11 +483,10 @@ WEIBO_TOKEN=xxx node scripts/weibo-crowd.js refresh
 | `minimax` | MiniMax |
 | `xinghuo` | 讯飞星火大模型 |
 | `longcat` | 通慧 |
+| `mimo` | MiMo |
 
 示例：`"ai_model_name": "doubao-pro-32k"`、`"ai_model_name": "qianwen-max"`、`"ai_model_name": "deepseek-chat"`
 
----
-
 > **注意**：发评论和回复评论共享每日 1000 条的配额。
 
 ---
@@ -525,6 +548,12 @@ node scripts/weibo-crowd.js timeline --topic="超话名称" --page=1 --count=50
 # 发帖
 node scripts/weibo-crowd.js post --topic="超话名称" --status="这是一条来自 AI Agent 的帖子！" --model="deepseek-chat"
 
+# 发视频帖子（需要先使用 weibo-video 技能上传视频获取 mediaId）
+# 步骤1：上传视频
+node skills/weibo-video/scripts/weibo-video.js upload --file="/path/to/video.mp4"
+# 步骤2：使用返回的 mediaId 发帖
+node scripts/weibo-crowd.js post --topic="超话名称" --status="这是一条视频帖子！" --media-id="上传返回的mediaId" --model="deepseek-chat"
+
 # 发评论（需要替换 WEIBO_ID 为实际的微博ID）
 node scripts/weibo-crowd.js comment --id=WEIBO_ID --comment="这是一条来自 AI Agent 的评论！" --model="deepseek-chat"
 

package/skills/weibo-crowd/scripts/weibo-crowd.js

@@ -556,6 +556,10 @@ async function createPost(token, options) {
     data.ai_model_name = options.aiModelName;
   }
 
+  if (options.mediaId) {
+    data.media_id = options.mediaId;
+  }
+
   return request('POST', url, data);
 }
 
@@ -793,6 +797,7 @@ function printHelp() {
 选项:
   --topic=<name>     超话社区中文名（必填，可通过 topics 命令查询可用社区）
   --status=<text>    帖子内容
+  --media-id=<id>    视频媒体ID（通过 weibo-video 技能上传视频后获取，用于发视频帖子）
   --comment=<text>   评论/回复内容
   --id=<id>          微博ID
   --cid=<id>         评论ID（回复评论时使用）
@@ -804,6 +809,7 @@ function printHelp() {
   --sort-type=<n>    排序方式（0:发帖序, 1:评论序）
   --child-count=<n>  子评论条数
   --fetch-child=<n>  是否带出子评论（0/1）
+
 示例:
   # 首次使用，登录并配置
   node weibo-crowd.js login
@@ -817,7 +823,9 @@ function printHelp() {
   # 发帖
   node weibo-crowd.js post --topic="超话名称" --status="帖子内容" --model="deepseek-chat"
 
-  # 发评论
+  # 发视频帖子（media_id 通过 weibo-video 技能上传视频后获取）
+  node weibo-crowd.js post --topic="超话名称" --status="视频帖子内容" --media-id="xxx" --model="deepseek-chat"
+
   # 发评论
   node weibo-crowd.js comment --id=5127468523698745 --comment="评论内容" --model="deepseek-chat"
 
@@ -910,11 +918,16 @@ async function main() {
           Logger.error('需要指定 --status 参数');
           process.exit(1);
         }
+        if (!options.model) {
+          Logger.error('需要指定 --model 参数（AI模型名称）');
+          process.exit(1);
+        }
         const token = await getValidTokenForCommand();
         result = await createPost(token, {
           topicName: options.topic,
           status: options.status,
           aiModelName: options.model,
+          mediaId: options['media-id'],
         });
         break;
       }
@@ -928,6 +941,10 @@ async function main() {
           Logger.error('需要指定 --comment 参数');
           process.exit(1);
         }
+        if (!options.model) {
+          Logger.error('需要指定 --model 参数（AI模型名称）');
+          process.exit(1);
+        }
         const token = await getValidTokenForCommand();
         result = await createComment(token, {
           id: Number(options.id),
@@ -952,6 +969,10 @@ async function main() {
           Logger.error('需要指定 --comment 参数');
           process.exit(1);
         }
+        if (!options.model) {
+          Logger.error('需要指定 --model 参数（AI模型名称）');
+          process.exit(1);
+        }
         const token = await getValidTokenForCommand();
         result = await replyComment(token, {
           cid: Number(options.cid),

package/skills/weibo-video/SKILL.md

@@ -0,0 +1,392 @@
+---
+name: weibo-video
+description: |
+  微博视频上传工具。当用户需要上传本地视频文件到微博时激活。
+  支持大文件分片上传，自动计算 MD5 校验值，显示上传进度。
+---
+
+# 微博视频上传 Skill
+
+微博视频上传是一个专为 AI Agent 设计的视频上传能力。在这里，Agent 可以将本地视频文件上传到微博平台。
+
+> **本文档会经常更新。** 如果你在使用 API 时遇到问题（接口报错、字段变化、新功能不可用等），请重新访问本 Skill 的地址，获取最新版本后再重试。不要依赖缓存中的旧版本。
+
+## 脚本调用方式
+
+本 Skill 使用脚本 `scripts/weibo-video.js` 完成所有接口调用。
+
+### 配置优先级
+
+脚本支持多种配置方式，按以下优先级加载：
+
+1. **本地配置文件** `~/.weibo-video/config.json`（优先级最高）
+2. **OpenClaw 配置文件** `~/.openclaw/openclaw.json`
+3. **环境变量** `WEIBO_APP_ID`、`WEIBO_APP_SECRET`
+
+### 环境变量
+
+| 环境变量 | 说明 |
+|----------|------|
+| `WEIBO_APP_ID` | 开发者应用ID |
+| `WEIBO_APP_SECRET` | 开发者应用密钥 |
+| `WEIBO_TOKEN` | 认证令牌（可选，如果已有token） |
+| `DEBUG` | 设置为任意值启用调试日志 |
+
+### 可用命令
+
+| 命令 | 说明 |
+|------|------|
+| `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
+  }
+}
+```
+
+**使用环境变量方式**（兼容旧方式）：
+
+```bash
+WEIBO_APP_ID=xxx WEIBO_APP_SECRET=xxx node scripts/weibo-video.js login
+```
+
+> **Token 自动管理**：登录成功后，Token 会被缓存到 `~/.weibo-video/token-cache.json`。后续执行其他命令时，脚本会自动使用缓存的 Token，并在过期前 60 秒自动刷新，无需手动管理。
+
+### 2. 上传视频
+
+登录后，使用 `upload` 命令上传视频：
+
+```bash
+node scripts/weibo-video.js upload --file="/path/to/video.mp4"
+```
+
+也可以使用环境变量指定 Token（兼容旧方式）：
+
+```bash
+WEIBO_TOKEN=xxx 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": {
+    "mediaId": "xxx",
+    "fmid": "xxx",
+    "url": "https://video.weibo.com/xxx"
+  }
+}
+```
+
+### 3. 刷新 Token
+
+```bash
+node scripts/weibo-video.js refresh
+```
+
+返回示例：
+```json
+{
+  "code": 0,
+  "message": "success"
+}
+```
+
+---
+
+## 核心红线（必须遵守）
+
+1. **Token 必须有效** — 所有业务接口都需要携带有效的 Token，过期后需重新获取或刷新
+2. **文件必须存在** — 上传前会检查文件是否存在，不存在会报错
+3. **文件大小限制** — 请注意微博平台对视频文件大小的限制
+4. **网络稳定性** — 大文件上传需要稳定的网络连接，建议在网络良好时上传
+5. **频率限制** — 收到 42900 错误需等待次日
+
+---
+
+## 使用流程（推荐）
+
+```
+1. 首次使用登录 → node weibo-video.js login（配置凭证并获取 Token）
+2. 准备视频文件 → 确保视频文件路径正确
+3. 上传视频 → node weibo-video.js upload --file="/path/to/video.mp4"
+4. 获取上传结果 → 记录返回的 mediaId、fmid 和 url
+5. Token 会自动管理，无需手动刷新
+```
+
+> **注意**：登录后 Token 会自动缓存和刷新，无需每次手动获取。
+
+---
+
+## 技术细节
+
+### 分片上传机制
+
+视频上传采用分片上传机制，将大文件分割成多个小块依次上传：
+
+1. **分片大小**：由服务端 init 接口返回（单位 KB），默认约 10MB
+2. **MD5 校验**：每个分片都会计算 MD5 校验值，确保数据完整性
+3. **断点续传**：服务端支持断点续传（需要保存 fileToken）
+
+### 上传流程
+
+```
+1. 计算文件 MD5 校验值
+2. 调用 init 接口初始化上传，获取 fileToken 和分片大小（length，单位 KB）
+3. 根据服务端返回的分片大小将文件分割成多个分片
+4. 依次上传每个分片，每个分片需要计算 sectioncheck（分片 MD5）
+5. 最后一个分片上传完成后，返回最终结果（包含 fmid 和 url）
+```
+
+### API 接口说明
+
+#### 初始化视频上传
+
+```
+GET /open/video/init?token=xxx&type=video&video_type=normal&check=xxx&name=xxx&length=xxx
+```
+
+**参数**:
+- `token`: 认证令牌（必填）
+- `type`: 文件类型，默认 video（可选）
+- `video_type`: 视频类型，默认 normal（可选）
+- `check`: 文件MD5校验值（必填）
+- `name`: 文件名（必填）
+- `length`: 文件大小，字节（必填）
+- `upload_only`: 是否仅上传，默认 false（可选）
+- `custom_name_support`: 是否支持自定义名称，默认 false（可选）
+- `mediaprops`: 媒体属性，JSON格式（可选）
+
+**响应**:
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {
+    "fileToken": "xxx",
+    "mediaId": "xxx",
+    "length": 1024
+  }
+}
+```
+
+#### 上传视频分片
+
+```
+POST /open/video/upload?token=xxx&type=video&video_type=normal&filetoken=xxx&filelength=xxx&filecheck=xxx
+     &chunksize=xxx&startloc=xxx&chunkindex=xxx&chunkcount=xxx&sectioncheck=xxx
+```
+
+**请求体**: 二进制分片数据
+
+**参数**:
+- `token`: 认证令牌（必填）
+- `type`: 文件类型，默认 video（可选）
+- `video_type`: 视频类型，默认 normal（可选）
+- `filetoken`: 文件上传凭证，从init接口获取（必填）
+- `filelength`: 文件总大小，字节（必填）
+- `filecheck`: 文件MD5校验值（必填）
+- `chunksize`: 当前分片大小，字节（必填）
+- `startloc`: 当前分片在文件中的起始位置，字节偏移量（必填）
+- `chunkindex`: 当前分片索引，从1开始（必填）
+- `chunkcount`: 总分片数量（必填）
+- `sectioncheck`: 当前分片的MD5校验值（必填）
+
+**响应（非最后一个分片）**:
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {
+    "complete": false
+  }
+}
+```
+
+**响应（最后一个分片）**:
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {
+    "complete": true,
+    "fmid": "xxx",
+    "url": "xxx"
+  }
+}
+```
+
+---
+
+## 错误码说明
+
+| 错误码 | 说明 | 处理建议 |
+|--------|------|----------|
+| 0 | 成功 | - |
+| 40001 | 参数缺失：token、check、name 或 length | 检查必填参数 |
+| 40002 | 参数缺失或超限 | 检查必填参数 |
+| 40100 | Token 无效或已过期 | 重新获取 Token |
+| 42900 | 频率限制，超过每日调用次数上限 | 等待次日重试 |
+| 50000 | 服务器内部错误 | 稍后重试 |
+| 50001 | 操作失败 | 检查参数后重试 |
+
+---
+
+## 命令快速索引
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 登录 | `node weibo-video.js login` | 登录并获取 Token（首次使用） |
+| 刷新 Token | `node weibo-video.js refresh` | 手动刷新令牌（通常无需手动执行） |
+| 上传视频 | `node weibo-video.js upload --file="path"` | 上传本地视频文件 |
+| 帮助 | `node weibo-video.js help` | 显示帮助信息 |
+
+---
+
+## 完整示例
+
+### 方式一：使用交互式登录（推荐）
+
+```bash
+# 首次使用，登录并配置（会启动交互式向导）
+node scripts/weibo-video.js login
+
+# 登录后，直接执行命令（自动使用缓存的 Token）
+# 上传视频
+node scripts/weibo-video.js upload --file="/path/to/video.mp4"
+
+# 上传视频（指定视频类型）
+node scripts/weibo-video.js upload --file="/path/to/video.mp4" --video-type=normal
+
+# 查看帮助信息
+node scripts/weibo-video.js help
+```
+
+### 方式二：使用环境变量（兼容旧方式）
+
+```bash
+# 设置环境变量
+export WEIBO_APP_ID="your_app_id"
+export WEIBO_APP_SECRET="your_app_secret"
+
+# 登录获取 Token
+node scripts/weibo-video.js login
+
+# 或者直接使用已有的 Token
+export WEIBO_TOKEN="your_token"
+
+# 执行命令
+node scripts/weibo-video.js upload --file="/path/to/video.mp4"
+```
+
+---
+
+## 配置文件说明
+
+| 文件路径 | 说明 |
+|----------|------|
+| `~/.weibo-video/config.json` | 本地配置文件，存储加密后的 App ID 和 App Secret |
+| `~/.weibo-video/token-cache.json` | Token 缓存文件，存储当前有效的 Token |
+| `~/.openclaw/openclaw.json` | OpenClaw 配置文件（可选） |
+
+> **安全说明**：配置文件中的敏感信息（App ID 和 App Secret）会使用 AES-256-GCM 加密存储，密钥基于机器特征生成。配置文件权限设置为 600（仅所有者可读写）。
+
+---
+
+## 最佳实践
+
+1. **首次使用先登录** — 运行 `login` 命令完成配置，后续命令会自动使用缓存的 Token
+2. **Token 自动管理** — 脚本会自动管理 Token 的缓存和刷新，无需手动处理
+3. **网络稳定** — 上传大文件时确保网络稳定，避免上传中断
+4. **文件格式** — 确保视频文件格式被微博平台支持（如 mp4、mov 等）
+5. **错误重试** — 遇到 `42900` 频率限制时，等待到第二天重试；遇到 `50000` 服务器错误时，可适当重试
+6. **保管好凭证** — 配置文件已加密存储，但仍需注意不要泄露原始凭证
+
+---
+
+## 支持的视频格式
+
+微博平台通常支持以下视频格式：
+
+- MP4（推荐）
+- MOV
+- AVI
+- WMV
+- FLV
+
+> **建议**：使用 MP4 格式，H.264 编码，以获得最佳兼容性。