| name | weibo-publish |
| description | 通过 forked camoufox-cli 持久化 session weibo 在微博发布图文/视频内容。微博 API 对个人开发者不友好，浏览器方案更实用。 |
| metadata | {"openclaw":{"emoji":"📢"}} |
微博发布
通过 camoufox-cli 持久化 session weibo（有且只有一个，fail-first 队列：同 session 已有命令在跑时新命令直接 fail）在微博上发布内容（文字、图片、视频）。微博 API 对个人开发者申请门槛高，浏览器自动化是更实用的方案。
主力后端 = target=camoufox。下方命令 / 示例只针对 target=camoufox。
target=host / target=node：只按本 skill 的「流程 + 提示事项」走——何时有头 / 何时无头 / 频率限制 / 错误处理约定是后端无关的，照本 skill 执行。不要照搬 camoufox-cli ... 命令，用你当前后端自带的浏览器工具语义调用即可。
前置条件
- 持久化 session
weibo 已登录（登录态存 session profile 里）。本 skill 与 login-manager 完全无关——自管探活 + 登录，不导出 cookie/UA 落中央存储。
- 首次使用 / 登录态失效时，走自管有头手动登录流：
camoufox-cli --session weibo --persistent --headed --viewport 1920x1080 --json open "https://weibo.com"--viewport 1920x1080：camoufox 默认按指纹给移动端窗口比例，二维码看不全；强制桌面 1920×1080- 告知用户「微博 浏览器已打开，请在窗口里手动登录，完成后告诉我」
- 等用户回复后
snapshot 验登录态就位
- 登录后close session——登录态落磁盘 profile，不留进程占内存；本 skill 下次
--session weibo --persistent 重起无头即恢复，用完再 close。
不导出 cookie/UA——登录态只在 session profile 里闭环，不落 ~/.openclaw/logins/。本 skill 不调用 cookies export / identity export。
发布文字微博
1. 启持久化 session + 打开微博首页：
camoufox-cli --session weibo --persistent --json open "https://weibo.com"
2. sleep 3 加载，snapshot 拿到输入框 ref
- 输入框选择器：textarea.W_input 或 [node-type="textEl"] 或 textarea[placeholder*="有什么新鲜事"]
- 如果找不到，open "https://weibo.com" 刷新后重试
3. click <ref> 聚焦输入框
4. camoufox-cli --session weibo --persistent --json type <ref> "微博内容"
- 最长 2000 字符
5. snapshot 找发布按钮 ref：a[node-type="submit"] 或 button[action-type="post"] 或文本为"发布"的按钮
6. camoufox-cli --session weibo --persistent --json click <发布按钮-ref>
7. sleep 3，snapshot 确认发布成功（输入框清空或出现"发布成功"提示）
发布图文微博
1. 启 session + 打开首页（同文字微博步骤 1-2）
2. snapshot 拿到图片上传按钮 ref：a[node-type="uploadImg"] 或 .W_icon_pic 图标
3. camoufox-cli --session weibo --persistent --json upload <图片-input-ref> <image.jpg> [更多图片...]
- forked cli upload 命令底层走 Playwright setInputFiles，无需 CDP setFileInput hack
- 最多 9 张图片，单张不超过 5MB
4. sleep 等待上传完成（snapshot 看缩略图出现在编辑区）
5. 输入文字内容（同文字微博步骤 3-4）
6. 发布（同文字微博步骤 5-7）
发布视频微博
1. 启 session + 打开首页（同文字微博步骤 1-2）
2. snapshot 拿到视频上传入口 ref：a[node-type="uploadVideo"]
或 open "https://weibo.com/p/103495:home"（视频发布页）
3. camoufox-cli --session weibo --persistent --json upload <视频-input-ref> <video.mp4>
- 视频限制：mp4 格式，最长 15 分钟，不超过 2GB
4. sleep 等待上传完成（snapshot 看进度条到 100%）
5. 填写描述文字（type 命令）
6. 发布（click 发布按钮）
必做约束
- 用完即 close 持久化 session
weibo——登录态 + 指纹冻结在磁盘 profile，不留进程占内存；下次发布 --session weibo --persistent 重起无头即恢复。只在 session 卡死时 camoufox-cli --session weibo --json close teardown。
- 同 session 已有命令在跑时，新命令 fail-first（返回
session weibo 正忙，请等待当前操作完成后再试）——读到这条文本就等当前操作完成再重试，不要盲试。
- 每次发布间隔 60 秒以上，避免触发反垃圾。
Pitfalls
pitfall: css_module_hash_drift
- 触发：用 CSS module hash 选择器（如
.publishBtn_1a2b3c）
- 症状：下次部署后选择器失效
- workaround：用
node-type 属性或 placeholder 文本定位，不用 hash class
pitfall: input_box_collapsed
- 触发：微博首页输入框默认折叠
- 症状：输入框高度很小，无法直接输入
- workaround：先
click 输入框使其展开，sleep 1 后再 type
pitfall: anti_spam_on_rapid_post
- 触发：短时间内连续发布多条微博
- 症状：出现验证码或"操作过于频繁"
- workaround：每次发布间隔 60 秒以上
pitfall: weibo_url_shortener
- 触发：微博内容中包含 URL
- 症状：URL 被自动缩短为 t.cn 格式
- workaround：这是正常行为，不影响发布
错误处理
| 情况 | 处理 |
|---|
| 未登录 / 登录墙 | 走前置条件的有头手动登录流，重试一次 |
| 输入框找不到 | 刷新页面后重试，或用 placeholder 文本定位 |
| 图片上传失败 | 检查文件大小（<5MB），重试一次 |
| 视频上传超时 | 检查文件大小和网络，等待更长时间 |
| 验证码 / 频率限制 | 等待 60 秒后重试 |
| session 正忙（fail-first） | 等当前操作完成再重试，不要盲试 |
发布后
必须调用 published-track 技能记录本次发布。
