大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



折腾一下午，我的 OpenClaw 腾讯云部署全记录 & 避坑指南

纯个人技术折腾记录，非广告，就是把自己踩过的坑、完整的操作流程整理出来，给想自己搭 OpenClaw 的朋友做个参考。

我就是个普通的技术爱好者，平时喜欢折腾点开源工具，前段时间刷到 OpenClaw 这个开源 AI 智能体框架，可玩性很高，能自己接大模型、装插件，搭个完全属于自己的私人 AI 助手。本地跑要么电脑不能 24 小时开机，要么性能跟不上，就想着放到云服务器上。我自己一直用腾讯云的轻量应用服务器，有现成的账号，平时搭点小工具也顺手，这次就直接拿它来折腾了。

一、前置准备：服务器选型和基础配置

先说明，这里不是推荐配置，只是我自己用下来觉得够用的选择，大家可以根据自己的需求调整。

我选的是腾讯云轻量应用服务器，系统装的是 Ubuntu 22.04 LTS，配置是 2 核 4G、3M 带宽、60G 系统盘。选这个配置的原因很简单：如果只是用 OpenClaw 调用大模型 API，不本地跑大模型的话，这个配置完全够用，24 小时开机成本也不高，之前搭过别的服务，稳定性也没问题。

这里先讲我踩的第一个低级大坑，新手一定要避开：

服务器初始化之后，一定要先配置安全组！我一开始只开了 22 远程端口，后面服务全启动完了，死活访问不了网页，翻了半小时日志才反应过来，安全组没放开 OpenClaw 要用的端口。

大家直接在轻量服务器的防火墙 / 安全组里，添加入站规则，放开3000（前端默认端口）和8000（后端默认端口），源地址先设 0.0.0.0/0 就行，后面熟悉了再做限制，新手别漏了这一步。

远程连接的话，新手直接用腾讯云自带的 WebShell 就行，不用额外装 Xshell、FinalShell 这些工具，点开就能用，省很多事。

二、环境搭建：Docker 部署，避坑重点

OpenClaw 官方推荐 Docker Compose 部署，不用自己手动配一堆 Python 依赖，对新手友好很多，我全程也是用的这个方式，这里把踩过的坑和完整步骤说清楚。 1. 先更新系统

连接服务器之后，先执行系统更新，别图省事跳过，不然容易出现依赖缺失的问题：

sudo apt update && sudo apt upgrade -y

这里多说一句，别直接用 root 用户全程操作，用普通用户加 sudo 就行，安全很多，我一开始图省事用 root，后面出现了权限问题，又回头改，很麻烦。 2.  安装 Docker 和 Docker Compose

这是整个部署的核心，一步都别错。

先执行安装命令，Ubuntu 官方源里就有，直接装就行： 安装Docker sudo apt install docker.io -y 启动Docker并设置开机自启 sudo systemctl start docker

sudo systemctl enable docker 安装Docker Compose插件 sudo apt install docker-compose-plugin -y

重点避坑环节：国内直接拉 Docker Hub 的镜像，要么慢到离谱，要么直接超时失败，我一开始卡在这里快 20 分钟，后来换了国内镜像加速才解决。我用的是腾讯云自带的 Docker 镜像加速地址，不用额外注册，直接配置就行，步骤如下： 新建Docker配置文件 sudo tee /etc/docker/daemon.json <<-‘EOF’

{

“registry-mirrors”: [”https://mirror.ccs.tencentyun.com”]

}

EOF 重启Docker让配置生效 sudo systemctl daemon-reload

sudo systemctl restart docker

装完别直接往下走，先验证是否安装成功，我就是没验证，后面启动才发现 Docker 没装对，白折腾半天： 验证Docker版本 docker –version 验证Docker Compose版本 docker compose version

能正常输出版本号，就说明装成功了。

三、拉取项目 & 配置修改，细节决定成败  3.  拉取 OpenClaw 官方代码

这里又是一个国内用户的高频坑：直接拉 GitHub 仓库，大概率会超时、失败，我用了 GitHub 加速地址，一下就拉下来了，新手直接用这个方式就行： 带加速的克隆命令，把后面的官方仓库地址换成最新的就行 git clone https://ghproxy.com/https://github.com/openclaw/openclaw.git 进入项目目录 cd openclaw  4. 修改核心配置文件

这一步是重中之重，很多人启动失败，都是配置文件写错了。

的示例配置文件，生成我们要用的.env 配置文件：

cp .env.example .env

然后用编辑器打开.env 文件，新手直接用 nano 就行，操作简单：

nano .env

核心要改的只有大模型 API 配置，别的参数新手先别动，用默认值就行，避免出错。

OpenClaw 支持市面上几乎所有主流大模型，OpenAI、通义千问、智谱 AI、腾讯云混元这些都能接，我自己用的是腾讯云混元的 API，因为之前有免费的测试额度，就直接用了，大家有哪个模型的密钥，就配哪个就行。

这里说我踩的两个细节坑：

API 密钥和 BASE_URL，别加多余的引号，也别多写斜杠，我一开始就是 BASE_URL 末尾多写了一个 /，导致模型一直调用失败，翻了半天才找到问题；

只改你要用的模型配置，不用的模型别乱删、乱改，不然会出现配置读取失败的问题。

改完之后，按 Ctrl+O 保存，Ctrl+X 退出 nano 编辑器。

四、启动服务 & 访问测试，终于跑通了 5. 启动服务

配置改完，就可以一键启动服务了，执行下面的命令：

bash

运行

sudo docker compose up -d

加 - d 是后台运行，不然关掉终端，服务就直接停了，一定要加上。 6.  先排查，再访问

启动命令执行完，别着急去浏览器访问，先确认容器有没有正常运行，这是避坑的关键：

bash

运行

sudo docker ps

正常情况下，能看到 OpenClaw 相关的所有容器，状态都是 Up，如果有容器显示 Exited，就说明启动失败了，直接看日志排查问题：

bash

运行 把容器名换成你启动失败的容器名称 sudo docker logs 容器名

我自己在这里踩的坑是，服务器的 8000 端口被别的服务占用了，导致后端容器启动失败，后来回到.env 文件里改了后端端口，同时在安全组里放开了新端口，重新启动就正常了。  7. 访问测试

所有容器都正常运行之后，打开浏览器，输入http://你的服务器公网IP:3000，就能看到 OpenClaw 的登录界面了。

划重点，安全问题！

初始账号密码在官方文档里有写，第一次登录之后，一定要立刻修改默认密码！不然公网环境下，很容易被人扫描到，数据安全完全没保障。

五、使用感受 & 给新手的真心话

整个流程，不踩坑的话，半小时就能搞定，我自己踩了各种低级坑，前前后后折腾了一下午，不过跑起来之后是真的香。

先说说体验：24 小时在线，手机、电脑随时随地都能访问，所有数据都存在自己的服务器上，比用第三方 AI 工具放心很多。OpenClaw 的插件系统可玩性很高，我自己装了联网搜索、文件解析、定时任务的插件，现在日常用来整理资料、写代码片段、做日程提醒，完全够用。

当然也不是完美的，客观说，对纯小白来说，还是有一点门槛的，官方文档有些地方写得比较简略，移动端适配还有提升空间，有些小众插件需要自己额外配置，新手刚上手可能会有点懵。

最后给想自己动手的朋友几个真心建议：

别上来就买高配置服务器，先 2 核 4G 的轻量测试就行，完全够用，觉得好用再升级，别浪费钱；

先看官方文档，再跟着步骤操作，别上来就瞎改配置文件，90% 的启动失败都是配置写错了；

遇到问题先看容器日志，别上来就乱搜教程，越改越乱，日志里基本都写清了失败原因；

一定要重视安全，别乱开端口，默认密码必改，别用 root 用户日常操作，定期更新系统。

这篇就是纯个人的折腾记录，没有任何广告成分，就是觉得这个开源项目挺有意思，把自己的踩坑经验分享出来，大家有什么别的踩坑点，也可以一起交流。