🦀 OpenBiliClaw

通用个性化内容推荐 Agent——本地运行、跨平台理解你、只为你一个人构建

A general-purpose personalized content discovery Agent — runs on your machine, understands only you

项目主页 | English | 中文

10 秒看懂 OpenBiliClaw

一个纯本地、私有、开源的自进化跨平台内容发现 Agent：从你的跨平台使用、反馈和对话中持续深化心理画像，带着对你的理解主动去 B 站、小红书、抖音、YouTube、X、知乎等来源找内容。

开发版还提供本机扩展 E2E 自检：后端可驱动已安装插件打开或复用抖音 / 小红书 / X 真实页面，先归位到平台入口，再执行白名单 DOM 操作并校验事件是否自然进入本地 /api/events。

快速开始

普通用户先走这四步；Firefox、Docker 和手动部署等备用路径保留在后面的 安装与部署详情。

1. 安装浏览器插件：推荐从 Latest Release 的 openbiliclaw-v* 聚合页下载 openbiliclaw-extension-v*.zip 手动安装（版本最新；Firefox 用 openbiliclaw-extension-v*-firefox.zip）；也可从 Chrome 应用商店一键安装（自动更新，但受审核排期影响，版本可能滞后于 Releases）。
2. 部署后端（两种方式，按需选一，都推荐）：
   • 🖥️ 下载桌面安装包（最省事）：同一个 Latest Release 聚合页会把当前后端源码、插件包和可用桌面安装包放在一起；桌面包可能单独热修或暂时不同步，页面里的 Current Channels 会标出对应 desktop-v*。下载 macOS .dmg / Windows .exe 后双击即用，自带本地 embedding、常驻菜单栏/托盘。当前为未签名的实验性预发布，macOS DMG 内会显示首次打开说明，详见 安装与部署详情。
   • 🤖 让 AI 助手部署（想改源码 / 深度定制选它）：把下面整句粘给 Claude Code、Codex CLI、Cursor、Windsurf 或其他 AI 编程助手。

请按照 https://raw.githubusercontent.com/whiteguo233/OpenBiliClaw/main/docs/agent-install.md 的说明帮我部署 OpenBiliClaw 后端(务必用 Bash 的 curl 下载这个文档,不要用 WebFetch — 会丢关键指令)

3. 在同一个浏览器登录内容平台：默认会用 B 站 做初始化来源，也可以取消 B 站、改勾 小红书 / 抖音 / YouTube / X / 知乎；初始化至少需要一个已登录且能取到信号的来源，勾选会同时开启该来源。
4. 打开桌面端或移动端 Web：后端启动后访问 http://127.0.0.1:8420/web；手机可扫插件二维码打开 http://<电脑局域网 IP>:8420/m/，再从手机浏览器保存到主屏幕，像桌面 App 一样快速进入。

用户交流群

为什么需要 OpenBiliClaw？

名字起源于 B 站（Bili = Bilibili，Claw = 爪子），项目最早只支持 B 站。从 v0.3.0 起已扩展为通用跨平台 Agent —— 已落地 B 站 / 小红书 / 抖音 / YouTube / X / 知乎初始化信号、抖音 search / hot / feed、X 服务端内容发现、知乎插件 search / hot / feed / creator / related discovery 和通用 Web 多类源，持续接入更多内容平台。

推荐系统本质上是一个中间商——平台站在海量内容和海量用户之间做匹配分发。现代推荐系统远比「优化点击率」复杂：它同时权衡点击率、完播率、点赞/投币概率、停留时长、用户留存、创作者生态健康、广告收入等十几个目标，把它们加权压成一个分数来排序。听起来很科学，但问题在于：这些权重是平台定的，优化目标归根结底是平台的——用户满意度只是被当作留存和变现的手段，而非目的本身。你以为你在挑内容，其实是中间商在替你决定你能看到什么。结果就是：推荐越来越像你已经看过的东西，偶尔的惊喜全靠运气。

而且每个平台都是一座孤岛。你在 B 站看了三年机械键盘，小红书完全不知道；你在小红书种草的咖啡器具，B 站从来不会推给你。你的兴趣被割裂在不同平台的数据库里，没有人帮你把它们连起来。

OpenBiliClaw 反过来。 它是一个本地运行的 AI Agent——先深度理解你，再根据对你的理解跨平台主动搜寻你会喜欢的内容。项目从 B 站起步，现已扩展到小红书、抖音、YouTube、X（Twitter）和知乎，后续还会覆盖更多内容平台：

🧠 先懂你，再找内容

不是从视频出发匹配标签，而是从你出发。通过行为分析推断 MBTI、认知风格、深层心理需求，构建五层灵魂画像（事件→偏好→觉察→洞察→灵魂）。它理解的是你这个人，不是你的点击记录。

🔮 根据理解主动探索，而非被动匹配

这是和传统推荐最核心的差异：系统会基于对你的理解，主动猜测你可能感兴趣但从未接触过的领域。一个关注机械表的人可能会喜欢建筑美学，一个看量子物理科普的人可能对哲学感兴趣——它用心理学桥接逻辑主动出击，猜对了升级为正式兴趣，猜错了安静退出。协同过滤永远不会推给你「没人从这条路径走过」的内容，但 OpenBiliClaw 会。

🔒 100% 本地，100% 你的

所有数据留在你硬盘上的一个 SQLite 文件里。LLM 默认用你自己的 API Key，也可实验性复用本机 Codex CLI 的 ChatGPT OAuth 凭据。没有云端，没有账号，没有任何人能看到你的画像。这个 Agent 怎么长，完全你说了算——反馈推荐、对话调教、换 LLM、改数据库，随你。

💡 和其他推荐工具的对比

	各平台官方推荐	关键词过滤插件	OpenBiliClaw
推荐逻辑	协同过滤	标签匹配	心理画像 + 五层记忆
内容来源	单一平台	单一平台	跨平台（B 站 · 小红书 · 抖音 · YouTube · X · 知乎 · 更多）
信息茧房	越推越窄	不解决	猜测兴趣主动破茧
数据归属	平台所有	通常云端	100% 本地
推荐解释	"猜你喜欢"	无	像朋友一样告诉你为什么
可定制	不可以	低	换 LLM / 改画像 / 写 Skill

📸 功能预览

核心入口现在有三个：浏览器插件负责平台内交互和登录会话，桌面端 Web（/web）提供大屏推荐首页，移动端 Web（/m）适合手机使用。桌面端和移动端都只调用本地 API，Cookie 同步和平台任务仍由插件承担。

🖥️ 桌面端 Web 预览

启动后端后访问 http://127.0.0.1:8420/web（或直接 http://127.0.0.1:8420/，会自动跳转），即可在浏览器大屏上使用推荐首页。

📱 移动端 Web 预览

最近更新

最新版本：v0.3.145 / extension v0.3.96 / desktop v0.3.145.1: Eval 缓存与推荐理由并发优化（2026-06-26）。完整变更详见 docs/changelog.md。

• 候选 eval 缓存更稳 —— 评分缓存按候选身份、完整画像 digest 和近期负样本 digest 命中，不再被 profile 对象重建或无关事件水位打穿。
• eval 默认大 batch + 双 worker —— 文本 discovery.evaluate_batch 默认 batch 提到 45，周期 drain 默认可并发跑两个 batch；多模态仍保留独立小 batch。
• 推荐理由生成更稳 —— 文案生成默认 2 worker、batch 保守为 30，并在批量响应异常时先拆半重试，避免一次坏输出放大全量逐条请求。
• prompt-cache 前缀更稳定 —— eval 和推荐理由批量调用关闭重复 core memory 注入，prompt 内仍保留完整结构化画像。

安装与部署详情

普通用户的正常流程是：先安装浏览器插件，再把一句话发给 AI 助手安装后端，在同一个浏览器登录内容平台；如果要在手机上使用，再打开移动端 Web。脚本、Docker 和手动部署只作为备用路径，放在下面折叠区。

1. 安装浏览器插件

插件是主要入口：它会在 B 站、小红书、抖音、YouTube、X 和知乎页面显示侧边栏、采集你的反馈，并把浏览器登录态安全地交给本地后端使用。

插件基于 Manifest V3，支持所有兼容 Chrome 插件的浏览器，包括 Chrome、Edge、Brave、Arc、Vivaldi、Opera 等。

推荐方式 · 从 Latest Release 聚合页下载最新版手动安装（拿到最新功能与修复 —— Chrome 应用商店受审核排期影响，版本通常会滞后几天到一两周）：

1. 打开 OpenBiliClaw Latest Release，也就是最新 openbiliclaw-v* 用户下载聚合页
2. Chrome / Edge / Brave 下载 openbiliclaw-extension-v*.zip；Firefox 下载 openbiliclaw-extension-v*-firefox.zip
3. 打开扩展管理页面（Chrome：chrome://extensions/ · Edge：edge://extensions/ · Brave：brave://extensions/），开启右上角「开发者模式」
4. 将下载的 .zip 文件拖入页面安装

省事方式 · Chrome 应用商店一键安装（安装后由浏览器自动更新，适合不想手动升级的人；缺点是版本可能滞后于 Releases）：

👉 在 Chrome 应用商店安装 OpenBiliClaw —— 打开后点「添加至 Chrome」即可。

插件更新取决于安装渠道：Chrome Web Store / Edge Add-ons / AMO 安装的版本由浏览器自动更新；从 GitHub Release 下载 zip、开发者模式加载或 Firefox 临时加载的用户，需要下载新版 zip 并按同样方式重新加载。后端设置里的“自动更新”开关只更新本地后端源码，不会更新浏览器插件。

Firefox 用 sidebar_action 而不是 Chrome 的 sidePanel，所以 release 会提供独立的 openbiliclaw-extension-v*-firefox.zip。下载后先解压，再通过 about:debugging 临时加载；也可以从源码本地构建同一个 Firefox 包：

unzip openbiliclaw-extension-v*-firefox.zip -