OpenBiliClaw部署指南从Docker Compose到HTTPS公网域名只需两条命令【免费下载链接】OpenBiliClaw本地私有、开源的自进化跨平台 AI 内容发现 Agent从使用、反馈和对话中理解你主动从 B 站、小红书、抖音、YouTube、X、知乎、Reddit、Linux.do、Bangumi、V2EX、微博、GitHub 与开放 Web 寻找内容。支持浏览器插件、桌面与移动端以及 DeepSeek Harness 插件。项目地址: https://gitcode.com/whiteguo233/OpenBiliClawOpenBiliClaw 是一个本地私有、开源的自进化跨平台 AI 内容发现 Agent它从你的浏览、反馈和对话中理解你然后主动到 B 站、小红书、抖音、YouTube、X、知乎、Reddit、GitHub 等十几个平台为你找内容。这篇部署指南将带你用 Docker Compose 两条命令跑起后端再用一条叠加配置升级为 HTTPS 公网域名访问新手友好、无坑讲解。OpenBiliClaw 是什么10 秒看懂一句话信号进来 → 生成你的口味画像 → 带理由推荐 → 反馈学习闭环。所有数据默认留在本机 SQLite不上传第三方服务器。部署完成后你可以通过以下入口使用它桌面 Webhttp://127.0.0.1:8420/web手机 Web / PWAhttp://电脑局域网 IP:8420/m/扫码保存为桌面图标即可当 App 用浏览器插件连接同一后端收藏、点赞等行为会自动成为画像信号部署前置条件只需 3 样东西前置项说明Docker 20.10 与 Docker Compose V2docker compose命令可用即可一个 LLM API KeyDeepSeek / OpenAI / Gemini / Claude 等任选其一DeepSeek 国内直连、月费通常 ¥0.5-2无需单独申请 Embeddingcompose 自带 Ollama sidecarbge-m3 模型已烤进镜像离线开箱即用平台覆盖 macOSIntel/Apple Silicon、Linux x86_64/ARM含树莓派、WindowsDocker Desktop WSL2同一份 docker-compose.yml 直接跑多架构镜像自动匹配。两条命令完成 Docker Compose 部署命令一克隆并启动git clone https://gitcode.com/whiteguo233/OpenBiliClaw cd OpenBiliClaw docker compose up -d --build启动后会自动拉起两个容器openbiliclaw-backend后端端口 8420和openbiliclaw-ollama嵌入模型 sidecar。配置、数据、日志分别存放在openbiliclaw_config、openbiliclaw_data、openbiliclaw_logs三个 named volume 里容器删了数据也不丢。接着打开图形化引导页http://127.0.0.1:8420/setup/完成 LLM 配置与前置条件真实校验——它和桌面安装包是同一套向导。命令二生成用户画像initdocker exec -it openbiliclaw-backend openbiliclaw init⚠️ 容器内 Web 的「开始初始化」按钮是禁用的Docker 运行时会拒绝网页发起的初始化报unsupported_runtime初始化必须在宿主机用上面这条docker exec命令执行。这是新手最容易卡住的一步。init 会根据你在/setup/里选择的来源B 站 / 小红书 / 抖音 / YouTube / X / 知乎 / Reddit / Linux.do / Bangumi / V2EX / 微博 / GitHub拉取行为信号并生成画像。需要账号态的来源如 B 站、小红书要在装了扩展的浏览器里先登录对应站点Bangumi 与 GitHub 的公开发现则完全匿名、无需登录。部署成功验证docker compose ps # 两个容器都是 healthy curl http://127.0.0.1:8420/api/health健康检查里profile_ready字段为true即表示画像已就绪。此时打开http://127.0.0.1:8420/web就能看到为你定制的推荐流升级为 HTTPS 公网域名Caddy 自动证书想让手机、远程电脑通过公网域名访问而不是局域网 IP仓库自带的 docker-compose.https.yml 叠加 Caddy自动完成证书申请、续期和 WebSocket 反代浏览器直接信任。前置条件一个公网 DNS 名称如obc.example.comA 记录指向服务器防火墙 / 云安全组放行 TCP80/443Docker Compose 2.24.4overlay 用!override精确替换端口核心就两条命令export OPENBILICLAW_DOMAINobc.example.com # 只填 DNS 名称不带协议、端口 docker compose -f docker-compose.yml -f docker-compose.https.yml up -d --buildoverlay 会把后端8420收紧到宿主机 loopback公网只暴露80/443Caddy 仅信任来自127.0.0.1的转发头。再补 3 条安全门禁命令公网暴露前必做Caddy 在密码门禁启用前不会监听公网端口天然杜绝裸奔窗口docker exec -it openbiliclaw-backend openbiliclaw set-password # 设置 Web 登录密码 docker restart openbiliclaw-backend docker restart openbiliclaw-caddy完成后各入口地址变为入口地址PC 桌面 Webhttps://obc.example.com/web手机 Web / PWAhttps://obc.example.com/m/浏览器插件协议 HTTPS、主机obc.example.com、端口443需远程插件时再执行openbiliclaw ext-key generateenable生成设备密钥桌面 Web 的手机版二维码会保留当前 HTTPS 域名扫码不会再退回私网 IP 或明文 HTTP常见问题速查Q: 后端健康检查通过但插件里没有推荐最常见原因是没跑 init。执行docker exec -it openbiliclaw-backend openbiliclaw init即可。Q: 如何升级到最新版本git pull docker compose up -d --buildDockerfile 已做依赖分层依赖没变时重建只需数秒。注意镜像构建时打包代码git pull后必须加--build。Q: 端口 8420 被占用改 docker-compose.yml 中端口映射为9090:8420即可。Q: 数据如何备份先停后端再冷拷贝避免运行中的 SQLite 与 WAL 被拆开docker compose stop openbiliclaw-backend docker cp openbiliclaw-backend:/app/runtime/data ./backup-data docker compose start openbiliclaw-backend更多部署资料本文覆盖了最常用路径完整细节可查项目文档Docker 部署完整指南含预构建镜像、一行安装脚本、代理配置docs/docker-deployment.mdHTTPS / TLS 部署含局域网 TLS Proxy 方案docs/https-deployment.md配置文件参考config.example.toml端口与密码门禁原理docs/modules/api-auth.md部署完成后OpenBiliClaw 会随着你的每一次喜欢 / 不感兴趣 / 聊一句持续进化——用得越久推荐越懂你。【免费下载链接】OpenBiliClaw本地私有、开源的自进化跨平台 AI 内容发现 Agent从使用、反馈和对话中理解你主动从 B 站、小红书、抖音、YouTube、X、知乎、Reddit、Linux.do、Bangumi、V2EX、微博、GitHub 与开放 Web 寻找内容。支持浏览器插件、桌面与移动端以及 DeepSeek Harness 插件。项目地址: https://gitcode.com/whiteguo233/OpenBiliClaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考