企业官网建设流程全解析

OpenBiliClaw部署指南：从Docker Compose到HTTPS公网域名，只需两条命令

【免费下载链接】OpenBiliClaw本地私有、开源的自进化跨平台 AI 内容发现 Agent：从使用、反馈和对话中理解你，主动从 B 站、小红书、抖音、YouTube、X、知乎、Reddit、Linux.do、Bangumi、V2EX、微博、GitHub 与开放 Web 寻找内容。支持浏览器插件、桌面与移动端，以及 DeepSeek Harness 插件。项目地址: https://gitcode.com/whiteguo233/OpenBiliClaw

OpenBiliClaw 是一个本地私有、开源的自进化跨平台 AI 内容发现 Agent：它从你的浏览、反馈和对话中理解你，然后主动到 B 站、小红书、抖音、YouTube、X、知乎、Reddit、GitHub 等十几个平台为你找内容。这篇部署指南将带你用 Docker Compose 两条命令跑起后端，再用一条叠加配置升级为 HTTPS 公网域名访问，新手友好、无坑讲解。

OpenBiliClaw 是什么：10 秒看懂

一句话：信号进来 → 生成你的口味画像 → 带理由推荐 → 反馈学习闭环。所有数据默认留在本机 SQLite，不上传第三方服务器。

部署完成后，你可以通过以下入口使用它：

• 桌面 Web：http://127.0.0.1:8420/web
• 手机 Web / PWA：http://<电脑局域网 IP>:8420/m/（扫码保存为桌面图标即可当 App 用）
• 浏览器插件：连接同一后端，收藏、点赞等行为会自动成为画像信号

部署前置条件：只需 3 样东西

平台覆盖 macOS（Intel/Apple Silicon）、Linux x86_64/ARM（含树莓派）、Windows（Docker 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 配置与前置条件真实校验——它和桌面安装包是同一套向导。

命令二：生成用户画像（init）

docker 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.com），A 记录指向服务器
• 防火墙 / 云安全组放行 TCP80/443
• Docker Compose 2.24.4+（overlay 用!override精确替换端口）

核心就两条命令：

export OPENBILICLAW_DOMAIN=obc.example.com # 只填 DNS 名称，不带协议、端口 docker compose -f docker-compose.yml -f docker-compose.https.yml up -d --build

overlay 会把后端8420收紧到宿主机 loopback，公网只暴露80/443，Caddy 仅信任来自127.0.0.1的转发头。

再补 3 条安全门禁命令（公网暴露前必做，Caddy 在密码门禁启用前不会监听公网端口，天然杜绝"裸奔窗口"）：

docker exec -it openbiliclaw-backend openbiliclaw set-password # 设置 Web 登录密码 docker restart openbiliclaw-backend docker restart openbiliclaw-caddy

完成后各入口地址变为：

桌面 Web 的手机版二维码会保留当前 HTTPS 域名，扫码不会再退回私网 IP 或明文 HTTP：

常见问题速查

Q: 后端健康检查通过，但插件里没有推荐？最常见原因是没跑 init。执行docker exec -it openbiliclaw-backend openbiliclaw init即可。

Q: 如何升级到最新版本？

git pull && docker compose up -d --build

Dockerfile 已做依赖分层，依赖没变时重建只需数秒。注意：镜像构建时打包代码，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.md
• HTTPS / 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