夜雨聆风学习资料网

ARTICLE · 1123596

一条命令把全家 AI 助手搬回家,腾讯 Octop 实测可用

一条命令把全家 AI 助手搬回家,腾讯 Octop 实测可用
✦ 引言
腾讯开源的自托管 AI 助手平台,一条 Docker 命令起服务,全家每人一个专属助手:育儿健康理财专家开箱即用,微信里就能使唤,数据留在自己机器上。

5,890 颗星、2026 年 7 月才建仓,腾讯云把自己在用的 AI 助手平台 Octop 开了源。家里想一起用 AI 的,多半卡在同一件事上:聊天记录、孩子的事交给大厂服务器不放心,一人订一套又花冤枉钱。Octop 的解法是自托管:一条 Docker 命令把服务起在自己机器上,全家人各领一个专属助手,育儿、健康、理财专家开箱即用,微信里发消息就能使唤。它最值钱的地方一句话就能说完:把全家共享的自托管 AI,打包成了能直接用的产品。

一、它是什么,能干什么

Octop 是腾讯云官方开源的自托管 AI 助手平台(GitHub: TencentCloud/Octop),MIT 协议,要求 Python 3.12 以上,9 月 30 日还在推送代码。它要解决的痛点很具体:全家想用 AI,但数据散在多家平台、订阅各花各的钱、孩子和家人的信息谁也统一管不了。

装好打开是一个全中文控制台,左侧导航二十多个模块,会话、专家、技能、定时、用户分门别类,第一次打开也不会迷路。能力的底子一句话能说清:按人、按事分发。谁用哪个专家、干什么活、几点干,全部分开管。

图注:全中文控制台首页,二十多个模块一眼能找齐,不用翻文档

二、每人一个专属专家,长辈不用学提示词

专家是 Octop 的核心单位:带人设、带记忆、能配技能的专属助手。后台内置 17 个中文模板,育儿管家、证券观察员、运维工程师、办公自动化都有;市场里还有 56 个,分 15 个类目。从模板建一个专家约 4 秒,选型时还能给专家套 16 种 MBTI 人设,说话口气跟着变。

图注:内置专家库的 17 个模板,育儿和健康类占了不少,都是中文人设

市场搜索偏专业向,这点要知道:输「育儿」拉不出结果,输「健康」能调出健康报告专家。普通家庭向的模板,更多在内置库那 17 个里。

图注:专家市场 56 个专家分 15 类,搜「健康」才出结果,搜「育儿」是空的

从市场一键创建还能顺手配存储、技能、知识库、连接器,整套装备一次备齐。

图注:市场创建对话框,存储、技能、知识库、连接器一次配完

建了个育儿管家,问它三岁孩子咳嗽一周要记哪些,四秒半回话。先说好,这是 0.6B 的小模型,只够验证流程通,天天用得上更大的模型。

octop agent from-expert parenting-companion --name 育儿管家 --user adminoctop --user admin chats send --agent 3B96MC "孩子三岁半,咳嗽一周,夜间更明显,家里要记哪些?"

全家共用一个实例,但各看各的。拿孩子的账号去翻爸爸的对话,接口直接回拒绝,实测普通用户 token 调别人的线程,返回 FORBIDDEN。命令行 --user 是管理员代操作,走本地库直读,别和网页权限混淆。

图注:用户管理页带登录锁定一列,连错 5 次锁 24 小时就是它标的

三、家人不碰网页,微信里就把活派了

对长辈最友好的一点藏在渠道里:把微信接上后,家人在聊天框里发消息,就是在跟各自的助手说话,不用学怎么开网页登控制台。飞书、钉钉、QQ、企业微信、Telegram、Discord 也都内置了,填上凭据就通。家里老人只认微信的,这套正好用得上。

它也不只是回话,还能替家人动手干活:

•远程桌面:出差想看家里主机跑得怎么样,真实屏幕直接搬进浏览器;
•终端 AI+:开个网页 shell,AI 帮着敲命令排障;
•浏览器 AI+:无头 Chromium 做网页自动化和截图。

聊天框加这三样,它在家里更像一个能动手的帮手,而不只是一个问答窗口。

四、问过的记得住,到点的自己会跑

每个专家都配了分层记忆,分节点、原子、实体、情节几层,带全文索引。对话原文先落盘,再由后台逐步提炼成结构化记忆,这是长期对话接得上话的关键。先打个预防针:提炼这层目前没跑通(坑三),短期对话靠得住,当长期档案还早。

技能包有二十多个,Word、Excel、PPT 文档处理、网页抓取、终端操作都有。把一份表格丢给它,它自己会读,不用你先截图贴过去。

图注:技能页二十多个包,文档三件套和网页抓取是家用频率最高的

定时任务按标准 crontab 写,早上八点把天气推到微信这种活,它到点自己跑。注意新增或修改后要重启服务才加载,手动触发偶发空响应,把 prompt 写明确就好。

图注:定时任务页,crontab 原生写法,改完记得重启才生效

往深走还能叠加几样:

•知识库 RAG:文档传进去做检索增强,全家共享语料,问什么都带上下文;
•AgentTeams(测试版):一个协调者调度多个专家,拆着干多步活;
•ACP 协议:编码任务能委托给 OpenCode、Claude Code、Codex 这些现成 agent;
•连接器与客户端:腾讯文档、会议走连接器接入,Windows、macOS、Linux 和飞牛 NAS 都有客户端。

五、放在同类里,它赌的是「全家」

光说它自己好不够,放在真同类里才看得清。个人 AI 助手赛道有三个现象级项目:OpenClaw、Hermes Agent、DeepSeek Harness,星数都在 Octop 的几十倍以上(星数取 2026 年 9 月公开统计)。但它们和 Octop 做的不是同一件事。

一张表看量级与出身:

项目
星标与建仓
出身与成熟度
Octop
约 5,900,2026-07
腾讯云官方,beta
OpenClaw
约 39 万,2025-11
个人开发者,社区大
Hermes Agent
约 9 万,2026-02
Nous Research
DeepSeek Harness
约 24 万,2026-08
DeepSeek 官方,预览

一张表看定位与家庭适配:

项目
定位
家庭适配
Octop
全家共享中文助手
多用户隔离,专家开箱
OpenClaw
一个人的贴身管家
单用户,5700+ 技能
Hermes Agent
会自我进化的 Agent
单用户,自动学技能
DeepSeek Harness
插件化 Agent 运行时
单用户,开发向

三个对手都在做「一个人的超级助手」:OpenClaw 接 100+ 消息平台,还能真的替你操作电脑;Hermes Agent 会复盘,干完活自己沉淀技能,越用越顺手;DeepSeek Harness 背靠大厂,把 Agent 做成插件运行时。它们全都没有「家庭」这个维度:一个实例一个主人,家里几个人想各用各的,只能各装一套。

Octop 押的正是这个没人占的位置:一个实例分给全家、中文专家模板让不懂提示词的家人直接用、全中文控制台。这是三个顶流都不提供的东西。

劣势也得摆明白。星数差着几十到上百倍,社区、文档、生态都不在一个量级,OpenClaw 的 ClawHub 有 5,700 多个社区技能,Octop 全部专家加起来不到 80 个。电脑控制、自动学技能这些杀手锏也没有。记忆提炼层实测没跑通(坑三),项目还在 beta(坑二、坑四、坑五都是毛刺)。

一句话定位:给全家配一个数据留在自己机器上、每人各用各的中文 AI 助手,Octop 是这条路上目前唯一像样的选择;要自己的超级助理或 Agent 开发框架,OpenClaw、Hermes Agent、DeepSeek Harness 都比它成熟得多。身边有刚买 NAS 在吃灰的朋友,这篇正好转给他,他要找的就是这种能把机器用起来的东西。

六、想装的话,二十分钟的事

前提就两个:一台装了 Docker 的常开机器,一个想好的强密码(至少 8 位,字母加数字)。仓库里直接带了 docker/docker-compose.yml,先把仓库 clone 下来,在根目录一条命令起服务:

OCTOP_DEFAULT_PASSWORD=换成大小写字母加数字且不少于8位的密码 \OCTOP_ADMIN_USERNAME=admin \dockercompose -fdocker/docker-compose.yml up -d

必改的只有密码,弱密码会被应用打回、退回随机生成。不想每次敲环境变量前缀,在 docker/ 目录放个 .env 写上端口和密码,compose 自动读。完整配好值的 compose 文件在文末附录,抄了就能跑。

起来后访问 http://<机器IP>:8088,健康检查一条命令确认:

$ curl -shttp://localhost:8088/api/health{"ok":true,"started_at":1790750051,"db":true,"users_loaded":1,"agents_running":0}

实跑结果(arm64 小主机):首次构建镜像约 10 分钟,大头是前端打包加依赖同步。起来后容器 healthy,初始账号加设好的密码直接能登。

手动 pip 会卡住的 OBS SDK 源码构建,在 Docker 链路里被 uv.lock 锁版本绕了过去,compose 一路没报错。

几件部署相关的事,一条条说清:

•数据:全在 octop-data 卷,宿主机默认 ~/.octop,换机器拷这个目录就带走全部助手和记忆;
•改端口:动 OCTOP_PORT 一个变量就行;
•官方变体:docker-compose.postgres.yml 用 pgvector/pg16 做向量后端,docker-compose.mobile.yml 是移动端预设;
•和原生的关系:起的是同一个应用,区别只在依赖装容器里还是宿主机上,原生的坎在坑一。

模型接入不挑食:本地 Ollama 走 OpenAI 兼容端点就能挂上,腾讯云、Kimi、MiniMax、SiliconFlow、阿里云、火山等云端厂商一键配置,填 key 就能用。

图注:模型配置页,本地 provider 与云端厂商共存,互不影响

七、实跑撞上的六个坑

坑一:pip 装不上,得手动补一个 wheel。esdk-obs-python 的源码包在新版 setuptools 下直接报错,手动把它构建成 wheel 再走 uv 安装,绕过源码构建:

pip wheel esdk_obs_python==3.26.6 -w ./wheels --no-depsuv tool install "octop==1.0.2b5" --find-links ./wheels

坑二:登录有滑块验证码,连错 5 次锁 24 小时。 同 IP 短时间失败 5 次会锁定并弹重置密码,密码记得记牢。

图注:登录页的滑块人机验证,连错 5 次锁 24 小时的入口就在这

坑三:记忆提炼层没真正跑,跨会话召回靠不住。 对话原文写进了 raw_events,候选、原子、实体表和全文索引全空。短期对话靠进程内上下文接得上,重要信息别只存它这儿。

坑四:从市场创建专家首次启动报未配置可用模型,重试就好。 配好全局模型后从市场建专家,第一次启动偶发失败,重试即正常;失败原因不落库,后台看不到报错。

坑五:cron 改完要重启才加载,run-now 偶发空响应。 新增或修改定时任务后必须重启服务;手动触发偶发 no visible response,通常是小模型返回了空内容,把 prompt 写得明确就好。

坑六:本地模型要走 OpenAI 兼容端点。 Ollama 的 Python 插件是可选依赖,没装就接不上,改用 OpenAI 兼容端点挂本地模型即可。

八、回到要不要装这件事

适合的场景很具体:家里有多人想用 AI、在意聊天数据留在自己机器、手头有常开的小主机或 NAS、有人愿意花二十分钟照着配。这样的家庭,专家库、多用户隔离和全套技能是现成的,省下的是自己拼积木的功夫。

只想装个 App 点开就用、没有常开机器、对命令行完全陌生的,先别急,各家现成产品更划算。记忆提炼和市场专家首次启动都还有毛刺,当成半成品底座来用比当成成品更稳。

今天就能做的一步:clone 仓库、跑附录里那条 compose,二十分钟见分晓,不满意 docker compose down 一删就干净。把全家 AI 助手收进自己掌控的实例,Octop 是目前唯一把这件事做成开箱产品的项目。它不完美,但底座完整,愿意折腾的人能省下不少功夫。

宝子们,点赞 + 在看,让更多兄弟、朋友、家人们知道这个好消息!有问题或者已经用上的,欢迎评论区留言讨论


附录:compose 完整配置

仓库原文件里变量默认全空,照抄容易懵。下面是配好值的版本,要动手的就一处密码:

services:octop:build:context: ..dockerfile: docker/Dockerfileimage: octop:latestcontainer_name: octoprestart: unless-stoppedports:      - "8088:8088"# 宿主机端口volumes:      - ~/.octop:/data/.octop             # 数据全在这,备份搬家拷它environment:      - HOME=/data      - OCTOP_BIND_HOST=0.0.0.0      - OCTOP_PORT=8088      - OCTOP_DEFAULT_PASSWORD=Abc12345   # 必改:至少 8 位,字母加数字      - OCTOP_ADMIN_USERNAME=admin# - OCTOP_DATABASE_DRIVER=postgresql# - OCTOP_DATABASE_URL=postgresql://octop:octop@host.docker.internal:5432/octop# - OPENAI_API_KEY=sk-你的key

注释掉的三行按需解开:接 PostgreSQL 做向量后端、填 OpenAI 兼容的模型 key,其余默认行为(SQLite、info 日志)家用够用。不想 clone 仓库的,裸 docker run 也行:

dockerrun -d -p8088:8088 \  -v octop-data:/data/.octop \  -e HOME=/data \  -e OCTOP_DEFAULT_PASSWORD=你的强密码 \octop:latest

参考资料

https://github.com/TencentCloud/Octop

https://pypi.org/project/octop/

尾图

相关学习资料