腾讯新出的本地 AI 助手 Octop，安装使用简单教程

TUTORIAL · 本地部署 2026.09

装个 AI 助手 半小时

就卡在一串密码

Octop 桌面版 · Windows 安装教程

爱玩的果果

教程 避坑

5 Parts + Conclusion

滑动

PART 01

Octop 是啥

先认识新玩具

PART 02

下载与安装

桌面版怎么装

PART 03

第一个坑

密码藏哪了

PART 04

怎么找到的

问了 AI 助手

PART 05

跟着向导走

5 步搞定

PART ///

上手小结

一句大实话

最难的一步，不是安装，是装完后那串不好找的密码。

最近腾讯开源了个能自托管的 AI 助手平台，叫 Octop。我第一时间下了桌面版想尝鲜，前面都顺，结果就在第一步「验证启动密码」上卡了快半小时。今天把整个从安装到上手的流程捋一遍，重点说那个坑，帮你们省点时间。

01

PART

Octop 是啥：先认识这个新玩具

WHAT IS OCTOP

说人话就是：你把它装在自己电脑或服务器上，数据全留本地，不往别人家跑，隐私这块儿比较稳。它主打一个「多用户、多 Agent 的 AI 助手平台」，下面这几个点是我觉得最值得说的。

一个软件顶好几个

网页控制台 + 命令行 + 多个 IM 机器人（飞书 / 钉钉 / QQ / Discord / 企业微信）+ 定时任务，全在一个进程里搞定。

多用户多 Agent

能搭一支「专家团」，还能给每个 AI 套 16 种 MBTI 人格，给助手定性格，这事儿还挺好玩。

能接外部服务

通过 Connector 接腾讯文档、微博、新闻等；也能开远程桌面、浏览器 AI+、终端 AI+，可玩性不低。

本地优先更安全

带 JWT 多用户隔离和工具审批护栏，安全意识在线，适合想自己掌控数据的朋友。

02

PART

下载与安装：桌面版怎么装

DOWNLOAD & INSTALL

我下的是Windows 桌面版，整体比命令行安装省心多了，基本是「下载 → 下一步 → 打开」三板斧。

1

去 GitHub 仓库的 Releases 页，下载 Windows 安装包，文件名类似 Octop-desktop-windows-amd64-版本号.exe。

2

双击运行，全程点「下一步」就好（它会装到 Program Files\Octop，并建好开始菜单和桌面快捷方式）。

3

装完打开，它会后台自动解压内置运行环境并启动服务端，你完全不用自己装 Python。

4

随后自动弹出设置向导；没弹就自己浏览器开 http://127.0.0.1:8088。

✦ 小提醒

桌面版本质是个「壳」，里面已经帮你把服务端跑起来了，所以到这步你其实已经成功一大半。

03

PART

第一个坑：验证启动密码藏哪了

THE FIRST TRAP

向导第一步就让你填「验证启动密码」，页面还写着：「首次启动时，服务端会在控制台打印一次性引导密码，并写入下方路径所示文件。」

大部分人（包括当时的我）下意识去翻 C:\Users\你的用户名\.octop 这个文件夹，翻来翻去也没影。下面这个坑，我替你们踩了。

！第一个坑

别在 .octop 里找！那串密码根本不在 .octop 目录里，而是直接躺在你的用户主目录：

C:\Users\你的用户名\octop-login.txt

打开这个文件，里面那串字符就是密码。直接复制填进去就行。

顺便说下，「控制台」在这里指的是 Octop 的Web 控制台（也就是这个向导页面本身）。密码是服务端启动时自己生成、打印到启动终端、同时写进上面那个文件的——所以你不用去翻什么黑窗口，看文件就行。

04

PART

我是怎么找到的：问了 AI 助手

HOW I FOUND IT

我自己在 .octop 里翻了半天没找到，就把现在聊天的这个 AI 助手WorkBuddy叫来，让它直接钻进我电脑的文件里帮我找。

它一开始在 .octop 目录里也没捞着，后来发现这密码其实根本不在 .octop 里面，而是直接躺在用户主目录的 octop-login.txt 里——一下就拎出来了。

拿到那串密码填进去，剩下的全程跟着它的指引点「下一步」就完事了。所以啊，这种本地软件藏得深的配置 / 密码，与其自己瞎翻，不如直接让 AI 助手去本机文件里定位，省时还准。

05

PART

剩下的跟着向导走就行

5 STEPS TO GO

密码过完，后面就是傻瓜式向导，一共五步，照着点就行：

1

设置密码：把 octop-login.txt 里那串填进去 → 继续（这步过了就再也不用它）。

2

选数据库：默认 SQLite，直接点「保存并继续」，别改。

3

创建管理员账号（关键）：填用户名（默认 admin）、密码、显示名——这是你以后真正登录用的账号，记牢。

4

配置模型：选个 LLM 供应商（DeepSeek / OpenAI 等），填 API Key，点测试连接；这步能跳过，但不配就聊不了天，建议现在就配一个。

5

完成：自动用刚建的管理员登录，进主界面，开玩。

✦ 重点提醒

向导第 3 步建的账号才是真登录账号；第一步那个「设置密码」只是一次性进门口令，别搞混了。

整体的使用感受还是挺好的，各方面的功能也比较完善，可以自己接入各方的AI。

LAST

SUMMARY

一句话总结：Octop 适合想在自家电脑上搞一套 AI 助手 / 机器人 的朋友。配好模型，你就能开玩了。

如果你也在折腾本地 AI 工具，欢迎留言聊聊你踩过的坑，咱们互相抄作业。