五种安装方式
① pip：pip install octop → octop run（最简）
② 一键脚本：uv 自动建隔离 Python 3.12 环境，不动系统 Python
③ Docker：官方镜像，NAS/服务器党首选
④ 桌面客户端：Windows / macOS / Linux 原生应用，另有飞牛 fnOS 应用包（native/docker 双形态）
⑤ 腾讯云镜像市场：Lighthouse/CVM 官方镜像，开机即用
首次启动三步
① octop run 启动（默认端口 8088，浏览器打开就是 Web 控制台）
② octop init 首次设置向导：管理员账号、模型 Provider 配置
③ 立即改默认密码——早期文档默认 admin/octop，公网部署第一件事改掉它
架构一分钟（决定你怎么部署）
单进程架构（无外部消息队列）：FastAPI + HarnessProcessor 统一处理 Web/IM/cron 三类入口，重启安全——全状态从控制面数据库重建。SQLite（WAL）默认，多用户高并发换 PostgreSQL。专家工作区文件可与控制面分开存储：本地盘/Docker 沙箱/PostgreSQL/腾讯云 COS/S3 任选。内存相关有独立开源项目 octop-memory（分层回忆+FTS 检索）。
技术内核与周边生态
官方同仓 Four 件套：octop-harness（Agent 运行时：模型路由/工具/技能/检查点）、octop-gateway（多平台 IM 桥）、octop-memory（分层记忆）、octop-browser（CDP 浏览器自动化+持久 profile）。API 面：HTTP/SSE/WebSocket 全程序化访问，交互式 API 文档默认关闭（config.json 开 enable_api_docs）。
两个诚实提醒
① 核心依赖未全开源：harness-agent/harness-memory/harness-browser 以外部包形式引入，深度魔改核心受限（社区已有讨论）；
② SQLite 写锁：一家人用无压力，团队高并发切 PostgreSQL。1.0 刚 GA，第三方评测还少，先本地玩稳了再上生产。