腾讯开源自托管 AI 助手 Octop:全家人共用一个 AI 管家

腾讯云开源的 Octop，一条命令部署，数据全在自己手里，还能接飞书、指挥 Claude Code 干活。

最近刷 GitHub 的时候，看到一个腾讯云开源的项目热度不低——Octop。

官方给它的定义挺有意思：一个更智能的自托管 AI 助手，支持多用户、多 Agent。说白了，就是你可以把它部署在自己的电脑或服务器上，给全家人（或者小团队）每人配一个专属 AI 专家，所有对话和数据都留在本地，不经过任何第三方。

这事儿戳中的痛点很实际：现在大模型能力是够用了，但聊天记录、家庭日程、私人文档全传到别人服务器上，心里总有点不踏实。

项目地址：https://github.com/TencentCloud/Octop

Octop 项目横幅：自托管 AI 助手概念图

一、Octop 到底是个啥

Octop 不只是个聊天机器人，官方管它叫"可以并行运作的数字生命体"。听着玄乎，拆开看就三件事：

单进程跑全部。一条 octop run 命令，Web 控制台、命令行工具、IM 渠道集成全部就绪，不用折腾一堆微服务。

数据不出门。所有对话、工作区、凭证默认存在 ~/.octop/ 目录，控制面数据库用的 SQLite，想要更强也可以换 PostgreSQL。

多渠道对话。Web 面板、飞书、钉钉、QQ、Discord、企业微信都能聊，开发者还可以走 HTTP/SSE/WebSocket 编程接入。

自托管不是"自己找罪受"，而是把 AI 的控制权拿回自己手里。

Octop 架构：单进程整合 Web、IM、定时任务

二、核心功能盘点

功能不少，挑几个最有意思的讲：

1. 多用户专家团队

一个管理员账号，全家共享。内置专家库，按场景切换不同的专家 Agent——写周报用运营专家，写代码用技术专家，各自独立工作区互不干扰。

2. MBTI 人设系统

16 种人格模板，还有互动测试题。想让你家 AI 助手是 INTJ 还是 ENFP，自己选。每个 Agent 性格分明，对话体验确实不一样。

3. 安全内建

JWT 多用户隔离、工具调用审批、Shell 命令防护、PII 脱敏，这些不是可选项，是默认就有。家里小孩用也不怕乱执行命令。

4. 知识库（RAG）

上传自己的文档，Agent 回答时基于你的私有语料做语义检索。家里的体检报告、孩子的错题本、团队的项目文档，都能变成 AI 的"脑内存"。

5. 终端 AI+ 和浏览器 AI+

浏览器里直接开交互式 Shell，AI 辅助执行命令、排查报错；还有无头 Chromium 自动化，网页操作、截图、信息采集都能交给它。

6. ACP 双向对接

这块对开发者很香：Octop 既能被 IDE 当 Agent 用，也能反过来把编码任务委托给 OpenCode、Claude Code、CodeBuddy、Codex，权限门槛全程可控。

核心功能矩阵：专家团队、MBTI、RAG、ACP

三、安装教程

三选一，按自己习惯来。

方式一：一行命令（推荐）

macOS / Linux：

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

Windows（PowerShell）：

irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex

安装器通过 uv 自动在隔离环境里配好 Python 3.12，不需要预装任何依赖。装完重开终端就能用。

方式二：pip 安装

pip install octop

方式三：Docker 部署（生产推荐）

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

不想碰终端的，还有桌面客户端：Windows / macOS / Linux / 飞牛 NAS 全支持，去 GitHub Releases 下载安装包就行。

三种安装方式对比图

四、初始化与启动

两步搞定：

octop init    # 交互式初始化：建库、生成密钥、创建管理员账号 octop run     # 启动服务

打开 http://127.0.0.1:8088 就能看到 Web 控制台。想让它常驻后台，用 octop service start 注册成系统服务。

密码要求：至少 8 位，字母加数字，纯弱密码会被直接拒掉。

五、真实使用示例

光讲功能不过瘾，来三个真实场景。

示例 1：飞书接入，家庭共享 AI 管家

安装时带上飞书扩展：

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash -s -- --extras channels-feishu

在控制台 Channels 页面配好飞书应用凭证，之后家人在飞书里 @机器人 就能对话。管理员给每个成员分配不同 Agent：爸爸用"代码专家"，妈妈用"生活助手"，孩子用"学习辅导"，数据互相隔离。

示例 2：ACP 委托 Claude Code 写代码

在控制台 /acp 页面配置 runner（内置 OpenCode、CodeBuddy、Claude Code、Codex），给 Agent 开启 acp_runner 后，聊天框里直接说"帮我重构这个项目的登录模块"，任务就会委托给外部编码 Agent 执行。

反向也行：octop acp --agent main 启动 stdio ACP 服务，Zed、OpenCode 这些 IDE 工具就能直接用你的 Octop Agent 当后端。

示例 3：自然语言配置定时任务

在控制台 Cron 页面用自然语言描述："每天早上 8 点把昨天的 AI 新闻整理成摘要推送到飞书"，Agent 自动创建定时任务并按时执行，不用写一行 cron 表达式。

三个使用场景：飞书家庭共享、ACP 编码、定时任务

六、技术架构速览

给技术读者一份速查：

• Python 3.12+ / FastAPI + uvicorn / React 18 + TypeScript + Ant Design
• 基于 Harness 技术栈：harness-agent（Agent 运行时）、harness-gateway（IM 网关）、harness-memory（可迁移记忆）、harness-browser（浏览器自动化）
• 控制面数据库：SQLite（WAL）或 PostgreSQL
• MIT 开源协议

写在最后

翻了下 Roadmap，后面还有专家共享、Agent 团队编排、自我进化（把日常对话蒸馏成可复用技能）以及 PC / 移动端原生客户端，方向是往"越来越像真管家"走的。

如果你想要一个数据完全在自己手里、能接飞书钉钉、还能指挥 Claude Code 干活的家庭 AI 管家，Octop 值得花一个下午折腾试试。

项目地址：

https://github.com/TencentCloud/Octop