OpenBiliClaw‑for‑Mac是一套完整运行在macOS设备上的私有化AI内容发现Agent，区别于各大内容平台自带的推荐机制，整套服务全部在本机完成运算，浏览行为、点赞收藏记录、AI生成的心理画像全部存储在本地磁盘，不会上传至任何第三方服务器。现如今主流短视频与社区平台依靠浅层行为标签做内容推送，长期使用极易形成信息茧房，即便反复点击不感兴趣，算法依旧持续推送同质化内容，而OpenBiliClaw跳出标签化推荐逻辑，依靠大模型生成深层心理画像，主动跨平台挖掘潜在兴趣内容，Mac版本针对M系列芯片做Metal加速适配，提供菜单栏托盘、数据目录规范化管理，普通用户开箱即用，技术爱好者也可进行源码二次开发，兼顾隐私安全与内容发现能力。
为什么需要 OpenBiliClaw？
摆脱平台算法信息茧房束缚，平台仅根据点击、停留时长打浅层标签，越刷内容越单一，本工具从用户深层动机做兴趣挖掘，主动推送从未接触过的优质内容。
多平台兴趣打通融合，B站、小红书、抖音、知乎各个平台互相隔离，该工具汇总全部平台浏览行为，生成统一完整个人画像，打破平台之间的数据割裂问题。
100%本地数据保护隐私，浏览记录、收藏、画像数据库全部保存在Mac本机，不会把个人行为数据上传服务商服务器，规避用户行为数据泄露风险。
推荐逻辑完全透明可控，每一条推荐附带AI推理理由，支持正向、负向反馈，反馈直接回流画像引擎，持续迭代优化推荐效果，用户掌握推荐系统主导权。
适配本地大模型闭环运行，Mac M芯片对接Ollama本地大模型，不需要外网API，完全离线完成画像计算与内容推荐，进一步降低外部依赖。
OpenBiliClaw Mac版功能预览
| 功能模块 | 详细功能说明 |
| 五层灵魂心理画像引擎 | 事件‑偏好‑觉察‑洞察‑灵魂五层架构，跳出简单兴趣标签，解析用户深层心理诉求，画像全部本地SQLite存储 |
| 多平台内容源聚合 | Bilibili、小红书、抖音、知乎、Reddit等多数据源，支持自定义拓展网页源，统一输出推荐结果 |
| Mac专属后台能力 | 菜单栏常驻托盘，遵循macOS数据目录规范，配置热重载，无需重启程序即可更新API、Cookie参数 |
| 浏览器扩展交互面板 | 侧边栏展示推荐列表，采集浏览行为，提交正负反馈，一键执行初始化任务，支持Chrome、Edge等Chromium内核浏览器 |
| 命令行维护工具 | 提供db‑repair数据库修复、init画像初始化、recommend批量生成推荐等终端指令，方便高级用户维护项目 |
OpenBiliClaw Mac版硬件环境适配要求
Apple Silicon M1/M2/M3/M4：arm64预编译安装包原生支持，Metal硬件加速，性能表现最优，优先推荐该架构设备使用。
Intel x64架构Mac：无官方dmg预编译包，需要采用Docker容器或者源码编译方式部署，推理性能会有一定衰减。
内存最低8GB；对接本地Ollama大模型场景，建议内存提升至16GB及以上，避免内存溢出程序闪退。
磁盘预留≥5GB空间，用于存放SQLite画像数据库、向量嵌入缓存、平台抓取素材缓存。
系统版本要求macOS 13 Ventura及以上，旧版本macOS会出现端口监听、权限异常等兼容问题。
OpenBiliClaw Mac版安装与部署详情
方案一：Mac桌面App安装（普通用户首选）：前往GitHub Releases下载OpenBiliClaw‑macos‑xxx.zip压缩包，解压得到OpenBiliClaw.app；右键选择打开，绕过macOS公证隔离，终端也可执行命令
xattr -dr com.apple.quarantine /Applications/OpenBiliClaw.app清除隔离属性；启动之后程序驻留顶部菜单栏，默认监听本地127.0.0.1:8420端口。方案二：Docker容器部署：Mac安装Docker Desktop，拉取项目官方镜像，修改容器映射端口与本地数据持久化目录，容器后台启动，数据挂载至本机目录，升级仅需要重新拉取镜像，不受本机Python环境干扰。
方案三：GitHub源码编译部署（开发者）：git clone拉取项目仓库，配置uv/Python运行环境，安装项目全部依赖，执行openbiliclaw start启动后端服务；适合需要修改源码、自定义拓展数据源的技术使用者。
配套浏览器扩展安装：下载extension扩展压缩包，浏览器开启开发者模式，加载已解压扩展包；扩展作为交互入口，负责采集浏览行为、展示推荐结果、填写API密钥与平台Cookie，参数保存后自动热重载，不需要重启Mac后端程序。
初始化完整流程：后端与扩展全部部署完毕，在扩展设置填入LLM大模型API密钥，导入平台Cookie，点击初始化init，程序读取浏览历史生成五层心理画像，初始化完成后即可获取AI生成的推荐内容。
Mac部署过程高频报错问题处理
| 故障现象 | Mac端处理方案 |
| 提示App已损坏无法打开 | 右键打开应用，前往系统设置‑隐私与安全性允许运行；或者终端执行xattr命令清除隔离属性 |
| 浏览器扩展提示连接拒绝 | 确认菜单栏后端程序正常运行，检查8420端口没有被其他软件占用，关闭防火墙拦截本地回环地址 |
| mac休眠后推荐任务停止 | Mac休眠会暂停后台进程，使用Amphetamine阻止系统休眠，或者系统设置关闭自动休眠 |
| 数据库损坏初始化失败 | 终端执行openbiliclaw db‑repair命令修复SQLite数据库，修复前手动备份Application Support下项目数据目录 |
OpenBiliClaw Mac版合规使用注意事项
项目处于公开预览迭代阶段，数据库建议定期手动备份，防止程序异常造成画像数据丢失。
导入平台Cookie仅本机会话使用，Cookie不会向外网传输，需要定期更新避免会话失效。
本工具仅限个人学习研究，禁止大规模批量爬虫采集平台数据，防止触发平台风控导致账号受限。
接入第三方大模型API会产生调用消耗，候选池内容越多，接口调用频次越高，需要留意服务商额度。
不要将后端8420端口对公网暴露，避免本地画像数据库被外部非法访问。
