openclaw-skills/docs/research-notes/phase-1.3-auth-comparison.md

B站插件调研 - Phase 1.3 授权方案对比与推荐

调研时间: 2026-02-06
调研人: 阿里巴巴助手

---

方案对比总表

评估维度	B站官方开放平台	bili-auth 第三方方案
准入门槛	❌ 仅企业开发者	✅ 任何B站用户
申请流程	复杂（注册→认证→审核→开发）	简单（部署即用）
授权体验	✅ 标准OAuth页面	⚠️ 需发送私信
功能完整性	✅ 全量API	⚠️ 普通用户API
稳定性	✅ 官方保障	❌ 依赖非公开接口
合规性	✅ 100%合规	❌ 灰色地带
账号风险	✅ 无风险	🟡 有小号风险
开发成本	高（需企业资质）	低（Docker一键部署）
维护成本	低（官方维护）	中（需关注接口变动）
扩展性	强	弱

---

决策矩阵

场景分析

使用场景	推荐方案	理由
企业/机构项目	官方开放平台	合规、稳定、功能完整
个人学习/实验	bili-auth	门槛低，快速验证想法
小团队内部工具	bili-auth	成本可控，风险可接受
商业产品/大规模	官方开放平台	合规要求，长期稳定
OpenClaw 技能	bili-auth	用户即开即用，无需企业资质

---

推荐方案（OpenClaw 技能）

主方案: bili-auth 私信鉴权

推荐理由:

1. ✅ 零门槛：用户无需申请开发者资质
2. ✅ 快速可用：部署后即可使用
3. ✅ 标准协议：OAuth 2.0，与官方体验接近
4. ✅ 成本可控：只需一个小号作为机器人

风险控制:

1. ⚠️ 小号策略：明确告知用户使用小号，避免主号风险
2. ⚠️ 频率限制：技能内建限流，避免触发风控
3. ⚠️ 降级设计：接口失效时优雅降级，不崩溃
4. ⚠️ 免责声明：明确说明非官方方案，用户自担风险

备选方案: 手动Cookie模式

适用场景:

• bili-auth 不可用时
• 用户不愿授权第三方服务

实现方式:

• 用户从浏览器复制Cookie
• 技能直接调用B站API
• 无需机器人账号

风险:

• Cookie泄露风险
• 有效期短，需频繁更新
• 同样存在封号风险

---

技术架构建议

推荐架构

用户 → OpenClaw 技能
          ↓
    [授权模块]
          ↓
    ├─→ bili-auth 服务（自建或公共）
    │       ↓
    │   B站私信鉴权
    │       ↓
    └─← access_token
          ↓
    [数据获取模块]
          ↓
    B站公开API调用
          ↓
    返回数据给OpenClaw

MVP 功能范围（bili-auth 方案）

Phase 1 - 基础功能

• 用户授权（bili-auth 集成）
• 获取关注列表
• 获取UP主动态
• 视频搜索

Phase 2 - 扩展功能

• 视频详情获取
• 播放历史（如有权限）
• 收藏列表（如有权限）

Phase 3 - 高级功能

• 自动追更提醒
• 数据分析

---

Go / No-Go 决策

结论: ✅ Go

理由:

1. bili-auth 方案技术可行
2. 风险可控（小号策略+频率限制）
3. 能满足核心需求（获取关注列表、追更）
4. 用户价值明确（解决无法官方API的问题）

前提条件:

1. 明确告知用户风险
2. 使用小号作为机器人
3. 实现频率限制
4. 准备降级方案

---

下一步行动

进入 Phase 2 - 数据获取能力调研，验证以下API是否可用：

• 用户信息获取
• 关注列表获取
• 视频搜索
• 视频详情

同时开始 Phase 5 - 原型开发 的准备工作。