Octo是明略科技于2026年6月29日开源的Agent协作网络平台，基于Apache 2.0协议，支持私有化部署，已内部部署超2900个AI Agent并服务1400名员工。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在三台电脑上同时跑起腾讯开源的 Octop 家庭 AI 助手，又不想反复查文档配环境、装依赖、改配置——直接运行一键脚本就能拉起 Web UI、连上本地模型、支持多用户登录，这才是你真正需要的安装路径。
macOS 一键安装（Apple Silicon / Intel 通吃）
打开终端，粘贴执行：
curl -fsSL https://octop.ai/install-macos.sh | bash
脚本会自动检测芯片架构（arm64 或 x86_64），下载对应二进制包并校验 SHA256。若提示 【Permission denied】，说明当前用户无 /opt/octop 写入权限，需先执行 sudo chown -R $USER /opt；若跳过此步，后续服务将无法启动。
安装完成后，终端会输出类似 http://localhost:3000 的访问地址，直接在 Safari 或 Chrome 中打开即可进入初始化向导。
Linux 全发行版通用安装
方法一：使用官方镜像加速安装（推荐国内用户）
sudo curl -fsSL https://gitee.com/tencent-octop/installer/releases/download/latest/linux.sh | bash -s -- --mirror tencent
该命令会绕过 GitHub 下载瓶颈，从腾讯云 COS 拉取二进制与预编译依赖。Ubuntu 22.04、Debian 12、CentOS Stream 9 均已实测通过，但 【不支持 Ubuntu 18.04 及更旧版本】，因其 glibc 版本低于 2.31，会导致核心进程 segfault。
方法二：手动指定安装路径（适合无 root 权限用户）
mkdir -p ~/local/octop && curl -fsSL https://octop.ai/install-linux.sh | bash -s -- --prefix ~/local/octop
这一步会把所有文件解压到用户目录，无需 sudo。但注意：systemd 服务无法注册，后续需用 nohup ./octop serve & 启动。
Windows 安装（WSL2 + 原生双路径）
第一步：确认 WSL2 已启用并运行 Ubuntu 22.04 发行版
在 PowerShell（管理员）中执行：wsl --install --distribution Ubuntu-22.04
第二步：进入 WSL 终端，运行 Linux 安装脚本
curl -fsSL https://octop.ai/install-linux.sh | bash
第三步：配置 Windows 端口转发，让宿主机浏览器能访问
在 PowerShell（非管理员）中执行：netsh interface portproxy add v4tov4 listenport=3000 listenaddress=127.0.0.1 connectport=3000 connectaddress=$(wsl hostname -I | awk '{print $1}') protocol=tcp这一步必须做。WSL2 默认使用虚拟网卡，不配置端口转发，localhost:3000 在 Windows 浏览器里会显示“连接被拒绝”。
方法二（原生 Windows）：下载 octop-win-x64-v0.8.3.exe，右键→以管理员身份运行，勾选“开机自启”和“添加到 PATH”，点击安装。安装器内置了所有依赖，包括 SQLite3 和 libuv，无需额外安装 Visual C++ 运行库。
首次启动与基础验证
1. 执行 octop serve 启动服务
2. 观察终端输出是否出现 “✅ HTTP server listening on :3000” 和 “? Memory backend initialized (harness-memory)”
3. 打开浏览器访问 http://localhost:3000，看到 Octop 登录页即表示主程序就绪
4. 在登录页点击 “Create first user”，填写邮箱与密码，系统将自动生成加密密钥对并写入 ~/.octop/users.db
5. 登录后进入 “Settings → Model Providers”，点击 “+ Add Provider”，选择 “Ollama”，填入 http://localhost:11434，点击 Test Connection —— 成功返回模型列表即完成闭环验证。
