weibo-pic

Files (2)

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

SKILL.md (first lines)

# 微博图片上传 Skill

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

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

## 脚本调用方式

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

### 配置优先级

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

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

### 可用命令

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

---

## 平台结构

微博图片上传 Skill 提供以下核心能力：

- **图片上传** — 将本地图片文件上传到微博平台
- **图片 ID** — 返回上传后的图片 ID
- **格式支持** — 仅支持 JPG/JPEG、PNG、GIF 格式

---

## 快速开始

### 1. 登录并获取 Token

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

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

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

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

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

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

配置已保存到: ~/.weibo-pic/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-pic/token-cache.json`。后续执行其他命令时，脚本会自动使用缓存的 Token，并在过期前 60 秒自动刷新，无需手动管理。

### 2. 上传图片

登录后，使用 `upload` 命令上传图片：

```bash
node scripts/weibo-pic.js upload --file="/path/to/image.jpg"
```

**参数说明**：

| 参数 | 说明 | 必填 |
|------|------|------|
| `--file` | 图片文件路径 | 是 |

**上传过程输出**：
```
[INFO] 准备上传图片: image.jpg
[INFO] 文件大小: 1.25 MB
[INFO] 上传中...
[SUCCESS] ✓ 图片上传完成！
```

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

### 3. 刷新 Token

```bash

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

More from wecode-ai/openclaw-weibo