腾讯云开源的Octop，让全家共用一套AI助手

发表于 分类于 Waline： 阅读次数： 本文字数： 3.3k 阅读时长 ≈ 3 分钟
Octop 是一个自托管、多用户、多 Agent 的 AI 助手平台，支持 Web、多平台 IM 和定时任务。

简介

什么是 Octop ？

Octop 是腾讯云开源的自托管、多用户、多 Agent AI 助手平台。它可以运行在你自己的机器上，通过单进程同时提供 Web 控制台、CLI、以及飞书、钉钉、QQ、微信、Telegram、Discord、企微等 IM 接入，还支持定时定时任务。每个用户都可以拥有专属的专家级 Agent 团队，并可在不同场景间切换。

主要特点

  • 多用户专家团队：一个管理员账号即可管理整个家庭或团队，内置专家库和专家市场，可按需切换不同场景的专用助手
  • 多平台接入：通过 Web 面板、飞书、钉钉、QQ、微信、Telegram、Discord、企微等渠道，以及 HTTP/SSE/WebSocket 接口接入
  • MBTI 人格：内置 16 种 MBTI 人格模板和交互式测评，可让每个 Agent 拥有独特个性
  • AgentTeams：协调器可调度多个专家协同完成多步骤复杂任务
  • 安全内置：JWT 多用户隔离、工具审批、shell 命令防护和 PII 脱敏，数据始终留在本地
  • 连接器生态：内置腾讯文档、腾讯会议、腾讯新闻等连接器，支持 OAuth 和 MCP 网关扩展
  • 便携记忆：基于 Octop Memory 的分层记忆与全文检索，记忆随工作区迁移
  • 知识库：基于 RAG 的文档检索，可在部署内共享语料库，让答案基于你的私有数据
  • 远程桌面与浏览器 AI+：支持浏览器自动化、截图以及远程桌面控制，实现远程办公
  • 开源免费：基于 MIT 协议开源，可免费使用和修改

应用场景

  • 个人助理：让专属 Agent 帮你写周报、整理笔记、管理日程，记忆随工作区持续保留
  • 家庭共享：一个管理员账号供全家人使用，为每位成员分配不同的 Agent 与专家，可按需分享专家和知识库
  • 团队协作：通过 AgentTeams 或并行 Agent，接入飞书、钉钉、企微、微信，把任务路由进群聊处理
  • 开发者提效：通过 ACP 代理 OpenCode / Claude Code 处理编码任务，或在终端里用 AI 辅助排查问题
  • Web 自动化：使用浏览器 AI+ 和远程桌面完成表单填写、截图和 GUI 应用操作
  • 定时任务：用自然语言配置 cron，让 Agent 每天定时推送或执行任务

Octop 是一个把 AI 助手真正”私有化”的自托管平台，通过多 Agent 架构让个人、家庭和团队都能拥有一套既独立又协作的智能环境。

安装

在群晖上以 Docker 方式安装。

Octop 官方发布的容器镜像托管在 GitHub Container Registry（ghcr.io），由于群晖 Docker 套件无法直接搜索 ghcr.io 镜像，需要通过命令行拉取安装。

官方镜像地址：ghcr.io/tencentcloud/octop:latest

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 新建文件夹 octop 和 子目录
mkdir -p /volume1/docker/octop/data

# 进入 octop 目录
cd /volume1/docker/octop

# 运行容器（未设置 OCTOP_DEFAULT_PASSWORD）   
docker run -d \
   --restart unless-stopped \
   --name octop \
   -p 8348:8088 \
   -v $(pwd)/data:/data/.octop \
   -e HOME=/data \
   ghcr.io/tencentcloud/octop:latest

# 运行容器（设置 OCTOP_DEFAULT_PASSWORD）   
docker run -d \
   --restart unless-stopped \
   --name octop \
   -p 8348:8088 \
   -v $(pwd)/data:/data/.octop \
   -e HOME=/data \
   -e OCTOP_DEFAULT_PASSWORD=zx8JHDSgzYig \
   ghcr.io/tencentcloud/octop:latest

docker-compose 安装

将下面的内容保存为 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
version: '3.8'

services:
  octop:
    image: ghcr.io/tencentcloud/octop:latest  # 官方镜像（ghcr.io）
    container_name: octop
    restart: unless-stopped
    ports:
      - "8348:8088"                 # Web 控制台端口
    volumes:
      - ./data:/data/.octop         # 数据持久化
    environment:
      - HOME=/data                  # 容器内数据根目录
      - OCTOP_BIND_HOST=0.0.0.0     # 绑定所有网卡，便于端口转发
      - OCTOP_PORT=8088             # HTTP 监听端口
      - OCTOP_DEFAULT_PASSWORD=<你的强密码>  # 首次运行管理员密码
      - OCTOP_ADMIN_USERNAME=admin  # 管理员用户名

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 octop 和 子目录
mkdir -p /volume1/docker/octop/data

# 进入 octop 目录
cd /volume1/docker/octop

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:8348

首次

如果设置了 OCTOP_DEFAULT_PASSWORD 会看到登录界面

如果没有设置 OCTOP_DEFAULT_PASSWORD 则会进入设置向导

日志中可以找到启动密码

数据库默认 SQLite 即可

接下来设置管理员

接下来设置大模型，老苏还是选择的 SiliconFlow

目前硅基流动（SiliconFlow）注册就送 16 元代金券的活动还在

注册地址：

https://cloud.siliconflow.cn/i/NkUiXVhQ

只要设置 API Key 就行

设置完成后会进入主界面

启动完成之后就可以使用了

使用

在「专家」中创建专家 Agent、选择 MBTI 人格模板或导入共享专家

有了专家之后，可以按需在「频道」中接入飞书、钉钉、微信、Telegram 等 IM 平台

注意事项

  1. 端口与公网暴露：默认将端口绑定到 0.0.0.0，等于直接暴露到公网，建议改为内网访问或使用反向代理（Caddy / Nginx）加 HTTPS
  2. 密码策略：OCTOP_DEFAULT_PASSWORD 仅在首次启动时生效，之后修改该变量不会改变已创建管理员的密码；密码需至少 8 位且同时包含字母和数字
  3. 数据持久化：务必挂载 /data/.octop 目录，确保数据库、密钥、工作区和配置不会因容器重建而丢失
  4. 模型需自备：Octop 本身不包含大模型能力，需要在面板中配置 LLM 供应商的 API Key，或接入本地 Ollama
  5. 安全建议：使用强密码，并通过 HTTPS 反向代理访问；首次使用后可在设置中关闭 API 文档（默认关闭）

参考文档

A smarter, self-hosted AI assistant — multi-user, multi-agent.
地址：https://github.com/TencentCloud/Octop

Octop 中文 README
地址：https://github.com/TencentCloud/Octop/blob/main/README_CN.md

Octop/docker at main · TencentCloud/Octop
地址：https://github.com/TencentCloud/Octop/tree/main/docker

官方容器镜像（GitHub Packages）
地址：https://github.com/tencentcloud/Octop/pkgs/container/octop

Octop 官方网站
地址：https://octop.cloud