Octop 快速入门:几分钟内完成安装与运行
Octop 是一个自托管的多用户 AI 助手,完全运行在您自己的机器上。在本指南中,您将安装 octop CLI,运行 octop init,启动服务器,完成首次设置向导,并发送第一条消息——整个过程不到五分钟。
安装 Octop
选择适合您平台的安装方式。每种方法都会在 ~/.octop/venv 处配置一个隔离环境,并通过 ~/.octop/bin 将 octop 添加到您的 PATH 中——无需系统 Python。
:latest 是精简镜像,不含虚拟桌面、OCR 和本地向量。需要这些能力时,使用 ghcr.io/tencentcloud/octop:full 或 :<version>-full。国内镜像在 ghcr.nju.edu.cn/tencentcloud/octop 上使用同样的标签。
重新加载 shell
打开新的终端,或重新加载当前 shell 会话,以便 PATH 能够识别 ~/.octop/bin:
在 Windows 上,安装程序会自动更新用户 PATH——关闭并重新打开终端以使更改生效。无需执行 shell 重载命令。
确认安装成功:
初始化 Octop
初始化本地环境:
这会准备好 ~/.octop/(数据库、密钥等相关文件)。所有数据都保留在您机器的 ~/.octop/ 目录下。
启动服务器
在前台启动 Octop:
看到服务器就绪消息后,打开浏览器并访问:
首次启动时,页面会进入设置向导。请先到用户主目录打开 ~/octop-login.txt,将其中的一次性设置密码粘贴到向导中,然后自行设置管理员用户名和密码。
如需绑定所有网络接口或使用不同端口,直接传递参数即可:
如需将 Octop 作为持久后台服务运行(systemd、launchd 或 Windows Service),请使用:
配置模型提供商
Octop 内置了腾讯云、OpenAI、Anthropic、DeepSeek、Ollama 等大量预设。在页面中添加您的第一个提供商:

选择一个预置提供商,填入 API 密钥并启用。它的模型会进入可用模型池,供您账户下的所有专家使用。
更习惯终端?使用 octop models config——详见 专家命令。
发出第一条消息
打开对话,地址为 http://127.0.0.1:8088。选中设置向导创建的默认专家 main,发送一条您真的想办的事,例如「帮我把下面这段会议记录整理成三条待办」。

终端交互式聊天见 octop chats。
让它开始帮你干活
第一条消息能回来,就可以按您的日常往下配。每次只加一样:
基础安装程序会设置核心平台。如需解锁额外功能,请使用 --extras 参数重新运行安装程序:
浏览器自动化支持无头 Chromium 会话,用于网页任务和截图。飞书扩展添加了一个渠道桥接,让您的专家能够接收和回复飞书消息。
对于生产部署或多用户环境,请使用 Docker Compose 而非裸机安装。请参阅 Docker 部署指南。想直接买一台预装 Octop 的云主机,见 在腾讯云中使用。想在飞牛OS 上安装,见 飞牛OS。
更想使用原生桌面应用?从 Octop v1.0.3b5 发布页下载对应平台的安装包,例如 Octop-desktop-darwin-arm64-1.0.3b5.dmg。统信 UOS 和银河麒麟见在国产系统内使用。桌面客户端在 ~/.octop 下使用便携运行时,并用 Electron 窗口打开页面。登录过期后,它会用 ~/.octop/desktop-device.json 里的设备凭据续上会话。只在服务器或命令行里使用时,不必安装桌面端。桌面安装包只带浏览器自动化。虚拟桌面、OCR 和本地向量在 Docker 镜像标签 :full 上。

