1. 项目概述：为什么选择云端部署OpenClaw？

如果你正在本地机器上折腾OpenClaw，被各种依赖冲突、端口占用、模型加载内存不足的问题搞得焦头烂额，那么是时候认真考虑一下云端部署这条路了。我最初接触OpenClaw时，也是从本地Docker部署开始的，虽然能跑起来，但每次想给同事演示，或者自己在外想用手机访问一下，都得先确保家里的电脑开着，网络还得做内网穿透，麻烦不说，性能也受限于我那台老旧的笔记本。后来我把目光投向了云端，经过一番折腾和对比，最终在腾讯云上稳定运行了几个月，体验可以说是天壤之别。

简单来说，OpenClaw是一个开源的AI智能体框架，你可以把它理解为一个“AI大脑”的调度中心。它本身不直接提供AI能力，但可以连接和协调后端的大语言模型（比如通过Ollama部署的Llama、Qwen等）、图像生成模型、以及各种工具（如搜索、代码执行、文件操作），从而构建出能完成复杂任务的自动化智能体。它的核心价值在于“编排”和“集成”，让你能用相对统一的界面和指令，去驱动背后可能分散在不同地方的各种AI能力。

那么，为什么要把这样一个框架放到云端？核心原因有三个：可访问性、资源弹性和运维简化。本地部署，你的服务就被锁死在一台设备上；云端部署后，你可以在任何有网络的地方，通过浏览器访问你的OpenClaw服务，实现真正的“随身AI助手”。资源弹性更是云端的王牌，当你需要运行一个70B参数的大模型时，可以临时开一台高内存的GPU服务器，用完即释放，成本可控。而运维方面，云服务商提供了现成的监控、备份、安全组等工具，比你从头搭建要省心得多。

本次指南，我将以腾讯云作为主要平台，为你拆解从零开始，在云端搭建一个稳定、可用的OpenClaw服务的完整流程。我会重点解释每一个配置选项背后的逻辑，而不仅仅是扔给你一串命令。毕竟，知道“为什么”这么配，远比记住“怎么配”更重要，这样下次遇到类似问题，你才能自己解决。

2. 云端部署平台选型：不止腾讯云，还有哪些选择？

在一头扎进腾讯云的配置之前，我们先花点时间看看整个“地图”。选择腾讯云，并不意味着它是唯一或永远最好的选择，了解其他选项的优劣，能帮助你在未来根据需求变化做出更合适的决策。目前主流的云平台对部署OpenClaw这类应用的支持度都相当不错，但侧重点和成本结构有所不同。

2.1 主流云平台横向对比

为了更直观，我将阿里云、腾讯云、AWS和海外的一些VPS服务商进行了一个简单的对比，重点关注与OpenClaw部署相关的几个维度：

注意：对于绝大多数国内个人开发者或中小团队，我的建议是优先在腾讯云和阿里云之间选择。它们对国内网络环境优化最好，支付和客服支持也更方便。腾讯云的轻量应用服务器对于入门和中小型项目来说，是性价比极高的选择。

2.2 为什么本次重点讲解腾讯云方案？

结合OpenClaw的典型使用场景和我们的目标，腾讯云方案凸显出几个关键优势：

1. 开箱即用的便捷性：腾讯云轻量应用服务器提供了“应用镜像”，其中包含“Docker CE”镜像。这意味着你购买服务器后，系统内已经预装好了Docker和Docker Compose，省去了手动安装、配置的步骤，对于部署基于容器的OpenClaw来说，这是巨大的时间节省。
2. 极佳的内网体验：如果你计划在同一台服务器上，同时部署OpenClaw容器和Ollama容器（用于本地运行大模型），那么它们之间的通信将走腾讯云的内网。内网带宽是免费的，而且延迟极低、速度极快，这对于需要频繁调用大模型的OpenClaw来说，能显著提升响应速度。
3. 成本可控的入门选择：对于个人学习或小规模使用，腾讯云轻量应用服务器（2核4G6M配置）每月仅需几十元，新用户首年甚至有更低折扣。这个配置足以流畅运行OpenClaw框架本身以及一个7B~13B参数量的量化版大模型（通过Ollama）。
4. 无缝的域名与SSL集成：腾讯云本身提供域名注册和DNS解析服务。后续如果你想为你的OpenClaw服务绑定一个自定义域名，并启用HTTPS（使用Let‘s Encrypt自动续签证书），在腾讯云生态内完成这些操作会非常顺畅，文档和教程也更容易找到。

当然，没有完美的方案。如果你的用户主要在海外，或者需要用到非常顶级的GPU资源（如A100），那么AWS或GCP可能是更好的选择。但就通用性、易用性和性价比的平衡而言，腾讯云确实是国内用户部署OpenClaw的一个“甜点区”选择。

3. 腾讯云服务器初始化与核心环境配置

假设你已经注册了腾讯云账号，并领取或购买了轻量应用服务器。接下来，我们从零开始，完成服务器的初始化配置，这是保证后续一切部署顺利的基础。很多问题都源于最初的环境没配好。

3.1 服务器选购与系统镜像选择

登录腾讯云控制台，进入“轻量应用服务器”购买页面。在配置选择上，我有以下建议：

• 地域：选择离你或你的目标用户最近的地域。例如，用户主要在华东，就选“上海”或“南京”。这能降低网络延迟。
• 镜像：这是关键一步！务必选择“应用镜像”选项卡下的“Docker CE”镜像。这个镜像基于CentOS或Ubuntu，但已经预装了Docker引擎和Docker Compose。这能省去你至少半小时的安装和调试时间。
• 套餐：对于学习和测试，“2核CPU、4GB内存、6Mbps带宽、80GB SSD”的套餐是起步的黄金选择。4GB内存刚好可以运行一个轻量化的OpenClaw和一个小参数模型。如果预算允许，或者你计划运行更大的模型，建议直接上“4核8G10M”或更高配置。带宽方面，6Mbps对于网页访问和API调用已经足够，除非你需要频繁上传下载大文件。
• 时长：新用户通常有首年优惠，建议直接购买一年，性价比最高。

完成购买后，服务器会自动创建并初始化。等待几分钟，状态变为“运行中”后，就可以进行下一步了。

3.2 安全组配置：守护你的服务入口

安全组相当于云服务器的虚拟防火墙。默认的安全组规则可能只开放了22（SSH）、80（HTTP）、443（HTTPS）和3389（Windows RDP）端口。OpenClaw默认的Web服务端口是3000，我们需要手动放行它。

1. 在服务器管理页面，找到你的实例，点击进入详情页。
2. 找到“防火墙”或“安全组”标签页，点击“添加规则”。
3. 添加一条入站规则：
   • 类型：自定义
   • 来源：0.0.0.0/0(表示允许所有IP访问。在生产环境中，强烈建议你将其改为你自己的公网IP或IP段，以增强安全。但为了测试和简化，这里先允许所有。)
   • 协议端口：TCP:3000
   • 策略：允许
   • 备注：OpenClaw Web UI
4. 点击“确定”。同样地，如果你后续需要其他端口（例如Ollama的11434端口），也在这里一并添加。

实操心得：我习惯在初始化时就规划好所有可能需要用到的端口，比如OpenClaw的3000，Ollama的11434，以及可能用到的数据库端口等，一次性在安全组里配置好，避免后续部署时被防火墙挡住，排查起来又得回头找这里。

3.3 首次登录与基础优化

通过控制台提供的VNC登录，或者使用SSH客户端（如Termius, FinalShell，或系统自带的终端）连接你的服务器。连接地址是你的公网IP，用户名为root（Docker CE镜像默认），密码在控制台可以获取或重置。

登录后，建议立即执行几个基础操作：

1. 更新系统包：虽然应用镜像比较新，但更新一下总没错。

   apt update && apt upgrade -y # 如果是CentOS系统，则使用：yum update -y

2. 设置时区：确保服务器时间是准确的，这对日志记录和定时任务很重要。

   timedatectl set-timezone Asia/Shanghai

3. （可选）创建新用户：长期使用root用户有风险。建议创建一个具有sudo权限的普通用户。

   adduser your_username usermod -aG sudo your_username

   之后可以使用新用户登录。

完成这些，你的云端“地基”就已经打好了。接下来，我们开始部署OpenClaw的核心。

4. 使用Docker部署OpenClaw：详解配置与持久化

Docker是部署OpenClaw最推荐的方式，它能完美解决环境依赖问题，保证在任何地方运行起来的行为都是一致的。腾讯云预装的Docker环境让我们可以直接跳过安装环节。

4.1 拉取OpenClaw镜像与目录准备

官方提供了OpenClaw的Docker镜像。首先，我们创建一个专门的工作目录，用于存放所有配置和持久化数据。

mkdir -p /opt/openclaw cd /opt/openclaw

接下来，拉取最新的OpenClaw镜像。你可以去Docker Hub查看具体的版本标签。

docker pull openwebui/open-claw:latest # 或者指定一个稳定版本，例如 # docker pull openwebui/open-claw:0.2.9

拉取镜像可能需要一些时间，取决于网络速度。完成后，可以使用docker images命令查看。

4.2 编写Docker Compose配置文件

单纯使用docker run命令也可以，但参数又长又难管理。使用Docker Compose可以通过一个YAML文件定义整个服务，包括端口映射、环境变量、数据卷等，管理和维护起来清晰得多。

在/opt/openclaw目录下，创建一个名为docker-compose.yml的文件：

version: '3.8' services: openclaw: image: openwebui/open-claw:latest # 使用你拉取的镜像标签 container_name: openclaw restart: unless-stopped # 确保容器意外退出时自动重启 ports: - "3000:3000" # 将容器内的3000端口映射到宿主机的3000端口 environment: - OLLAMA_BASE_URL=http://ollama:11434 # 关键！指向Ollama服务，假设Ollama容器名为ollama - DEFAULT_MODEL=llama3.2:1b # 设置OpenClaw启动后默认使用的大模型 - OPEN_CLAW_API_KEY=your_super_secret_api_key_here # 设置一个API密钥，用于安全调用 - OPEN_CLAW_HOST=0.0.0.0 # 监听所有网络接口 volumes: - ./data:/app/data # 将容器内的/app/data目录挂载到宿主机的./data，实现数据持久化 - ./logs:/app/logs # 挂载日志目录，方便查看 # depends_on: # 如果你打算在同一compose文件中部署Ollama，可以取消注释 # - ollama networks: - openclaw-network # 以下是Ollama服务的示例配置，你可以选择单独部署或使用远程API # ollama: # image: ollama/ollama:latest # container_name: ollama # restart: unless-stopped # ports: # - "11434:11434" # volumes: # - ./ollama_data:/root/.ollama # 挂载Ollama模型数据目录 # networks: # - openclaw-network networks: openclaw-network: driver: bridge

对这个配置文件的深度解读：

• OLLAMA_BASE_URL：这是连接后端大模型的核心环境变量。这里我设置的是http://ollama:11434，意思是OpenClaw会通过Docker网络，寻找一个名为ollama的容器，访问其11434端口。如果你已经有远程的Ollama服务（比如在另一台服务器上），这里就改成对应的URL，例如http://your-ollama-server-ip:11434。
• DEFAULT_MODEL：指定OpenClaw启动后默认选用的模型。这里填写的llama3.2:1b必须是你后端Ollama服务中已经拉取（pull）好的模型名称。模型名不匹配会导致连接失败。
• OPEN_CLAW_API_KEY：强烈建议设置。如果不设置，你的OpenClaw API可能处于无认证状态，存在被滥用的风险。请将其替换为一个复杂的随机字符串。
• volumes：数据卷挂载是持久化的关键。./data和./logs是相对于docker-compose.yml文件的宿主目录。这样，即使容器被删除重建，你的对话历史、配置等数据也会保留在宿主机上。
• networks：我们创建了一个自定义的Docker网络openclaw-network。这样，如果OpenClaw和Ollama都在这个网络中，它们可以通过容器名直接通信，无需关心IP地址变化，这是Docker Compose的最佳实践之一。

4.3 启动服务与验证

配置文件准备好后，在/opt/openclaw目录下，执行以下命令启动服务：

docker-compose up -d

-d参数表示在后台运行。执行后，使用docker-compose ps查看服务状态，应该看到openclaw容器状态为Up。

现在，打开你的浏览器，访问http://你的服务器公网IP:3000。如果一切顺利，你应该能看到OpenClaw的Web用户界面。

踩坑记录：第一次访问时，我遇到了页面空白或连接超时的问题。排查步骤通常是：1. 检查安全组3000端口是否开放；2. 使用docker-compose logs openclaw查看容器日志，看是否有启动错误；3. 在服务器内部用curl http://localhost:3000测试，如果内部能通但外部不通，基本就是安全组或云厂商网络ACL的问题。

5. 配置后端大模型服务：Ollama的集成与优化

OpenClaw本身是一个“大脑”，它需要“智力”来源，这就是大语言模型。我们将Ollama作为本地模型运行引擎集成进来。Ollama以其简单的模型管理和高效的本地运行能力，成为OpenClaw的黄金搭档。

5.1 部署Ollama服务

你可以选择将Ollama与OpenClaw部署在同一台服务器（即同一个docker-compose网络中），也可以部署在另一台性能更强、带GPU的服务器上。这里以同服务器部署为例。

修改上面的docker-compose.yml文件，取消注释Ollama服务部分，并确保OpenClaw服务配置中的depends_on也取消注释。最终文件如下：

version: '3.8' services: openclaw: image: openwebui/open-claw:latest container_name: openclaw restart: unless-stopped ports: - "3000:3000" environment: - OLLAMA_BASE_URL=http://ollama:11434 - DEFAULT_MODEL=llama3.2:1b - OPEN_CLAW_API_KEY=your_super_secret_api_key_here - OPEN_CLAW_HOST=0.0.0.0 volumes: - ./data:/app/data - ./logs:/app/logs depends_on: - ollama networks: - openclaw-network ollama: image: ollama/ollama:latest container_name: ollama restart: unless-stopped ports: - "11434:11434" volumes: - ./ollama_data:/root/.ollama networks: - openclaw-network networks: openclaw-network: driver: bridge

然后，重新启动服务（因为配置发生了变化）：

docker-compose down docker-compose up -d

这次启动会同时拉起OpenClaw和Ollama两个容器。

5.2 拉取与管理大模型

Ollama容器运行后，我们需要进入容器内部，拉取我们需要的模型。模型文件很大，请确保服务器磁盘空间充足（我们之前挂载的./ollama_data目录就是用来存模型的）。

1. 进入Ollama容器：

   docker exec -it ollama bash

2. 在容器内，使用ollama pull命令拉取模型。对于2核4G的服务器，建议从较小的模型开始，例如：

   ollama pull llama3.2:1b # 1B参数，对内存要求极低 ollama pull qwen2.5:0.5b # 千问0.5B，中文优化好，体积小

   如果你的服务器内存大于8G，可以尝试7B级别的模型：

   ollama pull llama3.2:3b ollama pull qwen2.5:3b

   模型选择建议：参数越大，通常能力越强，但消耗的内存和响应时间也呈指数级增长。对于智能体框架，推理速度（Token/s）和稳定性有时比模型的绝对能力更重要。建议先从1B或3B的模型开始测试整个流程，确保框架工作正常，再根据硬件升级模型。

3. 拉取完成后，在容器内使用ollama list查看已下载的模型。

4. 退出容器：exit。

5.3 在OpenClaw中连接与测试模型

回到OpenClaw的Web界面（http://你的服务器公网IP:3000）。

1. 首次设置：首次访问可能会让你设置管理员账号和密码，按提示操作即可。
2. 进入模型设置：登录后，在设置或模型管理页面（不同版本UI位置可能不同），你应该能看到“模型提供商”或“后端服务”的配置项。
3. 配置Ollama连接：
   • 提供商选择Ollama。
   • API URL 应该已经自动填充为我们在环境变量中设置的http://ollama:11434（因为容器在同一网络内）。如果没自动填充，手动填入http://ollama:11434。
   • 点击“测试连接”或“获取模型”。如果配置正确，下方应该会列出你在Ollama中已经拉取的所有模型，例如llama3.2:1b,qwen2.5:0.5b。
4. 选择默认模型：从列表中选择一个模型（比如llama3.2:1b）作为默认聊天模型。保存设置。
5. 进行对话测试：返回主聊天界面，输入一个问题，比如“请用Python写一个简单的Hello World程序”。如果看到模型开始流式输出回答，恭喜你，整个链路已经打通了！

常见问题排查：如果OpenClaw无法列出模型，首先检查Ollama容器日志docker-compose logs ollama，看模型是否拉取成功、服务是否正常启动。其次，在OpenClaw容器内执行curl http://ollama:11434/api/tags，看是否能返回JSON格式的模型列表。这个命令能帮你定位是网络连通性问题还是Ollama服务本身的问题。

6. 进阶配置：域名、HTTPS与反向代理

通过IP和端口访问服务既不安全也不方便。我们需要绑定域名并启用HTTPS。这里我推荐使用Nginx反向代理+Let‘s Encrypt免费SSL证书的方案，这是生产环境的标准做法。

6.1 准备工作：域名与DNS解析

1. 在腾讯云或其他域名注册商购买一个域名，例如your-ai-domain.com。
2. 在腾讯云DNS解析控制台，为你的域名添加一条A记录：
   • 主机记录：@(表示主域名) 或openclaw(表示子域名openclaw.your-ai-domain.com)
   • 记录值：填写你的腾讯云服务器的公网IP地址。
   • TTL：默认10分钟即可。
3. 等待DNS生效，通常几分钟到半小时。你可以用ping your-ai-domain.com来测试是否解析到了正确的IP。

6.2 使用Nginx Proxy Manager简化配置

手动配置Nginx和申请SSL证书比较繁琐。我强烈推荐使用Nginx Proxy Manager (NPM)这个工具，它提供了友好的Web界面来管理反向代理和SSL证书。

我们同样用Docker Compose来部署NPM。在服务器上找一个新目录，比如/opt/npm：

mkdir -p /opt/npm cd /opt/npm

创建docker-compose.yml文件：

version: '3.8' services: app: image: 'jc21/nginx-proxy-manager:latest' container_name: nginx-proxy-manager restart: unless-stopped ports: - '80:80' # HTTP端口，用于申请证书时的验证 - '443:443' # HTTPS端口 - '81:81' # NPM管理界面端口 environment: DB_SQLITE_FILE: "/data/database.sqlite" DISABLE_IPV6: 'true' volumes: - ./data:/data - ./letsencrypt:/etc/letsencrypt networks: - openclaw-network # 连接到之前创建的同一网络，方便内部通信 networks: openclaw-network: external: true # 使用外部已存在的网络

注意，我们让NPM容器也加入了之前为OpenClaw创建的openclaw-network网络。这样，NPM容器就能通过容器名（如openclaw:3000）直接访问到OpenClaw服务，无需经过公网IP。

启动NPM：

docker-compose up -d

6.3 配置反向代理与SSL证书

1. 访问NPM管理界面：http://你的服务器公网IP:81。
2. 首次登录，默认邮箱：admin@example.com，密码：changeme。登录后会强制你修改密码和邮箱。
3. 添加代理主机：
   • 点击 “Proxy Hosts” -> “Add Proxy Host”。
   • Details标签页：
     • Domain Names: 填写你的域名，例如openclaw.your-ai-domain.com。
     • Scheme:http
     • Forward Hostname / IP:openclaw(这是OpenClaw容器的名称，因为它们在同一个Docker网络内)
     • Forward Port:3000
   • SSL标签页：
     • SSL Certificate: 选择 “Request a new SSL Certificate”。
     • 勾选 “Force SSL” 和 “HTTP/2 Support”。
     • 勾选 “I agree to the Let‘s Encrypt Terms of Service”。
     • 填写一个有效的邮箱地址（用于证书到期提醒）。
   • 点击 “Save”。NPM会自动为你申请并配置Let‘s Encrypt的SSL证书，这个过程可能需要一两分钟。

配置完成后，你就可以通过https://openclaw.your-ai-domain.com安全地访问你的OpenClaw服务了！浏览器地址栏会显示安全锁标志。

重要提示：现在你的OpenClaw服务同时暴露在两个端口：3000（原始HTTP）和443（通过NPM的HTTPS）。为了安全，你应该回到腾讯云安全组，关闭3000端口的公网访问，只保留80和443端口开放。这样，所有流量都必须经过NPM的反向代理和HTTPS加密，更加安全。

7. 日常运维、监控与问题排查指南

部署完成只是开始，让服务稳定运行才是关键。这里分享一些日常维护和问题排查的经验。

7.1 基础运维命令

掌握几个Docker Compose命令，足以应对大部分日常操作：

• 查看服务状态和日志：

  cd /opt/openclaw docker-compose ps # 查看容器状态 docker-compose logs # 查看所有容器日志 docker-compose logs -f openclaw # 实时跟踪OpenClaw容器日志 docker-compose logs --tail=100 ollama # 查看Ollama容器最后100行日志

• 重启、停止、启动服务：

  docker-compose restart # 重启所有服务 docker-compose restart openclaw # 仅重启OpenClaw服务 docker-compose stop # 停止所有服务 docker-compose start # 启动所有服务

• 更新服务：当有新的OpenClaw或Ollama镜像发布时。

  docker-compose pull # 拉取最新的镜像 docker-compose up -d # 重新创建并启动容器（会使用新镜像）

• 进入容器执行命令：

  docker-compose exec openclaw bash # 进入OpenClaw容器 docker-compose exec ollama ollama list # 在Ollama容器内执行ollama list命令

7.2 监控服务器资源

OpenClaw和Ollama（尤其是运行大模型时）比较消耗CPU和内存。你需要知道如何监控服务器状态。

1. 基础命令：

   htop # 一个交互式的进程查看器，可以直观看到CPU、内存使用情况。 df -h # 查看磁盘空间使用情况。 docker stats # 查看所有Docker容器的实时资源占用（CPU、内存、网络IO）。

2. 设置告警（腾讯云）：在腾讯云控制台的“云监控”中，可以为你的轻量服务器设置告警策略。例如，当CPU使用率持续5分钟超过80%，或者内存使用率超过90%时，通过微信、短信或邮件通知你。这是预防服务因资源耗尽而崩溃的有效手段。

7.3 常见问题与排查思路

即使按照指南操作，你也可能会遇到一些问题。以下是一些常见问题的排查清单：

• 问题：OpenClaw Web页面无法打开（连接被拒绝/超时）

  • 排查：
    1. 检查安全组：确保服务器的安全组规则已放行对应端口（3000或443）。
    2. 检查容器状态：docker-compose ps，确认容器是Up状态。
    3. 检查容器日志：docker-compose logs openclaw，看是否有启动错误，比如端口被占用、数据库连接失败等。
    4. 服务器内测试：在服务器上执行curl http://localhost:3000，如果通，则是外部网络或安全组问题；如果不通，则是容器内部服务问题。

• 问题：OpenClaw无法连接到Ollama模型（测试连接失败/模型列表为空）

  • 排查：
    1. 检查Ollama容器状态和日志。
    2. 检查OpenClaw环境变量OLLAMA_BASE_URL是否正确。如果是同Compose部署，应为http://ollama:11434。
    3. 进入OpenClaw容器，执行curl http://ollama:11434/api/tags，看是否能返回模型列表。如果不能，说明两个容器网络不通。
    4. 确认Ollama中已拉取模型：docker-compose exec ollama ollama list。

• 问题：模型响应速度极慢或经常超时

  • 排查：
    1. 检查服务器资源：使用htop和docker stats查看CPU和内存是否已满。运行大模型时内存不足是首要原因。
    2. 降低模型规格：尝试换用更小的模型（如从7B换到3B）。
    3. 检查网络延迟：如果Ollama在远程服务器，用ping测试延迟和丢包。
    4. 查看Ollama日志：是否有“out of memory”或GPU相关的错误。

• 问题：Let‘s Encrypt SSL证书申请失败

  • 排查：
    1. 确保域名已正确解析到服务器IP，并且生效（可以用ping测试）。
    2. 确保服务器的80端口是开放的（Let‘s Encrypt验证需要）。
    3. 在NPM的SSL证书申请界面，查看详细的错误信息。常见错误是DNS解析问题或网络连通性问题。
    4. 可以尝试在NPM中删除该代理主机，重新添加并申请证书。

部署和运维是一个持续的过程，遇到问题不要慌，按照“现象 -> 日志 -> 配置 -> 网络 -> 资源”这个链路一步步排查，大部分问题都能找到根源。把这次在腾讯云上部署OpenClaw的经历当作一个起点，你已经拥有了一个随时可访问、可扩展的个人AI智能体平台，接下来可以尽情探索OpenClaw的技能开发、多模型调度等更高级的功能了。