OpenBiliClaw

🦀 OpenBiliClaw

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

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

项目主页 | English | 中文

国内 AtomGit 源码镜像：OpenBiliClaw（当前仍落后于 v0.3.231）

### 🆕 重要更新：OpenBiliClaw 现在可以装进 DeepSeek Harness

新增 DSH 客户端插件 —— 把 OpenBiliClaw 装进 DeepSeek Harness：DSH 界面常驻第四栏（推荐 / 内容库 / 对话 / 画像 / 设置），并注册 22 个 Agent Bridge 工具，让 DSH 里的 Agent 也能读推荐、答探测、闭环学习——边用 DSH 干活，边刷跨平台个性化内容。→ github.com/whiteguo233/dsh-openbiliclaw

📱 想要原生 App？Flutter 移动端客户端（Android / iOS / Web / 桌面）在独立仓库 OpenBiliClaw-mobile：推荐、对话、画像、收藏 / 稍后再看 / 30 天历史一应俱全，连接同一本地后端。

🇨🇳 国内源：Gitee v0.3.231 源码已同步至最新主线；AtomGit 源码镜像当前仍落后于 v0.3.231。安装包请从 GitHub Release 获取；123 云盘仍保留 v0.3.213 历史文件，最新版国内安装包镜像待更新。

10 秒看懂 OpenBiliClaw

正式来源：Instagram 与 TikTok（v0.3.231 起正式可用），两者默认关闭、需在设置里显式启用；插件默认包含两者的站点访问权限，无需在保存设置时单独授权。

- Instagram（v0.3.227 起提供，v0.3.231 起正式可用）：按话题、创作者发现内容；同一浏览器登录后，可有界只读导入本人近期点赞、收藏和关注来初始化画像。推荐卡收藏仅保存在本地。连接说明 · 实测范围。

- TikTok（v0.3.229 起提供，v0.3.231 起正式可用）：未登录可发现推荐流、话题和创作者视频，浏览器登录后可关键词搜索。公开发现→真实模型评估→推荐及桌面/手机 Web 展示已有实测。连接说明 · 实测范围。

已知限制：TikTok 站内收藏暂缓，非空真实账号画像、周期增量与 Firefox 登录态仍在验证（#295）；Instagram 的完整 Likes 历史、双账号、Firefox 登录态与手机真机仍在验证。两者均不宣称全部账号能力已完成验收。

一个纯本地、私有、开源的自进化跨平台内容发现 Agent：从你的跨平台使用、反馈和对话中持续深化心理画像，带着对你的理解主动去 B 站、小红书、抖音、YouTube、TikTok、X、知乎、Reddit、Linux.do、Bangumi、V2EX、微博、GitHub、Instagram 与开放 Web 找内容。

跨平台 · 本地优先 · 可调教 B 站 / 小红书 / 抖音 / YouTube / TikTok / X / 知乎 / Reddit / Linux.do / Bangumi / V2EX / 微博 / GitHub / Instagram / Web · 数据默认留在本机 SQLite · 喜欢、不感兴趣、聊天反馈都会改变后续推荐

安装浏览器插件 · 让 AI 助手部署后端

喜欢这个方向？欢迎 Star 支持项目继续适配更多平台。

快速开始

普通用户只需四步；Firefox、Docker、脚本和手动部署等备用路径都在 安装与部署详情。

1. 装插件 —— Chrome 应用商店一键安装（自动更新），或从 Latest Release 下载 zip 手动安装（最新功能先到，商店版可能滞后几天）。
2. 装后端 —— 从同一个 Latest Release 下载桌面安装包（macOS .dmg / Windows .exe，开箱即用、常驻菜单栏/托盘）。每个平台有两种安装包:精简版(默认,首启自动下载向量模型 bge-m3)与 `-with-embedding` 完整版(已内置 bge-m3 ~1.1GB,离线开箱即用)——网络差 / 想离线的选完整版,其余选精简版。Gitee 源码已同步至 v0.3.231；AtomGit 镜像仍在追赶，最新版安装包见 GitHub Release。123 云盘当前仍是 v0.3.213 历史文件。 想改源码或深度定制,就把下面这句话粘给 Claude Code / Codex CLI / Cursor 等 AI 编程助手：

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

1. 连接来源 —— 在装了插件的浏览器登录 B 站（默认初始化来源），或改选小红书 / 抖音 / YouTube / X / 知乎 / Reddit / Linux.do / V2EX / 微博 / GitHub。Linux.do、Bangumi、V2EX、微博与 GitHub 均可公开发现；需要账号态的来源仍复用已安装插件，GitHub 则由后端官方 REST API 匿名读取公开 repository。GitHub 可用公开用户名把 starred repositories 用作初始化信号，PAT 只是可选的提额和身份校验方式。TikTok、Instagram 需在「设置 → 来源」中手动开启；使用已装插件的浏览器登录，插件默认包含两者站点访问权限。TikTok 未登录可发现公开视频，登录后由插件同步凭据用于关键词搜索；Instagram 可只读导入本人点赞、收藏和关注。两者均需海外网络：后端沿现有网络/代理设置，浏览器任务使用浏览器自身代理。连接与许可要求见 TikTok、Instagram。
2. 打开界面 —— 浏览器访问 http://127.0.0.1:8420/web；手机扫插件二维码打开 http://:8420/m/，保存到主屏幕即可当 App 用；想要原生 App 体验，可安装独立仓库的 Flutter 客户端（Android / iOS / Web / 桌面，安装包见 Latest Release），在设置里填后端地址即可连接同一后端。

不在同一局域网时，OpenBiliClaw-mobile 的 Android / iOS 原生 App 已内嵌 tsnet，电脑端 也可让 OpenBiliClaw 自己加入同一 tailnet；Web / Linux / macOS / Windows Flutter 客户端不在 该能力范围。桌面安装包内置 helper；在电脑本机打开桌面 Web 或浏览器插件的 「设置 → 通用 → 应用内 Tailnet 远程访问」，开启后可选择留空走网页登录、填写 tskey-auth-… Auth Key，或填写带授权设备 tag 的 tskey-client-… OAuth Client Secret， 然后完整重启应用。凭据只在本机私有暂存到下一次启动，不进入 config.toml、API 回显或日志。 源码 / 一句话安装则先运行 openbiliclaw tailnet build-helper（需要 Go 1.26.6），再运行 openbiliclaw tailnet enable 并重启。电脑无需安装或全局开启系统 Tailscale；入口默认关闭、只在 tailnet 私网可见， 不启用 Funnel/Serve，建议同时在本机 Web 设置中开启应用密码（源码安装也可执行 openbiliclaw set-password）。详见应用内 Tailnet。

可选关键词 grounding：在 [discovery].inspiration_search_backends 中加入 parallel；默认链不变，见 Discovery。

query inspiration → configured provider chain → optional Parallel Search MCP
                  ← title / URL / excerpts    ← https://search.parallel.ai/mcp
                  → keyword grounding (no direct recommendation-pool writes)

用户交流群

QQ 用户群 Discord 社区 扫码或点击加入，链接长期有效

为什么需要 OpenBiliClaw？

名字起源于 B 站（Bili = Bilibili，Claw = 爪子），项目最早只支持 B 站。从 v0.3.0 起已扩展为通用跨平台 Agent，覆盖 B 站 / 小红书 / 抖音 / YouTube / TikTok / X / 知乎 / Reddit / Linux.do / Bangumi / V2EX / 微博 / GitHub、Instagram 与通用 Web，持续接入更多内容平台。

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

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

OpenBiliClaw 反过来。 它是一个本地运行的 AI Agent——先深度理解你，再根据对你的理解跨平台主动搜寻你会喜欢的内容。项目从 B 站起步，现已覆盖小红书、抖音、YouTube、TikTok、X（Twitter）、知乎、Reddit、Linux.do、Bangumi、V2EX、微博、GitHub、Instagram 和开放 Web：

🧠 先懂你，再找内容

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

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

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

🔒 100% 本地，100% 你的

核心行为、推荐和对话数据留在你硬盘上的 SQLite，配置、画像、凭据与缓存也只保存在本机文件中。LLM 默认用你自己的 API Key，也可实验性复用本机 Codex CLI 的 ChatGPT OAuth 凭据。没有 OpenBiliClaw 运营的云端账号，没有任何人能看到你的画像。这个 Agent 怎么长，完全你说了算——反馈推荐、对话调教、换 LLM、迁移或改数据库，随你。

💡 和其他推荐工具的对比

| | 各平台官方推荐 | 关键词过滤插件 | OpenBiliClaw |

|---|---|---|---|

| 推荐逻辑 | 协同过滤 | 标签匹配 | 心理画像 + 五层记忆 |

| 内容来源 | 单一平台 | 单一平台 | 跨平台（B 站 · 小红书 · 抖音 · YouTube · TikTok · X · 知乎 · Reddit · Linux.do · Bangumi · V2EX · 微博 · GitHub · Instagram · Web） |

| 信息茧房 | 越推越窄 | 不解决 | 猜测兴趣主动破茧 |

| 数据归属 | 平台所有 | 通常云端 | 100% 本地 |

| 推荐解释 | "猜你喜欢" | 无 | 像朋友一样告诉你为什么 |

| 可定制 | 不可以 | 低 | 换 LLM / 改画像 / 写 Skill |

📸 功能预览

核心入口现在有五个：浏览器插件负责平台内交互和登录会话，桌面端 Web（/web）提供大屏推荐首页，移动端 Web（/m）适合手机使用，另有独立仓库的原生 Flutter 客户端（OpenBiliClaw-mobile）覆盖 Android / iOS / Web / 桌面，以及把同一套面板搬进 DSH Web 界面的 DSH 客户端插件（第四栏 + 22 个 Agent Bridge 工具）。桌面端、移动端 Web、原生客户端和 DSH 插件都只调用本地 API，Cookie 同步和平台任务仍由插件承担。

智能推荐 像朋友一样解释为什么你会喜欢 灵魂画像 自然语言描述的深度人格分析 结构化特质 MBTI · 核心特质 · 深层需求 对话调教 聊天告诉它你想看什么

🖥️ 桌面端 Web 预览

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

桌面推荐首页 惊喜推荐 Hero · 为你推荐网格 · 朋友式推荐理由 推荐卡片网格 封面 + 推荐理由 · 喜欢 / 不感兴趣 / 稍后 / 收藏 / 聊一聊 画像 + 实时看板 侧栏 Runtime 看板 + 后台动态 · 人格素描 · 核心特质 · MBTI 推断

📱 移动端 Web 预览

手机推荐页 惊喜推荐 + 池子状态 · 朋友式推荐原因 看看 / 喜欢 / 稍后 / 收藏 / 不感兴趣 / 聊一聊 手机画像页 人格素描 · 核心特质 · 深层需求 · MBTI 手机对话页 与插件共享主聊天历史

📱 想要原生 App？独立仓库 OpenBiliClaw-mobile（Flutter）提供 Android / iOS / Web / Linux / macOS / Windows 客户端：推荐、对话、画像、收藏 / 稍后再看 / 30 天历史、消息收件箱一应俱全，B 站封面走 CDN 直连省两跳。Android 签名 APK 与 iOS 自签名 IPA 从 Latest Release 下载（iOS 需用个人 Apple 账号重签）。当前为新特性预览版，尚未经过长期实测。

更多截图

推荐反馈 点赞 / 多来点 / 少来点 / 没兴趣 价值偏好与兴趣 内在驱动力 · 猜测兴趣方向 认知风格 信息处理偏好 · 内容口味

最近更新

📌 最新版本：v0.3.231（2026-10-22）

• Instagram 与 TikTok 正式可用：不再标注实验性，默认关闭、需在设置中显式启用。
• 大肥鱼更会说话了：通知文案改由人设生成，默认人设更可爱；私信修复后已可真实投递。
• Ollama embedding：不再依赖聊天 SDK，部署更轻。
• 完整变更详见 docs/changelog.md。

完整变更详见 docs/changelog.md。

安装与部署详情

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

1. 安装浏览器插件

插件是主要入口：它会在受支持站点显示侧边栏、采集你的反馈，并承接知乎、Reddit、Linux.do、V2EX、微博等登录态只读任务。Linux.do、V2EX 与微博的任务 tab 和普通行为采集隔离；微博公开 discovery 由后端独立完成，个人初始化才使用微博 host permission 和同源任务桥。

插件基于 Manifest V3，支持所有兼容 Chrome 插件的浏览器，包括 Chrome、Edge、Brave、Arc、Vivaldi、Opera 等；另提供 Safari（macOS） 构建，Release 自动附带 openbiliclaw-extension-v*-safari.dmg（配置 Apple 凭据时为 Developer ID 签名 + 公证；未配置时为 ad-hoc 实验包，需在 Safari 开启「允许未签名扩展」），也可本地经 Apple safari-web-extension-converter 转成 Xcode 工程后安装（详见 Safari 构建文档）。

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

1. 打开 OpenBiliClaw Latest Release，也就是最新 openbiliclaw-v* 用户下载聚合页
2. Chrome / Edge / Brave 下载 openbiliclaw-extension-v*.zip；Firefox 若 release 提供 openbiliclaw-extension-v*-firefox.xpi 就直接安装，否则下载 openbiliclaw-extension-v*-firefox.zip 并按下方 about:debugging 临时加载；Safari（macOS）下载 openbiliclaw-extension-v*-safari.dmg，打开后首次运行 App，再到 Safari 设置 → 扩展里勾选 OpenBiliClaw
3. 打开扩展管理页面（Chrome：chrome://extensions/ · Edge：edge://extensions/ · Brave：brave://extensions/），开启右上角「开发者模式」
4. Chrome / Edge / Brave 将下载的 .zip 文件拖入页面安装；Firefox 的 .xpi 可直接打开确认安装，临时 zip 需要先解压再加载 manifest.json

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

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

插件更新取决于安装渠道：Chrome Web Store / Edge Add-ons，以及审核通过后的 Firefox AMO 上架版由浏览器自动更新；从 GitHub Release 下载的 Chrome zip / Firefox signed XPI / Firefox 临时 zip / Safari dmg、开发者模式加载或 Firefox 临时加载的用户，需要下载新版安装包并按同样方式重新加载。Firefox AMO 上架审核是异步的，listed 版本公开前请从 Release 使用 *-firefox.zip 临时加载；审核通过后由 Firefox 自动更新。后端设置里的“自动更新”开关只更新本地后端源码，不会更新浏览器插件。

Firefox 用户：正式安装与临时调试（Firefox 140+）

Firefox 用 sidebar_action 而不是 Chrome 的 sidePanel，所以 release 会提供独立产物：

• openbiliclaw-extension-v*-firefox.xpi：Mozilla AMO unlisted 签名后的正式安装包；仅在发布环境启用 AMO signing 且凭据可用时生成，普通 Firefox Release / Beta 可以直接安装。
• openbiliclaw-extension-v*-firefox.zip：未签名开发包，只用于 about:debugging 临时加载或 AMO 签名输入。普通 Firefox 直接安装它会提示“未通过验证 / could not be verified”。

临时调试或源码构建时使用：

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

# 或从源码构建
git clone https://github.com/whiteguo233/OpenBiliClaw.git
cd OpenBiliClaw/extension
npm install
npm run build:firefox          # 产出 dist-firefox/
npm run package:firefox        # 额外打成未签名 openbiliclaw-extension-v*-firefox.zip
# AMO 凭据配置后可签名成正式安装包：
# AMO_JWT_ISSUER=... AMO_JWT_SECRET=... npm run sign:firefox:only

加载方式：

1. 打开 about:debugging#/runtime/this-firefox
2. 点「Load Temporary Add-on…」
3. 选解压目录里的 manifest.json（或源码构建后的 extension/dist-firefox/manifest.json）