OpenBiliClaw

Name: OpenBiliClaw
Author: whiteguo233

Verified

OpenBiliClaw 是纯本地、私有、开源的自进化跨平台内容发现 Agent：从你的使用、反馈与对话中深化心理画像，主动去 B站、小红书、抖音、YouTube、X、知乎与 Web 找内容 / Local-first private AI discovery agent for Bilibili, Xiaohongshu, Douyin, YouTube, X, Zhihu, and the web.

807stars

57forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/whiteguo233/OpenBiliClaw

Getting Started

Guides for using ai agents skills like OpenBiliClaw.

Security ReportVerified

Last scanned: 5/24/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-24T07:20:42.102Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is OpenBiliClaw?

OpenBiliClaw is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by whiteguo233. OpenBiliClaw 是纯本地、私有、开源的自进化跨平台内容发现 Agent：从你的使用、反馈与对话中深化心理画像，主动去 B站、小红书、抖音、YouTube、X、知乎与 Web 找内容 / Local-first private AI discovery agent for Bilibili, Xiaohongshu, Douyin, YouTube, X, Zhihu, and the web. It has 807 GitHub stars.

Is OpenBiliClaw safe to use?

Yes. OpenBiliClaw passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install OpenBiliClaw?

Clone the repository with "git clone https://github.com/whiteguo233/OpenBiliClaw" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is OpenBiliClaw written in?

OpenBiliClaw is primarily written in Python. It is open-source under whiteguo233 on GitHub, so you can review or fork the full source.

Are there alternatives to OpenBiliClaw?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh OpenBiliClaw against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

litellm-agent-platform swapper-toolkit

🦀 OpenBiliClaw

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

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

项目主页 | English | 中文

10 秒看懂 OpenBiliClaw

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

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

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

快速开始

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

安装浏览器插件：推荐从 Latest Release 的 openbiliclaw-v* 聚合页下载 openbiliclaw-extension-v*.zip 手动安装（版本最新；Firefox 用 openbiliclaw-extension-v*-firefox.zip）；也可从 Chrome 应用商店一键安装（自动更新，但受审核排期影响，版本可能滞后于 Releases）。
部署后端（两种方式，按需选一，都推荐）：
- 🖥️ 下载桌面安装包（最省事）：同一个 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 — 会丢关键指令)

在同一个浏览器登录内容平台：默认会用 B 站做初始化来源，也可以取消 B 站、改勾小红书 / 抖音 / YouTube / X / 知乎；初始化至少需要一个已登录且能取到信号的来源，勾选会同时开启该来源。
打开桌面端或移动端 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

	各平台官方推荐	关键词过滤插件	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 预览

安装与部署详情

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

1. 安装浏览器插件

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

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

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

打开 OpenBiliClaw Latest Release，也就是最新 openbiliclaw-v* 用户下载聚合页
Chrome / Edge / Brave 下载 openbiliclaw-extension-v*.zip；Firefox 下载 openbiliclaw-extension-v*-firefox.zip
打开扩展管理页面（Chrome：chrome://extensions/ · Edge：edge://extensions/ · Brave：brave://extensions/），开启右上角「开发者模式」
将下载的 .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 -