这两年AI圈最热闹的方向之一就是“个人AI代理”。你要是刷到过 OpenClaw 或者 Clawdbot 这个名字又没搞明白它到底能干嘛那这篇文章值得花几分钟慢慢看。简单说OpenClaw 是一套开源的 AI 代理Agent框架你可以把它理解成一个“赛博管家”把大模型接进来再配上一堆技能skill它就能替你跑任务、查资料、写简报、操作接口甚至定时干活。我最初是在一个技术群里看到有人用它自动整理邮件顺便生成每日工作摘要当时我就觉得这东西迟早会火。只是本地跑这个管家多少有点“养在深闺”的味道——电脑一关它就下班网络环境一换它就失联。所以把它部署到云服务器上让它 7x24 小时在线才是真正符合“管家”身份的玩法。我这次选的是京东云整体流程走下来比想象中顺。这篇文章就完整记录我从选机器到配置、启动、排错的全过程新手照着做也能把这套东西稳稳推上线。1. 先搞清楚 OpenClaw 是什么再决定要不要折腾1.1 把 OpenClaw 当“赛博管家”来理解很多朋友一上来就搜“OpenClaw 安装”“Clawdbot 部署”然后被一堆配置文件吓退。先别急着敲命令我们用大白话理解一下它到底是什么。你可以把 OpenClaw 想象成一个骨架大模型是它的“大脑”skill 是它的“手脚”。骨架负责把大脑和手脚连起来你告诉它一个目标它调用大模型去理解意图再调动对应的 skill 去执行操作。比如你配置了一个“定时抓取某网站新闻并生成摘要”的 skill它就会按时打开目标网站、抓取正文、交给大模型归纳、再把摘要推送给你配置好的接口。所以 OpenClaw 本质上不是某个“成品 App”而是一个“组装框架”。这也是为什么网上教程五花八门——因为每个人装的技能、接的模型、跑的容器都不一样。理解这一点你在看后续配置时就不会懵核心其实就三件事装框架、填模型凭证、配技能清单。顺便说一句Clawdbot 和 OpenClaw 经常被混着叫其实它们指的都是同一个开源生态里的项目名字不同主要是版本迭代和社区叫法的问题。下面我统一用 OpenClaw 来称呼操作上没有差别。1.2 为什么要部署到京东云这类云端服务器有人可能会问我本地电脑跑得好好的为什么要专门上云这个问题我实测下来很有发言权。第一个理由是“在线率”。本地部署意味着你的电脑必须一直开机睡眠、断电、重启都会让代理断档。而云服务器可以常年挂着你在手机上也能随时看它的运行状态。第二个理由是“网络环境”。云端服务器有固定的公网 IP不像家庭宽带的 IP 会漂移。固定 IP 意味着你可以稳定地通过 Web 控制台管理它后续要接入微信机器人、钉钉机器人或者短信通知回调地址都能填这个固定 IP省去一大堆内网穿透的麻烦。第三个理由可能最实在——国内访问速度。京东云的基础节点在国内控制台、API 的响应速度都是本地直连的水平不像海外服务器动不动就是几百毫秒延迟。对于新手来说这种“打开就通”的体验太重要了少掉很多排查网络问题的火气。1.3 适合哪些人来学这套部署流程这套流程最适合三类人。第一类是 AI 爱好者买过各种会员、用过各种大模型 API但想自己搭一套“私有管家”不被平台功能绑死。第二类是开发者需要把 OpenClaw 整合进自己的项目比如自动跑测试、定时拉取数据、对接内部系统。第三类纯粹是“折腾党”的享受从零到一把服务跑起来的成就感。如果你完全没接触过 Linux 和云服务器也没关系。下面每一步我都会拆细告诉你怎么登录、命令是干什么用的、什么地方最容易出错。当然我还是建议你至少会最基本的 SSH 连接操作否则后面排查问题会很吃力。2. 部署前的准备工作一台像样的云主机和安全组2.1 京东云机型与配置怎么选新手第一反应通常是“配置越高越好”其实没必要。OpenClaw 本身是一个轻量框架真正吃资源的是它背后调用的能力——如果你接的是云端大模型 API本机只负责逻辑编排资源消耗并不大。我这次用的是京东云的轻量应用服务器2 核 4G 内存、50GB SSD、带宽 5Mbps对跑 OpenClaw 来说已经完全够用。下面是不同场景的选型建议可以直接抄作业使用场景推荐配置理由新手入门、API 接模型2核4G / 50GB SSD性价比高跑框架和 Web 控制台绰绰有余多个 skill 并发、定时任务多4核8G / 80GB SSD并发任务吃内存8G 会更从容本地部署开源小模型7B-13B量化版8核16G起步最好有GPUCPU 推理非常吃力GPU 实例体验才正常企业级接入、多用户使用8核16G / 按需弹性带宽要考虑并发和稳定性建议加监控告警我这台机子的选择思路是先把管家跑起来模型调用全部走 API。等以后真想在云端跑本地模型再单独升级 GPU 实例也不迟避免一上来就烧钱。另外操作系统建议选 Ubuntu 22.04 LTS 或 24.04 LTS。原因是 OpenClaw 的文档和社区示例基本都是基于 Debian 系的软件源全、依赖好装、Docker 支持也好。你如果选 CentOS后面装包可能要多绕路。2.2 创建实例后必做的三件事服务器买好后别急着关页面。三件事先做掉后面能省心很多。第一设置登录密码。京东云创建时会让你设置 root 密码注意这个密码一定要保存好——它的强度要求不算低而且一旦忘记重置流程很麻烦。如果你习惯用密钥登录就在控制台提前配置好密钥对这是更安全的登录方式。第二配置安全组。安全组就是云服务器的“防火墙规则”默认情况下很多端口是不对外开放的。你需要放行以下端口端口用途建议22SSH 远程登录必须放行也可修改为非默认端口8080 或其他 Web 端口OpenClaw Web 控制台必须放行否则浏览器打不开3000等 API 端口具体看项目配置按需放行不要全开我在安全组这里吃过亏第一次部署时忘了放行 Web 控制台端口结果服务启动了一切正常就是浏览器死活打不开最后查了半天才发现是安全组把端口拦了。所以安全组规则在你创建实例后第一时间就配好可以少走很多弯路。第三测试 SSH 登录。本机打开终端Windows 用 PowerShell 或 CMD 都行输入ssh root你的服务器公网IP如果提示输入密码输入刚才设置的 root 密码就进去了。看到类似Welcome to Ubuntu的提示就说明你成功登上了服务器。这一步成功后后面的所有操作就都可以在 SSH 会话里完成了。2.3 系统初始化与常用工具安装新服务器到手第一件事不是装 OpenClaw而是先把系统更新一遍。这个习惯我建议每个新手都养成——云厂商的初始镜像大概率不是最新的里面可能有安全补丁没打依赖源也没刷新。登录服务器后依次执行sudo apt update sudo apt upgrade -y更新需要一两分钟看到一堆软件包更新完就对了。然后装几个基础工具后面会用得上sudo apt install -y curl wget git vimcurl 和 wget 用来下载文件、测试接口git 用来拉取项目源码vim 是文本编辑器改配置文件靠它。装完后可以用git --version验证一下是否成功。这里插入一个经验之谈不要跳过系统更新这一步直接去装 Docker。老旧的软件源经常会导致 apt 装包时出现依赖冲突尤其是装 Docker 这种对内核模块和网络组件有要求的软件。系统底子打好了后面才顺。3. 核心部署实操把 OpenClaw 跑起来3.1 方案选型Docker Compose 还是源码安装OpenClaw 的官方部署方式主要有两种Docker 镜像和源码运行。新手我强烈建议选 Docker Compose。为什么Docker 把框架、依赖、运行时环境全部打包成一个镜像你不需要在机器上手动装 Python 环境、Node.js 环境也不会因为系统库版本不对导致各种“装了一半跑不起来”的悲剧。整个部署过程归纳成一句拉镜像、写配置、启动。源码安装的优势是定制性强可以随时改代码、加补丁适合开发者深度二次开发。但对新手来说这不是优势反而是坑——每次从 git 拉最新代码都可能引入新的依赖变更你的服务器就得跟着装新东西很容易陷入“依赖地狱”。所以下面我以 Docker Compose 为主线来说明。如果官方仓库提供了安装脚本比如install.sh也可以执行脚本快速部署但 Docker 方案的统一性更高后文讲解也更好复现。3.2 拉取项目并配置核心参数我在服务器上建了一个专门的工作目录建议你也这么做方便统一管理mkdir -p /opt/openclaw cd /opt/openclaw接下来需要确认当前最新版本的 Docker 镜像名和端口规则。不同版本镜像名可能有差异常见的是openclaw/openclaw:latest这类格式。以官方仓库 README 为准。保险的做法是先把仓库克隆下来从里面的docker-compose.yml文件获得准确的镜像名和端口映射git clone https://github.com/openclaw/openclaw.git /opt/openclaw cd /opt/openclaw ls -la你会看到docker-compose.yml、.env.example之类的文件。复制一份环境变量示例文件cp .env.example .env vim .env.env文件是 OpenClaw 的核心配置入口你需要重点关注以下变量配置项说明填什么OPENCLAW_AGENT_BRAIN_MODEL指定用哪个大模型比如 deepseek-chat或兼容 OpenAI 接口的模型名OPENCLAW_AGENT_BRAIN_API_KEY模型服务商提供的密钥在模型服务商控制台申请OPENCLAW_AGENT_BRAIN_API_URL模型接口地址国内服务商一般是 https://api.deepseek.com 之类的域名OPENCLAW_PORTWeb 控制台监听端口建议 8080OPENCLAW_BIND_IP监听地址必须填 0.0.0.0否则外网访问不了这一步是新手最懵的地方。打个比方OpenClaw 是身体大模型 API 是灵魂。你不把“灵魂”的接口和密钥配好身体再健壮也是空的。配置时建议先只配一个主模型比如用 DeepSeek 的 API等跑通了再加别的模型。一次配一堆容易互相干扰排查起来头大。填好后保存退出。然后看看 docker-compose.yml 里的端口映射格式确认它把容器内的端口映射到了宿主机的哪个端口。比如ports: - 8080:8080左边是宿主机的端口右边是容器内部的端口。你要保证左边端口和刚才 .env 里填的 OPENCLAW_PORT 一致。3.3 启动、日志排查与功能验证启动命令很简单但启动前的检查更关键。先确认 Docker 环境是否正常docker --version docker compose version如果系统提示找不到 docker 命令就先安装 Docker 引擎curl -fsSL https://get.docker.com | bash -s docker安装完后确认 Docker 服务开机自启sudo systemctl enable docker sudo systemctl start docker然后执行启动docker compose up -d-d的意思是后台运行。第一次启动会拉取镜像时间取决于网络状况耐心等几分钟。拉取完成后容器会启动用日志看一下有没有报错docker compose logs -f正常情况下你会看到框架加载配置、连接模型接口的日志。如果出现unauthorized、connection refused之类的关键词九成是 API key 或接口地址填错了回去改.env然后重启docker compose restart确认日志正常后先在本机验证服务是否响应curl http://127.0.0.1:8080能返回内容哪怕是 HTML 页面就说明服务起得来。然后在你自己的电脑浏览器打开http://你的服务器公网IP:8080能打开 Web 控制台恭喜你OpenClaw 已经成功部署上云了。整个核心周期其实很短慢的是拉镜像和第一次启动时的模型配置测试。3.4 让服务常驻后台systemd 守护配置如果你用的是 Docker Compose容器本身已经由 Docker 守护进程管理开机自启也没问题。但我见过不少新手为了省事直接在 SSH 里前台跑服务窗口一关服务就没了。这是非常典型的新手坑。我们明确一下前台运行属于调试模式只适合临时验证正式使用一定要让服务在后台常驻。Docker 方案下你确认一下 compose 文件里有没有配置restart: unless-stopped没有的话手动加到容器配置下restart: unless-stopped然后重新加载docker compose up -d这样即使服务器重启容器也会自动拉起。如果你用的是源码形式部署那需要 systemd 来守护。在/etc/systemd/system/openclaw.service写一个简单的服务配置[Unit] DescriptionOpenClaw Service Afternetwork-online.target Wantsnetwork-online.target [Service] WorkingDirectory/opt/openclaw ExecStart/usr/bin/python3 main.py Restartalways RestartSec10 Userroot Grouproot EnvironmentFile/opt/openclaw/.env [Install] WantedBymulti-user.target执行sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw之后用systemctl status openclaw查看服务状态看到active (running)就说明守护成功了。有个小细节Restartalways加RestartSec10的意思是如果进程崩了10 秒后自动重启这对长时间稳定运行非常重要。4. 常见问题排查与避坑指南4.1 端口不通、外网打不开的常见原因这是被问得最多的一个问题日志明明没报错但浏览器就是打不开控制台。出现这种情况按优先级排查三层安全组、本地防火墙、监听绑定地址。安全组这层我在前面强调过很多人漏放 8080 端口。检查方法很简单在京东云控制台找到“安全组”页面看入方向规则里有没有放行你配置的 Web 端口。第二层是服务器自身的防火墙。Ubuntu 默认可能装了 ufw你没主动放行端口的话它一样会拦。执行sudo ufw status如果状态是 active就放行端口sudo ufw allow 8080/tcp第三层是监听地址。前面我们说过 .env 里的 OPENCLAW_BIND_IP 必须填0.0.0.0。如果只填了127.0.0.1那服务只监听本机回环地址外网自然永远打不开。这三层检查完端口不通的问题基本能解决。4.2 API 连接失败与模型配置问题启动后如果日志里出现401 Unauthorized或403 Forbidden问题基本出在 API key 上。先确认你填的 key 有没有多余空格再确认 key 是否有效。很多 API 服务商的密钥格式有前缀比如sk-...复制时只复制 key 本身别把说明文字一起带进去。另一种常见情况是connection timeout或connect timeout。检查 API 的基础地址填的是不是https://开头有没有填成http://。如果模型服务商提供的是兼容 OpenAI 格式的接口通常路径是/chat/completions但 OpenClaw 配置里一般只需要填根域名路径会自动拼接。这里建议直接参考官方文档里的示例值别凭感觉猜。一个容易被忽略的选项是模型的上下文长度和最大 token 设置。有些模型在框架里默认设置过大API 返回invalid request这时需要你在 .env 或配置文件里调小max_tokens参数。这个参数和模型实际支持的上限有关先调成 1024 试跑通后再慢慢加大。4.3 资源占用过高与机器人卡顿2 核 4G 的机器跑 OpenClaw如果同时挂了五六个 skill出现卡顿很正常。原因是每个 skill 触发时都会调用大模型 APIAPI 等待期间框架需要保持并发连接内存就会见涨。排查资源占用最快的方式是top看 RES 列有没有进程吃掉绝大部分内存。如果内存常年在 85% 以上说明该优化了。最简单的方式是减少同时运行的 skill 数量其次是调低并发参数再不行就得升级到 4G 以上内存的机型。这里有个小技巧OpenClaw 大多数耗时操作其实是在等外部 API 返回CPU 负载一般不高。真正吃内存的是日志缓冲和并发会话。你可以把日志级别调高减少不必要的信息输出能明显降低内存压力。日志级别一般通过 .env 里的LOG_LEVEL配置填INFO只保留关键信息即可。4.4 卸载与重装的正确姿势装了不满意或者把配置搞乱了想推倒重来卸载也要卸得干净。网上也有人问“怎么卸载 OpenClaw”这里一起说清楚。如果你是 Docker Compose 部署的进入工作目录执行docker compose down这会把容器和网络停掉。如果你想连数据、日志一起清掉比如你要删掉所有配置重新开始再加一个-vdocker compose down -v-v的意思是同时删掉卷数据执行完再删掉整个工作目录sudo rm -rf /opt/openclaw至于 Docker 引擎本身一般不推荐卸载因为你以后部署其他服务大概率还会用到。如果是源码部署的步骤就更简单停掉 systemd 服务再删项目目录就行sudo systemctl stop openclaw sudo systemctl disable openclaw sudo rm -rf /opt/openclaw重装时注意之前的.env文件已经删掉要重新按文档配置一遍不要直接拿旧配置套新版本——不同版本之间的环境变量可能会有兼容性变化。5. 部署完还能怎么玩skill 扩展与多平台联动5.1 给 OpenClaw 安装 skill 技能包框架跑通只是第一步OpenClaw 真正的价值在于 skill。简单说一个 skill 就是一份给代理的“指令说明书”告诉它在什么情境下、做什么动作、用哪几个参数。比如“每日财经简报”这个 skill它会要求代理每天上午九点抓取指定财经网站的最新文章总结后推送到你预留的接口。skill 的安装一般是在 OpenClaw 的配置界面或目录下新建一个 skill 文件。以文件形式为例你需要在 skills 目录下建一个文件夹里面放一个 markdown 格式的说明文件文件里描述清楚这个 skill 的功能、触发的指令词、运行时需要哪些变量。官方仓库里通常有示例 skill先跑通一个简单的“定时播报时间”技能感受一下整套链路怎么走。我的建议是新手先只装两三个 skill跑熟了再往上加。skill 越多互相之间的指令冲突概率越高而且排查问题会更难。等你的代理越来越“好用”之后再逐步上量。5.2 手机端 Termux 与 Windows Companion 的联动思路网上有个热搜词是“openclaw 安卓部署”和“termux 安装 openclaw 手机版”其实这些思路本质上是把一个轻量的客户端或控制端装到手机里用来远程操控你部署在云端的实例。手机端并不需要跑完整框架它更多是充当一个“遥控器”让你随时给代理发任务、看日志、确认执行状态。如果你用安卓手机在 Termux 里装一个能连接远程服务的终端工具再配置好 SSH就可以直接连回京东云服务器在手机上敲命令查看 OpenClaw 的运行状态。Windows 用户则可以用官方或社区提供的 Companion 工具把电脑端的快捷操作面板和云端实例对接起来。这里的关键提醒是手机远程连接时一定要保管好服务器的登录密码和 API key不要在公共 WiFi 环境下明文输入敏感信息。云服务器暴露在公网上安全习惯要早早养成。5.3 我个人的一点使用体验和后续打算OpenClaw 部署到京东云之后我实际跑了两周最大的感触是“定时自动化”比“指令问答”有用得多。早期我主要是跟它聊天式地发任务后来配了几个定时 skill让它每天自动抓取我关注的行业信息、生成摘要推送到我钉钉机器人的 webhook。两周下来每天早上到公司打开手机就能看到整理好的简报这种体验确实比我自己手动刷网页高效太多了。踩过几次坑之后我最想分享的心得是部署开源 AI 项目不要把 80% 的精力花在“启动服务”上剩下的 20% 才花在“真正用好它”。服务启动只是万里长征第一步把 skill 配置好、让自动化流程真正贴合自己的需求才是长期能坚持用下来的原因。另外我在京东云控制台给它开通了基础的监控告警CPU 超过 80% 会自动推送通知。这个习惯建议大家也养成——毕竟代理是要跑长线的机器出问题最好第一时间知道而不是等发现服务断了才手忙脚乱地排查。等项目稳定后我打算再试试接入本地的小模型把一些隐私性要求高的任务分流到本地跑兼顾安全性和智能程度。部署这条路走到这一步才算真正开始发挥价值。