部署

自己托管一个多用户多 Agent 的 AI 助手：腾讯云 Octop 开源部署实战

2026.07.27· 7 个步骤 · 22 分钟阅读· 🐙 腾讯 Octop

市面上的 AI 助手大多有三个通病：记不住你、搞不定一家人、接不进你的生活。2026 年 7 月 21 日，腾讯云把自研的 AI 助手 Octop 正式开源——它源自此前的 LightClaw ACE，定位是一个开源、自托管、多用户、多 Agent 的家庭与团队 AI 助手平台。名字取自章鱼（Octopus）：八爪并展、多任务并行。本教程带你在自己的服务器上把它跑起来，一家人 / 一个团队共用一个会记忆、能成长的 AI。

🐙 本教程适合：想数据自主权在自己手里、需要多人共用 AI 的个人站长、小微团队、家庭用户。你需要一台能装 Docker 的 Linux 服务器（或本地 NAS / 电脑），以及基本的命令行操作能力。

先搞懂：Octop 和你用的云端助手有何不同？

Octop 的核心差异在"自托管 + 多用户 + 多 Agent"。数据存在你自己的机器上，不依赖单一厂商；一个管理员可以给全家或全团队开子账号；每个成员又能挂多个专长 Agent（专家团）。

能力	传统云端助手	Octop（自托管）
数据存储	厂商云端	你的服务器，主权回归
多人共用	通常一人一账号	管理员开多用户子账号
多 Agent	单一对话	可挂多个专长专家 Agent
记忆	换机清零	持久化，跨设备连续

硬件门槛：Octop 跑大模型推理需要一定算力。轻量体验可用一台 16G 内存的小主机 + 接入云端大模型 API（只把"记忆与编排"留本地）；要完全离线跑模型则需 GPU 机器。本教程先用"本地编排 + 云端模型 API"的折中方案，性价比最高。

Step 1：准备服务器与基础环境

1 装好 Docker 与 Docker Compose

# 以 Ubuntu 22.04 为例
sudo apt update
sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable --now docker

# 验证
docker --version
docker compose version

💡 没有独立服务器？本地电脑装 Docker Desktop、或用群晖 / 威联通 NAS 的容器管理器也行，步骤一致。

Step 2：拉取 Octop 仓库并启动

2 一行命令拉起整套服务

git clone https://github.com/TencentCloud/Octop.git
cd Octop
cp .env.example .env          # 先复制配置模板
docker compose up -d         # 后台启动所有组件

# 查看状态
docker compose ps

端口冲突：默认 Web 端口可能是 8080，若被占用，编辑 .env 里的 WEB_PORT 改掉再重启。首次启动会拉取镜像，耐心等一两分钟。

Step 3：配置管理员与模型供应商

3 让 Octop 接上"大脑"

Octop 本身不生产模型能力，需要配置一个大模型供应商的 API Key（国内可选智谱 GLM、DeepSeek、通义千问等，注册简单有免费额度）：

# 编辑 .env，填入你的模型配置
MODEL_PROVIDER=deepseek
MODEL_API_KEY=sk-xxxxxxxxxxxxxxxx
MODEL_NAME=deepseek-chat

# 改完重启生效
docker compose restart

🔑 打开浏览器访问 http://你的服务器IP:端口，按引导创建第一个管理员账号。这个账号拥有开子账号、管 Agent 的最高权限，密码务必设强。

Step 4：邀请家人 / 团队成员

4 一个管理员，全家共用

1. 用管理员登录，进入「用户管理」
2. 点「新建用户」，填写成员邮箱 / 昵称
3. 设置角色：普通成员 or 受限成员（如给孩子开只读版）
4. 把登录链接或邀请码发给对方
5. 对方用自己的账号登录，记忆互不干扰

记忆隔离是底线：多用户平台最怕把全家人的对话搅成一锅粥。Octop 每个子账号记忆独立。千万别图省事让多人共用同一个账号——隐私会串线。

Step 5：接入你的生活数据源

5 让 AI 读得进你的资料

Octop 的价值在于"接进你的生活"。在「连接器 / Connectors」里把常用数据源接上：

可接入的数据源示例：
· 腾讯文档 / 飞书文档（读团队资料）
· 本地文件夹（家庭相册、账单 PDF）
· 日历（自动提醒与日程问答）
· 网页爬虫（追热点、看新闻）

接入后，Agent 回答会基于这些真实资料，而不是瞎编。

🚀 接数据源时遵循最小权限：只授权 AI 真正需要的目录，别把整个硬盘开放出去。这是自托管的安全基本盘。

Step 6：创建你的专属专家 Agent

6 八爪并展，分任务挂专家

在「Agent 管理」里新建几个专长 Agent，例如：
· 财务管家：读账单 PDF，每月自动出开销分析
· 学习辅导：绑定教材资料，辅导孩子作业
· 团队秘书：读飞书文档，自动写周报和待办

每个 Agent 配好人设 + 知识范围 + 可调用工具，
家庭成员按需呼叫不同专家。

🔑 这就是 Octop 说的"多用户多专家团"——一个管理员开账号，每个账号再挂多个 Agent，像章鱼八爪各管一摊。

Step 7：备份与日常维护

7 让数字生命体可持续成长

# 定期备份数据卷（记忆与配置最宝贵）
docker compose stop
tar czf octop-backup-$(date +%F).tar.gz ./data
docker compose start

# 升级到新版本
git pull
docker compose up -d --build

备份优先：自托管最大的好处是数据在你手里，最大的责任也是——没人替你兜底。务必定时备份 data 卷，否则服务器故障 = 全家记忆清零。

常见问题速查

你遇到的现象	大概率原因 & 解决
页面打不开	检查防火墙是否放行端口，或 docker compose ps 看服务是否起来
AI 不回答	Step 3 的 API Key 没配好或未充值
成员记忆串了	确认每人独立子账号，不要共用登录
升级后异常	先备份 data 卷，再 git pull + rebuild

📚 更多教程 📰 智能体资讯