需满足操作系统(Ubuntu 20.04+/Debian 11+/CentOS 8+/TencentOS 3+)、公网访问、安全组放行8088/443端口、TAT Agent在线或SSH sudo权限、内存≥2GB、磁盘≥5GB、时间同步正常等前置条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要通过一键脚本在腾讯云上安装 Octop,需满足以下几项明确的前置条件。Octop 是 LightClaw ACE 的开源演进版本,部署方式延续了云原生、轻量易用的设计逻辑,但对环境有更清晰的边界要求。
服务器操作系统兼容性
必须使用支持 systemd 的 Linux 发行版,官方明确适配:
- Ubuntu 20.04 及以上
- Debian 11 及以上
- CentOS 8+ 或 TencentOS Server 3+(含 OpenCloudOS 9)
不支持 CentOS 7、Ubuntu 18.04 等已结束主流维护的系统,因其缺少必要依赖(如较新版本的 curl、systemd-resolved、cgroup v2 支持等)。
网络与安全组配置
- 目标服务器需能访问公网(用于拉取 Octop 官方镜像、依赖包及 Connector 所需的 SDK)
- 若计划通过浏览器访问 Octop Dashboard,安全组必须放通你指定的服务端口(默认 8088,可自定义)
- 建议同时开放 443 端口(便于后续启用 HTTPS + PWA 安装)
TAT Agent 或基础运维能力
腾讯云通用文字识别(高精度版)技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别,返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。
- 若采用「TAT 自动化助手」执行一键脚本(推荐方式),目标 CVM/Lighthouse 实例的 TAT Agent 必须为在线状态(新购实例默认已预装并自动启动)
- 若不用 TAT,则需确保你能通过 SSH 登录,并具备 sudo 权限,以便运行安装脚本中的系统级操作(如安装 Docker、配置服务、写入 systemd unit)
存储与后端选择准备(可选但建议提前规划)
Octop 支持多种后端,不同选项影响安装脚本行为:
- 本地磁盘(默认):无需额外准备,适合个人快速试用
- Docker:需提前确认服务器已安装 Docker CE(24.0+)且 daemon 正常运行
- PostgreSQL:需已有可用的 PostgreSQL 实例(≥13 版本),并准备好连接地址、用户名、密码及空数据库名
- COS/S3 兼容存储:需提前创建存储桶,并准备好 SecretId/SecretKey 及 endpoint
其他隐性但关键的要求
- 服务器内存 ≥ 2GB(推荐 4GB+),低于此值可能导致安装过程中模型加载或 Connector 初始化失败
- 磁盘剩余空间 ≥ 5GB(Docker 镜像 + 日志 + 工作区缓存所需)
- 时间同步正常(systemctl status systemd-timesyncd 应为 active),否则 OAuth 和 JWT 签名可能校验失败
不复杂但容易忽略

















