1. OpenClaw 是什么为什么偏偏选腾讯云来跑它OpenClaw 不是某个大厂官方出品的明星项目而是一个在开源社区里悄然生长、专为智能体Agent工作流编排与可视化调试设计的轻量级工具。它的核心价值非常实在当你用 Python 写了一堆调用大模型、操作数据库、发 HTTP 请求的函数想把它们像搭积木一样串起来又不想被 LangChain 那套抽象层绕晕也不想自己从零写个带 UI 的调度器——OpenClaw 就是那个“刚刚好”的中间解。它用 YAML 定义流程用 Web UI 拖拽调试底层靠 Python 执行器驱动不绑架你的技术栈也不强求你学新范式。那为什么部署场景里“腾讯云”三个字高频出现不是因为 OpenClaw 和腾讯有合作而是现实倒逼出的选择逻辑。我去年帮三支小团队落地过类似需求发现一个共性他们手头没有现成的 Kubernetes 集群也没有运维专职盯服务器但几乎人人都有腾讯云轻量应用服务器Lighthouse的试用额度或者公司已采购了 CVM 实例。这类资源开箱即用、控制台友好、网络策略清晰最关键的是——它完美匹配 OpenClaw 的部署气质单机、无状态、依赖少、靠 Docker 封装即可闭环。你不需要搞高可用集群也不用配 Service Mesh一台 2 核 4G 的轻量服务器装上 Ubuntu Docker就能让整个工作流平台跑起来。这和那些动辄要求 8 核 16G、必须挂 NAS 存储、还得配 TLS 证书的“企业级”平台形成鲜明对比。OpenClaw 的哲学就是让想法快速跑通而不是让环境配置成为第一道门槛。关键词里反复出现的 “Docker”、“Docker Compose”、“Ubuntu”恰恰印证了这个路径的普适性。Ubuntu 是腾讯云镜像市场的默认首选稳定、文档全、社区支持好Docker 提供了环境隔离和一键分发能力避免了 Python 版本冲突、依赖包打架这些经典坑Docker Compose 则把 OpenClaw 的前端、后端、Redis 缓存、PostgreSQL 数据库这些组件用一份 YAML 文件就定义清楚启动、停止、重启全靠一条命令。这种组合对刚接触 DevOps 的同学来说学习曲线平缓得惊人——你不用理解 cgroups 是什么也不用背 iptables 规则只要会写几行缩进正确的 YAML就能把一个完整服务跑起来。我见过最典型的案例是一位做电商客服自动化的运营同事她连 Linux 命令行都不太熟但在我们给她画了张“三步走”流程图装 Ubuntu → 装 Docker → 运行 docker-compose up后当天下午就成功把 OpenClaw 的 demo 流程跑通了并开始往里面塞她自己的客服话术判断逻辑。这背后没有魔法只有工具链的精准咬合。提示别被“云端部署”四个字吓住。这里的“云”本质是“远程 Linux 服务器”的代名词。你本地用 VirtualBox 装个 Ubuntu 虚拟机照着本指南操作效果完全一样。腾讯云的价值在于它帮你省去了物理机采购、IDC 机柜、宽带申请这些重资产环节让你能以“按小时付费”的方式获得一个随时可销毁、随时可重建的干净实验环境。这才是对新手最友好的起点。2. 从零开始腾讯云轻量服务器选购与系统初始化实操很多新手卡在第一步不是不会部署 OpenClaw而是根本没搞懂“腾讯云轻量服务器”到底该买哪一款。网上教程常一笔带过“买台服务器”但实际选型错误后面全是坑。我来拆解清楚。2.1 选型决策树CPU、内存、系统盘、带宽每一项都影响体验打开腾讯云轻量应用服务器购买页你会看到一堆配置选项。别急着点“立即购买”先看这张决策表配置项推荐选择为什么这样选不推荐选择及后果地域选离你物理位置最近的如北京、上海、广州网络延迟低SSH 连接和 Web 访问更流畅。OpenClaw 的 UI 是实时渲染的高延迟会导致拖拽卡顿、日志刷新慢。选海外节点如新加坡、东京国内访问延迟可能超 200msUI 操作明显粘滞。实例套餐2 核 4G 内存 80GB SSD 系统盘这是 OpenClaw 的“黄金平衡点”。2 核足够处理并发 5-10 个流程实例4G 内存能同时容纳 PostgreSQL、Redis、OpenClaw 后端、Nginx 反向代理80GB SSD 足够存放镜像、日志和少量运行时数据。选 1 核 2G内存极易耗尽Docker 会 OOM Kill 进程OpenClaw 启动后莫名崩溃选 50GB 系统盘Docker 镜像下载构建过程可能占满空间导致docker pull失败。镜像Ubuntu Server 22.04 LTS这是当前最稳、文档最全、社区支持最好的长期支持版。OpenClaw 官方文档和所有第三方教程都基于此版本。22.04 的内核和 systemd 对 Docker 支持极佳几乎零兼容性问题。选 CentOS 7/8已停止维护Docker 官方不再提供预编译包需手动编译新手极易失败选 Ubuntu 24.04虽新但部分依赖库如某些 Python 包尚未完全适配存在未知风险。公网带宽5Mbps这是关键OpenClaw 本身不产生大流量但你需要通过浏览器访问它的 Web UI默认端口 3000还要上传 YAML 流程文件、查看日志。5Mbps 足够支撑 3-5 人同时在线调试。选 1Mbps上传一个稍大的 YAML 文件5MB要等半分钟UI 加载缓慢选 0Mbps无公网服务器彻底无法从外网访问等于买了个摆设。选完之后务必勾选“设置登录凭证”并选择“自定义密码”。这是最安全、最便捷的登录方式。不要选“密钥对”除非你已经熟练使用ssh -i命令。密码方式简单直接符合“菜鸟级”定位。2.2 初始化连接服务器、更新系统、创建非 root 用户付款成功后腾讯云控制台会显示服务器的公网 IP 地址如118.24.123.45和初始密码。现在打开你的终端Mac/Linux或 PowerShellWindows。第一步SSH 连接ssh root118.24.123.45 # 输入你设置的密码如果提示The authenticity of host 118.24.123.45 cant be established...输入yes继续。第二步系统更新至关重要# 更新软件包索引 apt update # 升级所有已安装的软件包包括内核和安全补丁 apt upgrade -y # 清理无用的旧包 apt autoremove -y这一步不能跳Ubuntu 22.04 镜像出厂时自带的内核和一些基础库可能有已知漏洞或 Bugapt upgrade会拉取腾讯云镜像源里的最新修复版本。我曾遇到一个真实案例某用户跳过此步直接装 Docker结果 Docker daemon 启动后立刻崩溃报错failed to start containerd: failed to create containerd socket: listen unix:///run/containerd/containerd.sock: bind: address already in use。查了两小时最后发现是旧版systemd和新版containerd的 socket 管理机制冲突apt upgrade一执行问题迎刃而解。第三步创建专属用户安全基石永远不要用root用户日常操作。创建一个新用户# 创建用户名为 clawuser 的用户你可以改成你喜欢的名字 adduser clawuser # 按提示输入密码两次其他信息可直接回车跳过 # 将新用户加入 sudo 组赋予管理员权限 usermod -aG sudo clawuser # 切换到新用户 su - clawuser此时你的命令行提示符会从rootserver:~#变成clawuserserver:~$。后续所有操作都在这个clawuser账户下进行。这是 Linux 运维的铁律也是防止误操作删库跑路的第一道防线。注意腾讯云轻量服务器的防火墙Security Group默认只开放了 22SSH、80HTTP、443HTTPS端口。而 OpenClaw 的 Web UI 默认监听 3000 端口Docker Compose 的 PostgreSQL 监听 5432Redis 监听 6379。这些端口目前是被防火墙拦截的。别慌这不是错误而是腾讯云的安全默认策略。我们会在部署 Docker Compose 时通过ports配置将容器内的端口映射到宿主机的 80 或 443 上从而绕过防火墙限制。这是标准且安全的做法无需在控制台手动开放一堆端口。3. Docker 与 Docker Compose不是黑魔法是标准化的“打包发货”协议很多新手听到 Docker 就头皮发麻觉得是“高级运维才玩的东西”。其实不然。把它想象成一个超级快递员你把 OpenClaw 的所有零件代码、Python 解释器、依赖库、配置文件打包进一个叫“镜像”的标准纸箱里Docker 就负责把这个纸箱原封不动地运送到任何一台装了 Docker 的服务器上并当场拆箱、组装、通电——整个过程你不需要关心这台服务器上原本装的是 Python 3.8 还是 3.11装的是 MySQL 还是 PostgreSQL。这就是 Docker 的核心价值环境一致性。3.1 为什么必须用 Docker Compose而不是单个 docker runOpenClaw 不是一个单体应用。它由至少 4 个独立进程组成Web UI 前端一个 React 应用提供可视化编辑界面。Backend API 后端一个 FastAPI 服务负责接收前端请求、调度流程、管理数据库。Redis作为消息队列和缓存存储流程执行状态、临时数据。PostgreSQL作为主数据库持久化用户、流程定义、执行历史等结构化数据。如果只用docker run你需要分别执行 4 条命令每条都要手动指定网络、卷、环境变量、端口映射稍有不慎它们之间就无法通信。Docker Compose 就是为了解决这个问题而生的。它用一份docker-compose.yml文件像一张“施工蓝图”一次性声明所有服务的配置。你只需执行docker-compose up -dDocker 就会自动下载或构建所有需要的镜像创建一个专用的内部网络openclaw_default让这 4 个服务能用服务名如backend、redis互相访问创建持久化数据卷postgres_data、redis_data确保服务器重启后数据不丢失将后端的 8000 端口映射到宿主机的 80 端口让浏览器能直接通过http://你的IP访问。这就像你请了一个项目经理他拿着蓝图指挥工人Docker Engine把房子OpenClaw 平台盖好你只需要说一句“开工”。3.2 在 Ubuntu 22.04 上安装 Docker 和 Docker Compose 的“防坑”步骤官方文档的安装步骤很清晰但有几个极易踩中的坑我来一一标注安装 Docker Engine# 1. 卸载旧版本腾讯云镜像有时会预装旧版 sudo apt remove docker docker-engine docker.io containerd runc # 2. 安装必要依赖 sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release # 3. 添加 Docker 的官方 GPG 密钥关键必须用 https://download.docker.com/linux/ubuntu/不能用国内镜像源的密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 4. 添加稳定版仓库注意这里是 jammy对应 Ubuntu 22.04 echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 5. 更新索引并安装 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 6. 验证安装 sudo docker run hello-world注意第 3 步的密钥来源必须是https://download.docker.com/linux/ubuntu/gpg。我见过太多人为了“加速”去网上搜“国内 Docker 镜像源安装教程”结果用了错误的密钥导致apt update报错NO_PUBKEY然后陷入死循环。官方密钥是唯一可信源下载速度慢点总比装不上强。安装 Docker Composev2.xDocker Compose v2 已集成进docker-compose-plugin所以第 5 步apt install时已经装好了。验证docker compose version # 输出应为Docker Compose version v2.x.x如果你看到command not found说明你装的是老掉牙的 v1必须卸载重装。v1 的语法docker-compose命令和 v2docker compose命令不兼容OpenClaw 的官方docker-compose.yml是为 v2 设计的。将当前用户加入 docker 组免 sudo# 把 clawuser 加入 docker 组 sudo usermod -aG docker clawuser # 退出当前会话重新登录或重启终端让组权限生效 exit # 重新 SSH 连接 ssh clawuser118.24.123.45 # 验证现在可以不加 sudo 运行 docker 命令了 docker ps提示这一步极其重要。如果不加sudo每次运行docker或docker compose都要输密码不仅麻烦而且 OpenClaw 的某些自动化脚本比如定时备份会因权限问题失败。加入docker组是标准且安全的操作因为docker组本身就被设计为拥有等同于root的容器管理权限。4. OpenClaw 部署实战从克隆代码到首次登录 Web UI现在所有前置条件都已就绪。我们进入最激动人心的环节让 OpenClaw 真正跑起来。整个过程分为四步获取代码、准备配置、启动服务、验证访问。每一步都有其不可替代的逻辑。4.1 获取 OpenClaw 代码为什么必须用 git clone而不是下载 ZIPOpenClaw 的 GitHub 仓库https://github.com/open-claw/openclaw是其唯一的权威源。你可能会想“直接在网页上点 ‘Code’ - ‘Download ZIP’然后解压不就行了” 这是个危险的想法。原因有二缺少子模块SubmodulesOpenClaw 的前端frontend目录和后端backend目录是两个独立的 Git 仓库通过 Git Submodule 机制关联。ZIP 包只会下载主仓库的顶层文件而不会递归下载子模块的内容。你解压后会发现frontend和backend目录是空的或者只有一堆.git文件根本无法构建。无法追踪更新未来 OpenClaw 发布了新版本修复了你正在踩的 Bug或者增加了你需要的功能。如果你用 ZIP你只能手动下载新包、覆盖旧文件极易出错。而用git clone你只需一条git pull就能一键同步所有代码和子模块。正确操作# 进入家目录 cd ~ # 克隆主仓库会自动初始化并更新子模块 git clone --recursive https://github.com/open-claw/openclaw.git # 进入项目目录 cd openclaw # 查看当前分支确保是 main 或 latest release 分支 git branch # 如果需要切换到特定稳定版本推荐例如 v0.8.0 git checkout v0.8.04.2 配置文件详解docker-compose.yml里的每一个字段都是有故事的OpenClaw 项目根目录下有一个docker-compose.yml文件。这是整个部署的“心脏”。我们逐段解读理解它为何如此设计version: 3.8 services: # 后端 API 服务 backend: build: context: ./backend dockerfile: Dockerfile restart: always environment: - DATABASE_URLpostgresql://postgres:postgrespostgres:5432/openclaw - REDIS_URLredis://redis:6379/0 - SECRET_KEYyour-secret-key-change-this - ALLOWED_HOSTS* ports: - 8000:8000 depends_on: - postgres - redis # Web UI 前端服务 frontend: build: context: ./frontend dockerfile: Dockerfile restart: always environment: - VUE_APP_API_BASE_URLhttp://localhost:8000 ports: - 3000:3000 depends_on: - backend # PostgreSQL 数据库 postgres: image: postgres:14 restart: always environment: - POSTGRES_DBopenclaw - POSTGRES_USERpostgres - POSTGRES_PASSWORDpostgres volumes: - postgres_data:/var/lib/postgresql/data healthcheck: test: [CMD-SHELL, pg_isready -U postgres -d openclaw] interval: 30s timeout: 10s retries: 5 # Redis 缓存/消息队列 redis: image: redis:7-alpine restart: always command: redis-server --appendonly yes volumes: - redis_data:/data healthcheck: test: [CMD, redis-cli, ping] interval: 30s timeout: 10s retries: 5 volumes: postgres_data: redis_data:关键字段解析restart: always这是生产环境的黄金法则。它告诉 Docker无论后端进程是正常退出还是崩溃都必须自动重启。没有它一次意外的内存溢出就会让整个平台宕机数小时。environment这里定义了服务运行所需的环境变量。DATABASE_URL和REDIS_URL中的postgres和redis是服务名Docker Compose 会自动在内部网络中将它们解析为对应的容器 IP。SECRET_KEY是 Django/FastAPI 的安全密钥必须修改用openssl rand -hex 32生成一个随机字符串替换掉your-secret-key-change-this。不改的话你的平台存在严重的安全风险。portsbackend的8000:8000表示将容器内的 8000 端口映射到宿主机的 8000 端口。但请注意我们不直接通过http://IP:8000访问后端因为后端 API 是给前端调用的不是给人用的。frontend的3000:3000同理它只是开发模式下的便利端口。在生产环境中我们会用 Nginx 做反向代理把http://IP的请求转发给frontend容器的 3000 端口。depends_on它定义了服务启动的先后顺序。backend必须等postgres和redis启动并健康后才开始启动。frontend必须等backend启动后才开始构建静态文件。这保证了服务间的依赖关系不会乱。4.3 启动与验证从docker compose up到浏览器弹窗一切准备就绪执行终极命令# 在 openclaw/ 目录下 docker compose up -d-d参数表示“detached mode”即后台运行。执行后终端会立刻返回不会卡住。验证服务是否真的起来了# 查看所有容器状态 docker compose ps # 输出应类似 # NAME COMMAND SERVICE STATUS PORTS # openclaw-backend-1 uvicorn main:app --… backend running (healthy) 8000/tcp # openclaw-frontend-1 npm run serve frontend running (healthy) 3000/tcp # openclaw-postgres-1 docker-entrypoint.s… postgres running (healthy) 5432/tcp # openclaw-redis-1 docker-entrypoint.s… redis running (healthy) 6379/tcp # 查看后端日志确认数据库连接成功 docker compose logs -f backend # 你应该能看到类似 INFO: Application startup complete. 的日志且没有 ERROR。 # 按 CtrlC 退出日志跟踪。 # 查看前端日志确认构建完成 docker compose logs -f frontend # 你应该能看到 Compiled successfully 或 App is running at http://localhost:3000。最后一步访问 Web UI打开你的浏览器输入http://118.24.123.45:3000把 IP 换成你自己的。如果一切顺利你应该会看到 OpenClaw 的登录页面。默认的管理员账号是Username:adminPassword:admin登录后你将看到一个空白的画布。恭喜你已经成功部署了 OpenClaw。现在你可以点击左上角的 New Flow开始用 YAML 定义你的第一个智能体工作流了。提示第一次登录后强烈建议立即修改管理员密码。在右上角头像菜单里找到Settings-Change Password。这是安全底线不容忽视。5. 常见问题排查从“页面打不开”到“流程不执行”的完整链路部署完成不等于万事大吉。在真实使用中你会遇到各种各样的“小故障”。与其在网上大海捞针地搜索不如掌握一套系统性的排查思路。下面是我总结的最高频的 5 个问题及其解决路径。5.1 问题浏览器打不开http://IP:3000显示“无法访问此网站”这是新手最常遇到的“拦路虎”。别急着重装按以下顺序检查检查 Docker Compose 是否真的在运行docker compose ps # 如果所有 STATUS 都是 exited 或 created说明启动失败。看日志 docker compose logs backend # 最常见的错误是 psycopg2.OperationalError: FATAL: database openclaw does not exist这说明 PostgreSQL 容器没起来或者 postgres 服务名没被正确解析。检查容器端口是否真的映射成功# 查看宿主机上哪些端口被占用了 ss -tuln | grep :3000\|:8000 # 如果没有任何输出说明 docker compose up 没有成功映射端口。回到 docker-compose.yml检查 frontend 服务下的 ports 字段是否写成了 - 3000少了冒号后的端口或者拼写错误。检查腾讯云防火墙Security Group是否放行了 3000 端口注意虽然前面说过我们最终会用 Nginx 代理到 80 端口但为了快速验证临时在腾讯云控制台的安全组规则里添加一条入站规则TCP:3000授权对象为0.0.0.0/0。如果此时能访问了说明问题就出在防火墙。后续再配置 Nginx 时就可以把这条规则删掉只留 80/443。检查服务器本地防火墙UFW是否开启sudo ufw status verbose # 如果状态是 active它会拦截所有未明确允许的端口。临时关闭它测试 sudo ufw disable # 如果此时能访问了说明 UFW 是罪魁祸首。永久解决方案是 sudo ufw allow 3000 sudo ufw enable5.2 问题能打开登录页但输入admin/admin后提示“Invalid credentials”这通常意味着后端 API 服务虽然启动了但数据库连接失败导致用户表没有被初始化。排查链路docker compose logs postgres看是否有database system is ready to accept connections。如果没有说明 PostgreSQL 启动失败常见原因是postgres_data卷损坏。解决方案docker compose down -v-v参数会删除关联的数据卷然后docker compose up -d重建。docker compose logs backend查找django.db.utils.OperationalError或psycopg2.OperationalError。如果看到FATAL: password authentication failed for user postgres说明backend服务里的DATABASE_URL环境变量和postgres服务里的POSTGRES_PASSWORD不一致。回到docker-compose.yml检查backend.environment.DATABASE_URL和postgres.environment.POSTGRES_PASSWORD的值是否完全相同包括大小写和特殊字符。如果以上都正常但还是登录失败可能是数据库迁移没执行。进入 backend 容器手动执行docker compose exec backend bash # 在容器内 cd /app/backend python manage.py migrate python manage.py createsuperuser --username admin --email adminexample.com # 按提示输入密码 exit5.3 问题流程能保存但点击“Run”后状态一直卡在 “Pending”日志里没有输出这是 OpenClaw 的“灵魂拷问”。根本原因在于流程的执行任务被提交到了 Redis 队列但没有 Celery Worker 进程去消费它。OpenClaw 的架构是Frontend-Backend API-Redis Queue-Celery Worker-Actual Task Execution。docker-compose.yml里默认只定义了backend、frontend、postgres、redis四个服务唯独缺了celery-worker这个关键服务解决方案编辑docker-compose.yml在services下添加一个新的服务celery-worker: build: context: ./backend dockerfile: Dockerfile restart: always environment: - DATABASE_URLpostgresql://postgres:postgrespostgres:5432/openclaw - REDIS_URLredis://redis:6379/0 - SECRET_KEYyour-secret-key-change-this - ALLOWED_HOSTS* command: celery -A openclaw.celery worker --loglevelinfo depends_on: - postgres - redis重新启动docker compose down docker compose up -d验证docker compose ps | grep celery # 应该看到一个 running 状态的 celery-worker 容器。 docker compose logs celery-worker # 应该看到 Ready to accept tasks。5.4 问题流程执行成功了但日志里显示ImageMagick 6.9.12 is installed, but images are not processed这是一个典型的“依赖缺失”问题。OpenClaw 的某些技能Skill比如图片裁剪、格式转换需要系统级的imagemagick工具。Docker 容器是隔离的backend容器的镜像里默认没有安装它。解决方案进入backend的Dockerfileopenclaw/backend/Dockerfile。在FROM python:3.11-slim之后添加一行RUN apt-get update apt-get install -y imagemagick rm -rf /var/lib/apt/lists/*重新构建并启动docker compose down docker compose build backend celery-worker docker compose up -d5.5 问题服务器重启后OpenClaw 无法自动启动这是因为docker compose up -d启动的服务默认不会随系统开机自启。你需要启用 Docker 的restart policy并配置 systemd 服务。终极解决方案推荐创建一个 systemd 服务文件sudo nano /etc/systemd/system/openclaw.service内容如下[Unit] DescriptionOpenClaw Service Afterdocker.service Wantsdocker.service [Service] Typeoneshot Userclawuser WorkingDirectory/home/clawuser/openclaw ExecStart/usr/bin/docker compose up -d ExecStop/usr/bin/docker compose down RemainAfterExityes Restartalways RestartSec10 [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable openclaw.service sudo systemctl start openclaw.service现在无论你手动重启服务器还是腾讯云因维护重启实例OpenClaw 都会自动拉起。最后分享一个小技巧我给自己所有的 OpenClaw 服务器都配置了一个简单的健康检查脚本。放在/home/clawuser/check_openclaw.sh#!/bin/bash if ! docker compose ps | grep -q running.*healthy; then echo OpenClaw is unhealthy! Restarting... docker compose down docker compose up -d fi然后用crontab -e添加一行*/5 * * * * /home/clawuser/check_openclaw.sh。每 5 分钟检查一次确保服务永不下线。这比什么都管用。