with one click
weibo-pic
微博图片上传工具。当用户需要上传本地图片文件到微博时激活。 支持常见图片格式,返回图片 ID。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
微博图片上传工具。当用户需要上传本地图片文件到微博时激活。 支持常见图片格式,返回图片 ID。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
微博技能集合。包含热搜榜、智搜、用户微博、超话互动、图片/视频上传、定时任务、创作者数据分析等功能。 首次使用请先完成配置(向用户询问 App ID 和 App Secret,写入本地配置文件并获取 Token)。
微博技能集合。包含热搜榜、智搜、用户微博、超话互动、图片/视频上传、定时任务、创作者数据分析等功能。 首次使用请先完成配置(向用户询问 App ID 和 App Secret,运行 login 命令完成登录)。
微博互动内容分析工具。获取收到的评论列表、获取自己某条微博的所有评论, 并提供互动回复建议分析能力,根据关注关系和认证状态筛选最值得回复的评论。 当用户需要查看收到的评论、自己某条微博的评论详情时激活; 或当用户询问哪些评论值得回复、如何优先回复粉丝评论、互动建议时激活。
微博激励计划数据工具。获取线上外显的激励计划相关数据,包含在线激励计划列表(名称、描述、PR博文链接、内容方向标签)、 计划高收益博文示例(榜单规则、上榜博文信息)、博主近7日优质博文及命中计划。 当用户需要了解当前有哪些激励计划可以参与、查看计划详情与规则、查看高收益博文示例时激活; 或当用户想知道自己的博文是否命中激励计划、哪些计划适合自己参与、如何获得更多创作激励时激活; 或当用户需要获取激励计划参与建议、发博内容建议、参与计划发博规划时激活。
微博创作者数据工具。获取创作者中心的综合数据摘要,包含近30天阅读/发博/互动趋势、 近7天粉丝与铁粉数据、铁粉画像(分布/性别/年龄/地区/兴趣/来源)、粉丝画像(性别/年龄/地区/兴趣)、 近期热门博文详情、最近4周 V影响力榜周榜得分与排名、粉丝群运营数据以及近30天视频播放数据。 当用户需要了解自己的创作数据、粉丝增长情况、内容表现或铁粉/粉丝画像时激活; 或当用户询问如何升级橙V/金V、距离升级还差多少、需要多长时间能达标时激活; 或当用户询问自己的 V榜排名、得分、与同领域博主对比、哪些方面需要提升时激活; 或当用户询问粉丝群运营情况、群活跃度、铁粉在群率、视频播放数据时激活。
微博超话发帖工具。当用户需要在微博超话社区发帖、评论、回复、点赞或查看帖子流时激活。 支持在指定超话社区发布帖子、发表评论、回复评论、点赞帖子/评论,以及查询帖子流、评论列表和置顶帖。
| name | weibo-pic |
| description | 微博图片上传工具。当用户需要上传本地图片文件到微博时激活。 支持常见图片格式,返回图片 ID。 |
| metadata | {"version":"1.0.0"} |
微博图片上传是一个专为 AI Agent 设计的图片上传能力。在这里,Agent 可以将本地图片文件上传到微博平台。
本文档会经常更新。 如果你在使用 API 时遇到问题(接口报错、字段变化、新功能不可用等),请重新访问本 Skill 的地址,获取最新版本后再重试。不要依赖缓存中的旧版本。
本 Skill 使用脚本 scripts/weibo-pic.js 完成所有接口调用。
脚本支持多种配置方式,按以下优先级加载:
~/.weibo-pic/config.json(优先级最高)~/.openclaw/openclaw.json| 命令 | 说明 |
|---|---|
login | 登录并获取 Token(首次使用请先执行此命令) |
refresh | 刷新 Token |
upload | 上传本地图片文件 |
help | 显示帮助信息 |
微博图片上传 Skill 提供以下核心能力:
首次使用时,运行 login 命令进行登录配置:
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 秒自动刷新,无需手动管理。
登录后,使用 upload 命令上传图片:
node scripts/weibo-pic.js upload --file="/path/to/image.jpg"
参数说明:
| 参数 | 说明 | 必填 |
|---|---|---|
--file | 图片文件路径 | 是 |
上传过程输出:
[INFO] 准备上传图片: image.jpg
[INFO] 文件大小: 1.25 MB
[INFO] 上传中...
[SUCCESS] ✓ 图片上传完成!
返回示例:
{
"code": 0,
"message": "success",
"data": {
"pic_id": "xxx"
}
}
node scripts/weibo-pic.js refresh
返回示例:
{
"code": 0,
"message": "success"
}
1. 首次使用登录 → node weibo-pic.js login(配置凭证并获取 Token)
2. 准备图片文件 → 确保图片文件路径正确
3. 上传图片 → node weibo-pic.js upload --file="/path/to/image.jpg"
4. 获取上传结果 → 记录返回的 pic_id
5. Token 会自动管理,无需手动刷新
注意:登录后 Token 会自动缓存和刷新,无需每次手动获取。
POST /open/pic/upload?token=xxx
请求体: 图片二进制数据
参数:
token: 认证令牌(必填,URL参数)响应:
{
"code": 0,
"message": "success",
"data": {
"pic_id": "xxx"
}
}
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 0 | 成功 | - |
| 40001 | 参数缺失:token | 检查必填参数 |
| 40002 | 参数缺失或超限 | 检查必填参数 |
| 40100 | Token 无效或已过期 | 重新获取 Token |
| 42900 | 频率限制,超过每日调用次数上限 | 等待次日重试 |
| 50000 | 服务器内部错误 | 稍后重试 |
| 50001 | 操作失败 | 检查参数后重试 |
| 功能 | 命令 | 说明 |
|---|---|---|
| 登录 | node weibo-pic.js login | 登录并获取 Token(首次使用) |
| 刷新 Token | node weibo-pic.js refresh | 手动刷新令牌(通常无需手动执行) |
| 上传图片 | node weibo-pic.js upload --file="path" | 上传本地图片文件 |
| 帮助 | node weibo-pic.js help | 显示帮助信息 |
# 首次使用,登录并配置(会启动交互式向导)
node scripts/weibo-pic.js login
# 登录后,直接执行命令(自动使用缓存的 Token)
# 上传图片
node scripts/weibo-pic.js upload --file="/path/to/image.jpg"
# 查看帮助信息
node scripts/weibo-pic.js help
| 文件路径 | 说明 |
|---|---|
~/.weibo-pic/config.json | 本地配置文件,存储加密后的 App ID 和 App Secret |
~/.weibo-pic/token-cache.json | Token 缓存文件,存储当前有效的 Token |
~/.openclaw/openclaw.json | OpenClaw 配置文件(可选) |
安全说明:配置文件中的敏感信息(App ID 和 App Secret)会使用 AES-256-GCM 加密存储,密钥基于机器特征生成。配置文件权限设置为 600(仅所有者可读写)。
login 命令完成配置,后续命令会自动使用缓存的 Token42900 频率限制时,等待到第二天重试;遇到 50000 服务器错误时,可适当重试本工具仅支持以下图片格式:
注意:建议使用 JPG 格式,以获得最佳兼容性和较小的文件大小。