Octop 快速入门：几分钟内完成安装与运行
Octop 是一个自托管的多用户 AI 助手，完全运行在您自己的机器上。在本指南中，您将安装 octop CLI，运行 octop init，启动服务器，完成首次设置向导，并发送第一条消息——整个过程不到五分钟。
安装 Octop
选择适合您平台的安装方式。每种方法都会在 ~/.octop/venv 处配置一个隔离环境，并通过 ~/.octop/bin 将 octop 添加到您的 PATH 中——无需系统 Python。
重新加载 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 的云主机，见 在腾讯云中使用。飞牛 NAS 安装见 FnOS。
更想使用原生桌面应用？可以从 Octop v1.0.1 发布页下载 Octop-Desktop-<platform>。桌面客户端会在 ~/.octop 下使用便携 Octop 运行时，并在原生窗口中打开页面；只在服务器或 CLI 中使用时并非必需。