2026年10月11日星期日

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

本文详细解析腾讯开源 AI 平台 Octop 的本地部署、初始化配置与核心功能,对比 WorkBuddy 的区别,并分享如何基于该框架进行私有化 AI 平台搭建与二次开发。

Tags:

杰克船长

读完需要

8
分钟

速读仅需 3 分钟

💬 说

这是我的第 380 篇原创,一直致力于从实战维度去分享工具、Agent、技巧、资讯

大家好,我是唐舰长

Workbuddy 实在太火了,但最近 github 有一个项目也火了,就是腾讯开源版 Workbuddy

名字叫 Octop,取自章鱼(Octopus)——八条触手同时干活,寓意一个中枢连接多个入口、多个 Agent。

“

小历史:它前身是腾讯内部项目"LightClaw ACE",2026-07-15 腾讯云正式宣布开源。

”

不能因为他是腾讯出的,就盲目追崇,当然我第一反应是:又来一个蹭开源热度的?但把源码和文档翻了一遍,发现这玩意儿还真有点东西,尤其对咱这种天天跟 AI 打交道的人。

所以我把桌面客户端装上,又跑了一遍 网页,前后折腾了几天。整理出这样一篇指南:它到底是个啥,跟你熟悉的 WorkBuddy 差在哪,值不值得装。

特别是二次开发是最好的场景,因为他框架确实不错。下面重点分享

全文导航

1和 WorkBuddy 比,有什么区别

2本地部署和入门指南

3初始化使用和认识

4推荐二次开发

5写在最后

1

   

和 WorkBuddy 比,有什么区别

两者都是腾讯生态的 AI 助手,但定位完全不同,不是谁替代谁: 

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

一句话总结:

  • WorkBuddy = 你个人桌面上"拎包入住的 AI 管家"。
  • Octop = 你自家机房里"自己搭的 AI 服务器,全家人都能连"。 两者都支持浏览器自动化、IM 接入、技能/专家扩展,能力面有重叠,但 Octop 多了"多用户隔离 + 远程桌面 + 完全自托管"这几张牌。
腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

可以看出来,对于个人日常使用来说,用 Workbuddy 是最佳的,但针对我们这些天天琢磨 AI 产品的,反而是一个好东西。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

这是一个开源项目,支持所有人免费使用,那就可以基于 octop 框架做二次开发。为什么可以用 octop 框架做开发呢?我们下面继续分享。

2

   

本地部署和入门指南

Octop 网站:

https://octop.cloud/#overview ( https://octop.cloud/#overview )

这个是 octop 的官网网站,目前 octop 支持几种使用方法:

  1. 首先就是 mac 电脑和 Windows 电脑都支持,以及 Linux 系统
  2. Python 和 Docker 安装
  3. 本地客户端软件
  4. 腾讯云等其他类型的服务器中安装

(其中本地客户端软件、和本地电脑直接部署是共用一个配置文件,只是入口不同)

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

我们重点就演示在本地电脑上以及下载本地客户端软件,如果在后续体验中觉得还不错,可以经常使用时也可以考虑使用服务部署实现 24 小时在线。

下载本地客户端和软件,其实方法都差不多。可以先在终端中安装,用浏览器打开先玩,然后在软件中也可以操作,数据都是互通的。

2.1

   

本地部署:

1.打开电脑终端

一键安装(macOS / Linux)

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | sh
腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

Windows(是PowerShell,不是命令提示符)

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

2.始化(创建数据库、JWT 密钥、首个管理员)

octop init

3.启动(API + Web 控制台)

octop run

以上就是手动安装,如果想偷懒,也可以让 Workbuddy 帮助你进行安装,指令 请帮我安装 octop 项目,并告诉我下一步应该怎么做

上面的指令输入给你的 Ai 工具后,安装会很快。然后就会来到需要你自己在终端启动这个控制台,还是在终端输入:

octop run

2.2

   

启动后的流程

1.打开网址:

http://127.0.0.1:8088,默认账号是 admin / octop 

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

2.启动密码就是当你输入完启动指令后,出现的那个框栏中的第二行的字母 

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

3.数据库的这里就继续下一步 

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

4.管理员配置

管理员配置这里一定要弄,关乎着你后续登录账号以及修改密码。因为刚开始的初始密码特别长,肯定不是我们的常用密码。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

5.模型配置 可以先跳过,到主页中再进行配置。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

在 octop 中支持云端模型和本地模型以及自定义模型,云端和自定义模型就是接入模型 API。这里大家根据选择去接入就行。

不接模型是不让你对话等操作的,嫌麻烦可以接入 DeepSeek,也可以用一些中转站平台的模型,以及 sub2api 号池中转平台。

但号池接入,一定要选择“opencode 接入”然后请求地址是带 V1 结尾的网址才行。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

3

   

初始化使用和认识

octop 更像是一个以专家为对话框的 Workbuddy,在专家对话方面更细节,ai 工作时步骤透明,用处更广泛, 

Octop 的优势不是功能多,而是“敢透明”——执行逻辑、成本、自身局限全摊给用户看,这对小白用户是实打实的安全感。 

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

和我们的 Workbuddy 非常相似,也有专家、自动化技能连接器,甚至还多了技能包以及知识库。 专家也支持你自己构建,也可以在专家市场上面去创建。但是市场上的专家其实对于我们的使用来讲并没有太大的帮助,更多还是要自己去构建自己的专家。

但是在 octop 里面创建专家,都需要自己配置。就像自己配置 豆包智能体一样,自己写提示词,配置 skill 等等;不能像在 Workbuddy 中,只需要说需求,AI 自己做。

他可以把专家直接当成你的对话框,对比于 wrokbuddy,也是十分的快捷方便。

这也是为什么我说他适合做二次开发的点,其实虽说一个专家一个对话框。但这不就像你在跟某个智能体在对话吗?与其说是专家,不如说是构建一个垂类智能体进行对话

比如一个企业,可以做财务专家、设计专家、合同审核等等

做出一堆专家(智能体)后精准的进行对话。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

还支持给专家安排定时任务,就像是你是公司老板,给各个部门安排每日任务一样

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

个性化这里就支持你去创建技能或者上传技能 zip 压缩包

而且是每个专家用不同的 skill,你同一个 skill 可能就需要上传几次分别给不同的专家。虽然繁琐,但我觉得这反而不会让 skill 打架

毕竟是做垂类的专家,就用专门的 skill 去干活就好啦

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

通道 

这里也就是连接渠道,像 Workbuddy 当中的助手也有类似的功能。其实这个功能我并不 care,因为目前我也没看到几位朋友经常用微信或者 QQ 去远程连他的电脑上的 Agent。

毕竟,如果没有带电脑的话,那肯定是在外休养休息,没必要把自己搞得那么紧。如果说是出差那基本上电脑也不离身。

看来看去,还是有一点那种 OpenClaw 小龙虾的影子的。 

连接器和 Workbdduy 差不多啊,比较支持腾讯自己生态的会比较多,但是也支持像 ima、dify、飞书、Notion 等等这些比较火的一些应用接入。

技能包这里会稍微特殊一点,我们就不重点分享了。其实也就是说,将 56 个技能打包在一个包里面的概念。

知识库: 

这算是当下像 Workbuddy,包括豆包工作这种办公类 Agent 软件所没有的功能:它可以帮助你下载一个本地的向量模型,以 RAG 知识库的形式去存储一些知识。 

然后用模型进行快速检索,目前这类场景大多用于知识的快速检索,以及像客服行业的问答。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

最重要的是他还自己装了一个真实的 Chromium 浏览器实例,通过 CDP(Chrome DevTools Protocol,就是 Chrome 自带的开发者调试协议) 接进去,让专家能在里面逛网页、填表单、截图。

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

还有一个特别亮点的功能就是,octop 里面的专家是可以调用你本地的编程 Agent,比如 Claude code、Codex 相当于把 Claude code、Codex 编程一个子 Agent,由 octop 专家去派任务

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

4

   

推荐二次开发

看到这你大概明白了,Octop 里的专家本质就是一个个垂类智能体,还能调度 Claude Code、Codex 当子 Agent 去干活。这架构,天然就适合拿来做二次开发。

为啥我反复说它适合? 

第一,它开源,MIT 协议,代码随便你看、随便改、随便打包分发,不怕哪天被人收授权费。fork 一份,想加功能加功能,想改界面改界面,跟闭源 SaaS 完全是两码事。 

第二,框架是真的干净。专家、技能、知识库、连接器,全是模块化拆开的。你想加一个自己的垂类智能体,就是建个专家、写套提示词、挂个 skill,齐活。不像有些平台把所有逻辑糊在一起,想动都不知道从哪下手。 

第三,它敢透明。执行逻辑、调了什么工具、花了多少成本,全摊给你看。你基于它做开发,调试也省心,不用猜 Agent 背后到底干了啥。

比如分享几个场景你就知道了: 如果你开公司或者带小团队,完全可以把 Octop 搭成你们内部的 AI 中台。财务专家、设计专家、合同审核专家,一人一个对话框,员工精准找对应的专家智能体聊,数据还在本地

如果你有点代码底子,还能把它白标化。logo 能换、用不上的功能关掉,改成自己公司的牌子,就是一个能对外交付的私有 AI 产品。

甚至你还能通过连接器或 MCP,把 Octop 接进你们自己的业务系统,比如内部 API、数据库,让专家直接查你们的业务数据办事。

对我来说,它最大的价值不是开箱即用的那些功能,而是给了我一个能随便改的 AI 对话框架。这一点,对咱们这种天天琢磨 AI 产品的人,确实香。

5

   

写在最后

聊了这么多,一句话收住:Octop 不是 WorkBuddy 的替代品,它俩压根不是一类东西。 

你一个人日常办公提效,WorkBuddy 依然是最佳选择,开箱即用、不用折腾。但你想自己掌控数据、想多人共用、想拿来做二次开发,Octop 就值得你花点时间装上体验一下

先用桌面客户端把流程跑通,接个 DeepSeek ,感受一下专家对话和知识库。真觉得顺手,再考虑上 NAS 或者服务器,搞个 24 小时在线的私有 AI。

工具没有最好的,只有最适合你的。别被"开源""免费"几个字带节奏,也别因为它是腾讯出的就盲目追。自己上手试过,才有发言权。

这篇指南我整理了不少实操步骤,里面有不懂的,评论区聊 !

我是唐舰长,一个在 WorkBuddy 里折腾实战的普通创作者,感谢您的观看~

腾讯开源 Octop 私有化 AI 平台安装部署与二次开发指南

没有评论:

发表评论

2026淘宝联盟年度榜单揭晓 两类新玩家正在改写淘客格局

本文解读淘宝联盟2026年度优秀合作伙伴榜单,重点拆解手机厂商流量型与广告媒体投流型两类新玩家,剖析其资源迁移打法与头部格局变化。对想入局淘客的新人,建议结合所在城市的产业圈子选赛道,并重视自身流量资源与能力的长期积累。 Tags: 淘宝联盟 淘客榜单 手机厂商流量 ...