weibo-token

Files (1)

• SKILL.md

SKILL.md (first lines)

# 微博 Token 工具

使用 `weibo_token` 工具获取微博 API 访问令牌。此工具提供统一的 token 管理服务，为其他微博工具提供认证支持。

## 基本用法

```json
{
  "tool_calls": [
    {
      "name": "weibo_token",
      "arguments": {}
    }
  ]
}
```

此工具不需要任何参数，直接调用即可获取当前有效的 token。

## 参数说明

此工具无需参数。

## 返回结果

成功时返回：

```json
{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "acquiredAt": "2026-03-12T15:30:00.000Z",
  "expiresIn": 7200,
  "expiresAt": "2026-03-12T17:30:00.000Z"
}
```

错误时返回：

```json
{
  "success": false,
  "error": "获取微博 token 失败: 错误信息"
}
```

## 返回字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `success` | boolean | 是否成功获取 token |
| `token` | string | 访问令牌 |
| `acquiredAt` | string | token 获取时间（ISO 8601 格式） |
| `expiresIn` | number | token 有效期（秒），默认 7200 秒（2小时） |
| `expiresAt` | string | token 过期时间（ISO 8601 格式） |

## 配置（必填）

```json
{
  "channels": {
    "weibo": {
      "appId": "your_app_id",
      "appSecret": "your_app_secret"
    }
  }
}
```

### 配置项说明

| 配置项 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| `appId` | string | 是 | - | 应用 ID，用于获取 token |
| `appSecret` | string | 是 | - | 应用密钥，用于获取 token |
| `tokenEndpoint` | string | 否 | `https://open-im.api.weibo.com/open/auth/ws_token` | Token 获取端点 |
| `weiboTokenEnabled` | boolean | 否 | `true` | 是否启用 token 工具 |

## API 说明

此工具使用微博开放平台的 token 接口：

### 获取 Token
```
POST https://open-im.api.weibo.com/open/auth/ws_token
Content-Type: application/json

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret"
}
```

### 响应示例
```json
{
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expire_in": 7200
  }
}
```

## Token 缓存机制

1. **自动缓存**：首次获取的 token 会被缓存
2. **自动刷新**：在 token 过期前 60 秒自动刷新
3. **共享使用**：所有微博工具共享同一个 token 缓存

## 使用场景

此工具主要用于以下场景：

1. **调试**：检查当前 token 状态和有效期
2. **预热**：在使用其他微博工具前预先获取 token
3. **监控**：监控 token 的获取和刷新情况

## 与其他工具的关系

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

More from wecode-ai/openclaw-weibo