腾讯开源 Octop 实操：用 Docker 在家里的 Ubuntu 服务器上搭一个全家共用的 AI 助手，接微信、飞书、钉钉

9次阅读

家里有台常年开着的 Ubuntu 小服务器，我一直想在上面放一个「全家都能用」的 AI 助手：我拿它写周报、查资料，家里人在微信里问它问题，每天早上它自己把新闻摘要推到群里。以前要么自己拼一堆开源项目，要么只能用各家的网页版，聊天记录和资料都在别人服务器上。

腾讯云开源的 Octop 就是干这个的。它是一个自托管的 AI 助手平台，支持多用户、多 Agent，能接微信、企业微信、飞书、钉钉、QQ，自带定时任务、知识库、浏览器自动化、网页终端和远程桌面。项目用 MIT 协议，7 月才建仓库，到 10 月 20 日 GitHub 上已经有 1 万多星（10,282），最新版本是 10 月 18 日发布的 v1.0.2。

这篇讲怎么用 Docker 把它装到家里的 Ubuntu 服务器上，以及我觉得它好在哪、坑在哪。安装命令和配置项都照着官方 README、Docker 说明和用户文档整理，查阅时间是 2026 年 10 月 20 日。

腾讯开源 Octop 实操：用 Docker 在家里的 Ubuntu 服务器上搭一个全家共用的 AI 助手，接微信、飞书、钉钉 — Octop 的 Web 控制台：左侧是对话、专家、连接器、通道、终端 AI+、浏览器 AI+、远程桌面等入口（截图来自 GitHub 仓库，版本比 v1.0.2 早）

Octop 能做什么

一个管理员，全家共用：用户之间用 JWT 认证隔离，每个人可以建好几个「专家」（Agent），各自有自己的工作区、模型、通道和定时任务。
在常用的聊天软件里用：飞书、钉钉、QQ、微信、企业微信都能接，Web 控制台默认就有，还有 HTTP / SSE / WebSocket API。
专家库和 MBTI 人格：内置写作、编程、数据分析等专业角色模板，一键创建；还有 16 种 MBTI 人格模板给 Agent 定性格。
定时任务：用自然语言配 Cron，让 Agent 每天按时推送或执行任务。
知识库：上传文档做 RAG 检索，回答会参考你自己的资料，同一个实例里还能共享语料。
浏览器 AI+、终端 AI+、远程桌面：基于 Chromium 的无头浏览器做网页自动化和截图，浏览器里开一个交互式 Shell 让 AI 帮你排障，还能在控制台里看屏、操作键鼠。
连接器和 ACP：通过 OAuth / MCP 接腾讯文档、腾讯会议、Notion、滴答清单、Obsidian、Dify 等服务；通过 ACP 把编程任务交给 OpenCode、CodeBuddy、Claude Code、Codex。

它本身是一个 Python 写的单进程程序（FastAPI），不需要另外装消息队列。默认用 SQLite 存数据，全部放在 ~/.octop/ 目录里，也可以换成 PostgreSQL（官方标着内测）。

部署前要准备什么

一台 Linux 机器：官方没给最低配置，只写了「现代多核 CPU，预留数 GB 内存给进程和模型 / Embedding 缓存」，磁盘要放得下数据库、Agent 工作区和文档。Docker 镜像有 amd64 和 arm64 两种，x86 小主机和 ARM 盒子都能用。
Docker 和 Compose 插件：先确认 docker compose version 能输出版本号。没装的话，按 Docker 官方文档给 Ubuntu 装 Docker Engine。
一个大模型：Octop 本身不带模型，要你自己提供。预设里有 OpenAI、Anthropic、DeepSeek、智谱、Kimi、Ollama，其他 OpenAI / Anthropic 兼容的服务可以用「自定义」接。想全本地跑，可以在同一台机器上装 Ollama。

用 Docker 部署（Ubuntu）

官方仓库的 docker/ 目录里有两个 Compose 文件：

docker-compose.yml：在本机从源码构建镜像，第一次要下载不少依赖，比较慢。
docker-compose.cn.yml：不构建，直接拉南京大学 GHCR 镜像站上的成品镜像 ghcr.nju.edu.cn/tencentcloud/octop:latest，官方建议在拉不动 ghcr.io 时用它。

国内家宽我建议直接用 cn 版。

第 1 步：拉代码。

git clone https://github.com/TencentCloud/Octop.git
cd Octop

第 2 步（可选）：预设管理员密码。在 docker/ 目录里建一个 .env 文件：

OCTOP_PORT=8088
OCTOP_ADMIN_USERNAME=admin
OCTOP_DEFAULT_PASSWORD=换成你自己的强密码

密码至少 8 位，必须同时有字母和数字。设了合格的密码，首次启动会自动建好管理员，凭据写进数据目录里的 credential.txt。不设（或密码不合格）也没关系，打开网页会进设置向导，自己在向导里设密码。

第 3 步：启动。

# 国内镜像，不本地构建（推荐国内用）
docker compose -f docker/docker-compose.cn.yml up -d

# 或者：本地从源码构建
docker compose -f docker/docker-compose.yml up -d --build

Compose 默认把宿主机的 ~/.octop 挂到容器里的 /data/.octop，配置、数据库和 Agent 工作区都在这个目录里，删容器不会丢数据。想换个目录，在 .env 里加一行 OCTOP_DATA=/你的路径。

第 4 步：确认服务起来了。

curl http://localhost:8088/api/health
docker logs -f octop

第 5 步：打开控制台。在局域网里的电脑上访问 http://服务器IP:8088。如果第 2 步没设密码，会先让你输入一次性的「设置密码」，用下面这条命令看：

docker exec octop cat /data/.octop/octop-login.txt

设置向导一共五步：设置密码 → 选数据库（默认 SQLite，直接「保存并继续」）→ 创建管理员 → 配模型（可以先跳过）→ 完成。走完就自动登录进控制台了。

我没有在 Docker 里装，只在另一台 Linux 上用 pip install octop 装了 1.0.2 跑了一遍：首次启动时终端会打印一次性向导口令，/api/health 正常返回，打开网页就是这五步向导，和文档说的一致。

配模型、接聊天软件

模型：在向导或「设置 → 模型」里选预设，填 API Key 和 Base URL，勾选要用的模型，点「测试连接」。每个 Agent 可以用不同的模型，比如日常聊天用便宜的，写代码用强一点的。找便宜模型可以看本站刚写的 MiniMax M3.1 Flash 快讯。

聊天通道：在控制台「通道」页添加。各平台需要的东西：

通道	需要准备
飞书	App ID、App Secret
钉钉	App Key、App Secret
企业微信	Corp ID、Agent Secret
QQ	Bot AppID、Token
微信	扫码绑定（走微信 iLink 接口）

飞书、钉钉、企业微信和 QQ 都要先去各自的开放平台建一个机器人应用，拿到凭证再填进来。CLI 里也有 octop channel feishu-setup 和扫码绑定企业微信 / 微信的命令。

定时任务：在「定时任务」页可视化新建，比如「每天早上 8 点总结一下今天的 AI 新闻发到家庭群」。

升级和备份

用 cn 版 Compose 的话，升级就是拉新镜像再重建容器：

docker compose -f docker/docker-compose.cn.yml pull
docker compose -f docker/docker-compose.cn.yml up -d

用源码构建的，先 git pull，再执行一次 docker compose -f docker/docker-compose.yml up -d --build。数据库结构会在下次启动时自动迁移。官方提醒跨版本升级前一定要先备份，Docker 部署最省事的做法是升级前把宿主机的 ~/.octop 整个复制一份。

用下来，优点和缺点

我觉得好的地方：

一个程序全包了：控制台、聊天通道、定时任务、知识库都在一个进程里，不用自己拼一堆服务。
适合家庭和小团队：多用户隔离做得比较完整，管理员一个人维护，家里每个人有自己的 Agent 和记录。
对国内聊天软件友好：飞书、钉钉、企业微信、QQ、微信都是官方支持的，这一点很多国外项目做不到。
数据在自己手里：对话、工作区和凭据都在本机 ~/.octop/，模型可以随时换，也能接本地 Ollama。
MIT 协议：个人和公司都能放心用、改。

要注意的地方：

项目很新、更新很快：仓库 7 月才创建，10 月中旬还在发 beta 版。AgentTeams 标着 Beta，PostgreSQL 标着内测，移动端还在内测。遇到问题可能要自己去 GitHub 提 issue。
它能执行命令，千万别直接暴露到公网：Octop 自带 Shell、网页终端、浏览器自动化和远程桌面，账号一旦被人拿到，风险比普通网站大得多。官方也提醒要尽快改掉初始密码。我的做法是只在局域网用，外面要访问就走 VPN 或组网工具，不做端口映射。设置里有 Shell 命令护栏和工具审批，建议打开看一遍。
模型费用要自己出：Octop 免费，但它调用的模型要么花 API 钱，要么在本机跑 Ollama（吃显卡和内存）。定时任务和 Agent 跑起来，Token 消耗可能比你想的多。
每个聊天平台都要单独申请机器人：接飞书、钉钉、企业微信，都得先去开放平台建应用，第一次配会花点时间。
知识库不是开箱即用：Docker 镜像里已经装了本地 Embedding 和 OCR 依赖，但不会自动下载模型权重，也不会自动开启知识库，要自己在控制台里设置。

适合谁

适合：家里有 NAS 或小主机、想给全家或几个同事搭一个共用 AI 助手的人；常用飞书、钉钉、企业微信，想让 AI 直接在群里干活的小团队。
不太适合：只想自己一个人聊天的人，直接用各家网页版或 App 更省事；不想维护服务器、也不想管 API 费用的人。

如果你要给家里人分配模型额度、统一管理一堆 API Key，可以在前面加一个 New API 自建网关。服务器上服务多了，再用 Uptime Kuma 盯着它有没有挂掉。想要偏个人办公的 Agent 工作台，也可以看看 PilotDeck 2。

项目信息

开发者：腾讯云（GitHub 组织 TencentCloud）
最新版本：v1.0.2（2026 年 10 月 18 日）
授权：MIT，免费开源
部署方式：Docker、一键安装脚本（macOS / Linux / Windows）、PyPI（pip install octop）、桌面客户端、飞牛 NAS 安装包
默认端口：8088；数据目录：~/.octop/
仓库：TencentCloud/Octop｜中文 README｜Docker 部署说明｜用户帮助文档