1. 先说清楚OpenClaw到底是什么为什么值得放在云服务器上跑我在2026年4月重新把OpenClaw捡起来折腾了一遍起因很简单上个月在本地Windows上跑电脑一合盖机器人就失联了更别提那个“could not safely verify the WSL2 environment”的报错来来回回折腾了好几晚。后来索性直接在京东云开了一台轻量服务器把OpenClaw整个迁上去才算是把这事彻底理顺了。先给还没入坑的朋友一句话科普OpenClaw就是原来那个开源个人AI助手项目Clawdbot的新名字它本质上是一个“Agent运行时框架”。你给它一个大模型API作为大脑再接上微信、Telegram、Web等消息渠道然后通过聊天窗直接指挥它干活——查资料、写代码、定时发消息、调外部接口、串各种工具它都能干。所谓“Skill”就是给这个Agent装的各种技能包类似给手机装App装上之后它才会那一项本事。这套东西放在本地电脑上跑不是不行只是有几个绕不开的痛点WSL2环境校验问题Windows下官方脚本经常报“could not safely verify the WSL2 environment”本质是WSL2的版本、发行版状态或系统路径没达到校验要求但排查起来非常费劲电脑休眠/断网/重启Agent跟着掉线微信等渠道需要长连接本地网络经常不稳定以后想加定时任务、网页回调本地还得折腾端口映射。所以我的结论很直接OpenClaw这玩意儿的正确归属就是一台24小时不关机的云服务器哪怕配置不高只要内存够、带宽稳定就行。这篇文章会结合我在京东云上的完整部署过程把OpenClaw安装、大模型API配置、Skill装填以及一路踩过的坑都摊开讲。1.1 名字里的“龙虾”是什么来头很多搜索关键词里带着“openclaw龙虾”其实这个龙虾就是项目本身的吉祥物形象你会在项目文档、仓库头像、安装界面里经常看到它。搜“OpenClaw”时看到一堆龙虾图不用奇怪项目名里的Claw就是龙虾爪的意思。这套视觉形象和项目本身关系不大记住这个梗就行免得以为自己搜错了项目。1.2 本地部署失败率最高的不是安装步骤我观察很多群友在本地部署OpenClaw卡住的点往往不是OpenClaw本身而是环境准备。OpenClaw的依赖项比一般脚本项目多涉及Node.js运行时、Python组件、系统工具链、WSL2环境等只要有一个版本不对安装脚本就可能在半路中断。最典型的报错就是“could not safely verify the WSL2 environment”这行字我见过太多次了。云服务器则干净得多新开一台Ubuntu 22.04环境几乎是全新的安装脚本跑起来基本不会撞上乱七八糟的历史遗留问题。这也是我推荐云部署的最直接理由——省下的排查时间足够你学会配置好几个Skill了。2. 京东云选配与基础环境搭建2.1 轻量应用服务器还是云主机ECS京东云上能跑OpenClaw的选择不算少但如果只跑个人Agent轻量应用服务器和云主机ECS都可以我实际测试下来更推荐轻量应用服务器价格门槛低新用户活动价普遍很划算按年购比按量付费便宜自带固定带宽微信这类长连接场景不怕流量突发;系统镜像选择简单选Ubuntu 22.04直接一键初始化控制台操作简洁安全组规则配置比ECS稍微直观一点。当然如果你后面要跑多个服务、做复杂网络隔离那就上ECS配个2核4G的实例也够用。我最终用的是2核4G、40GB SSD、Ubuntu 22.04的轻量服务器跑OpenClaw加上日常插件负载大概在30%上下余量很充足。有个细节值得注意地域节点建议选离你常用线路近的。如果你接的腾讯/微信相关服务选华北或华东节点都行延迟差异其实不大。但如果你要调硅基流动、魔塔这类国内大模型API无论选哪个地域基本都没问题内网同区域反而更稳。2.2 安全组端口与SSH登录服务器创建完之后首先要做的是安全组配置。默认情况下京东云只放行了22端口这对SSH登录够了但OpenClaw如果开了Web控制面板或接收外部Webhook就需要额外放行端口。我的做法是22端口SSH远程登录保持放行建议改为密钥登录80/443端口如果后面打算配置域名、接网页控制台提前放行8080端口OpenClaw本地管理面板默认会用到的端口按需放行其余端口一律不开放能少开就少开。安全组规则加完之后直接在本地终端用SSH连上去ssh root你的服务器IP如果你和我一样习惯用密钥登录创建实例时先把公钥粘贴进去之后登录就不需要密码了。这一步虽然不影响OpenClaw安装但服务器如果是生产环境或者长期跑服务密钥登录比密码登录安全太多。2.3 基础软件安装curl、Git、DockerOpenClaw的安装方式有两类一类是官方一键脚本一类是Docker部署。无论走哪条路我建议先装好基础工具apt update apt upgrade -y apt install -y curl git wget vim如果你后面打算用Docker方式顺手把Docker也装掉curl -fsSL https://get.docker.com | bash systemctl enable --now docker docker --versionDocker装完后建议把当前用户加入docker组省得每次都要sudousermod -aG docker root这里有个容易忽略的点装完Docker后容器数据目录比较大建议先确认一下系统盘剩余空间。OpenClaw的配置、日志、Skills、模型缓存加起来少则几百MB多则几个GB。如果磁盘只有40GB跑几个月后最好看一眼磁盘占用避免日志把磁盘塞满导致服务异常。3. 安装OpenClaw从脚本到Docker的完整路径3.1 方式一官方一键脚本安装如果你喜欢简单直接用官方提供的一键脚本来装。在服务器上直接执行curl -sSf https://openclaw.com/install.sh | bash这个脚本会自动检查并安装相关依赖然后拉取OpenClaw核心程序整个过程大概在三五分钟。脚本完成后OpenClaw会被安装到当前用户目录下数据目录一般是~/.openclaw配置文件也在里面。脚本方式的好处是命令少、路径固定适合第一次接触的纯新手。缺点是不太好做版本管理要升级时得重新跑脚本。这里我补充一句如果你的网络环境访问官网安装脚本不稳定可以到项目的GitHub发布页手动下载对应平台的压缩包解压后自己放好路径。服务器上用的通常是Linux x64版本下载对应的二进制包即可。不过截至2026年4月我实测下来官方脚本在国内服务器上执行速度还可以关键是别在Windows那套WSL2环境里绕弯子。3.2 方式二Docker Compose部署我推荐这条路如果让我在2026年4月给一个明确建议我会选Docker部署。原因很简单容器隔离了所有依赖以后升级、备份、迁移都简单而且不会出现“cleanup脚本把系统里某个库误删”这种问题。我用的docker-compose.yml长这样services: openclaw: image: ghcr.io/openclaw-ai/openclaw:latest container_name: openclaw restart: unless-stopped volumes: - ./openclaw_data:/root/.openclaw ports: - 8080:8080 environment: - TZAsia/Shanghai tty: true stdin_open: true这里几个关键说明./openclaw_data挂载到容器内的/root/.openclaw这样所有配置和数据都留在宿主机上容器删了还能恢复tty和stdin_open设为true是因为OpenClaw需要交互式终端来接收命令这一点容易漏不加的话容器进去没有交互感restart: unless-stopped保证重启服务器后自动拉起8080端口是管理面板/API服务默认端口按实际版本调整。启动命令mkdir -p openclaw_data cd openclaw_data wget -O docker-compose.yml https://你的镜像源或手动创建 docker compose up -d docker compose logs -f openclaw如果你不太确定当前项目最新镜像名到GitHub Packages或官方文档页面查一下以当时文档标注的镜像名为准。3.3 初始化配置与管理员绑定安装完成后第一次启动OpenClaw会生成默认配置文件。打开日志或进入容器控制台会看到初始化引导流程包括设置管理员账号生成绑定二维码启动Web管理界面。这里最常见的操作是在浏览器里打开http://服务器IP:8080按引导完成初始化绑定。如果是管理面板生成的二维码直接用手机扫码确认即可。初始化完成后建议立刻改掉默认的管理密码并且把API监听端口改到非默认端口或者干脆只允许本机访问。虽然云服务器自带安全组屏障但多一层保护总是好的。4. 大模型API接入与“大脑模型”切换技巧4.1 选择哪家大模型APIOpenClaw本身没有“智力”它的所有推理和决策都来自配置的大模型API。2026年这个节点国内可选的大模型API很丰富我用过的有DeepSeek官方API响应速度稳定性价比高综合能力在线硅基流动SiliconFlow最大的优势是平台整合了大量开源模型可以很方便地切换不同模型而且有不少免费模型额度适合测试魔塔ModelScope模型生态全适合跟阿里系工具链协作各家云厂商自研的通用模型API。对大多数人来说如果只想稳稳当当地跑OpenClaw我建议优先考虑DeepSeek或硅基流动。前者省心后者灵活。搜索关键词里频繁出现“免费大模型API”这个要注意免费额度通常有速率限制和每日次数上限。OpenClaw在接微信等渠道时消息频次一高就很容易撞上限流。如果你打算长时间稳定运行建议准备一个付费API作为主用免费额度留着测试场景反而更合适。4.2 OpenAI兼容接口统一配置法OpenClaw接入大模型的逻辑我总结下来核心就是三件套接口地址、API Key、模型名。绝大多数国产大模型API都提供OpenAI兼容接口所以配置起来基本是同一个套路。我在配置文件里看到的核心示例以OpenAI兼容模式为例llm: provider: openai-compatible base_url: https://api.deepseek.com/v1 api_key: sk-你的密钥 model: deepseek-chat temperature: 0.7 max_tokens: 4096如果你用的是硅基流动把base_url换成https://api.siliconflow.cn/v1模型名换成你选的模型ID比如deepseek-ai/DeepSeek-V3之类其他不用动。魔塔的话到ModelScope的API文档里找到对应的兼容接口地址即可。这里有一个小坑不同平台的模型ID写法差异很大有的叫deepseek-chat有的是deepseek-ai/DeepSeek-V3这种带命名空间的字符串。配置前到平台的模型列表页把准确的模型ID复制过来千万别手打手打必错。4.3 网关模型与主模型的拆分OpenClaw的配置里其实可以拆成“主对话模型”和“网关模型”两层。主对话模型负责正经推理、处理用户指令网关模型则用来做意图识别、消息路由、关键词过滤这些轻量任务。为什么这样拆因为网关模型面向的是所有消息的预筛如果都用顶级大模型去识别每次消息都消耗大量token成本很快失控。用一个便宜的小模型来做网关只在真正需要复杂推理时才把请求转发给主力模型这样整体成本和延迟都会明显下降。我在京东云这台机器上实际配的是网关模型硅基流动上的轻量模型响应快、价格低主对话模型DeepSeek的通用对话模型质量稳定。启动之后可以明显感觉到日常消息的响应延迟下降了而真正需要写代码、分析问题时回答质量依然在线。如果你也打算这么配需要注意一点网关模型和主模型所在的API账号都要有足够余额否则任何一个限流/欠费都会导致Agent“变笨”。5. 搞定Skill装插件、写自定义技能、避坑指南5.1 Skill目录与安装命令Skill之于OpenClaw就相当于App之于手机。默认安装完OpenClaw它只会最基本的对话能力想要让它搜索网页、处理图片、定时发消息、操作文件就得装对应的Skill。Skill的安装方式基本是命令行操作你可以通过OpenClaw交互窗或直接编辑配置文件触发。官方Skill仓库集中了大量社区贡献的技能包安装命令类似于/skills install search-web /skills install scheduled-tasks /skills install image-tool装完后在Skill列表里就能看到它们执行/skills list可以查看当前已启用的技能。一个需要特别提醒的点Skill只是“代码包”真正运行还需要对应的API Key或环境工具。比如搜索Skill需要配置搜索服务的API凭证图像工具需要调用图像类大模型的API。有些新手装完Skill发现不生效十有八九是没配对应密钥。5.2 我实际用下来比较好的几个Skill按搜索热词里的“openclaw skill推荐”结合我自己2026年4月的实测这几个Skill是我觉得装上立刻有用的Web搜索类Skill让Agent能查实时信息适合做资讯汇总定时任务Skill每天早上定时推送天气、新闻、待办代码执行SkillAgent能直接写并运行Python/Shell脚本运维场景很实用绘图类Skill接上绘图大模型API就能在聊天窗里出图RSS/订阅Skill自动抓取关注的博客和频道更新。我个人的建议是不要一口气装太多。Skill之间可能会抢占上下文窗口装多了反而让Agent的响应变慢、判断变乱。先装两三个核心的跑几天再按需增加。5.3 手写一个最简单的自定义Skill如果你想更进一步完全可以自己写一个Skill。Skill的本质就是一个带描述文件的脚本包你定义一个触发描述告诉OpenClaw“当用户提出这类需求时执行某个脚本”它就会按需调用。我这边写过一个最简示例让Agent读取服务器磁盘剩余空间然后告诉我。Skill目录结构大致是这样disk-check/ SKILL.md script.pySKILL.md里写清楚这个Skill的功能描述和触发条件--- name: disk-check description: 当用户询问磁盘空间或服务器存储时执行此技能。 ---script.py里写具体逻辑import shutil total, used, free shutil.disk_usage(/) print(fTotal: {total // (2**30)}GB, Used: {used // (2**30)}GB, Free: {free // (2**30)}GB)把整个目录放进~/.openclaw/skills/下然后在配置里启用这个Skill。之后你在聊天窗里问“磁盘还剩多少”Agent就会自动跑这个脚本并返回结果。这个例子的意义不在于代码量而在于理解Skill的运行机制它就是一个“描述 脚本”的组合OpenClaw在对话中根据描述自动判断该调用哪个脚本。理解了这一点你就不会再被所谓“Skill开发”吓住了。6. 手机端消息渠道接入与常见报错处理6.1 微信接入iLinkai风控与“会话残留”很多人部署OpenClaw的第一诉求就是接微信。OpenClaw的微信渠道通常会走中间服务协议比如iLinkai这类消息桥接服务。这意味着你的微信消息不是直接发给OpenClaw而是先经过桥接服务转发。这就带来一个大坑iLinkai服务端有自己的风控策略如果你短时间内频繁加好友、频繁发送消息、或者同一会话反复断连重连就可能触发服务端风控出现类似“会话残留”的报错。我实测遇到的情况是重启OpenClaw后微信通道不可用日志里提示旧会话没有正常关闭。处理办法我整理成了一套操作顺序先在OpenClaw管理面板里停用微信通道到iLinkai后台解除设备绑定清空OpenClaw数据目录下的会话缓存文件重启OpenClaw容器重新扫码绑定微信。这套流程我实测有效但核心是别频繁重连。微信通道接入后尽量保持长连接稳定不要一天重启好几次否则很容易再次触发风控。6.2 Windows本地的WSL2校验失败虽然我主推云服务器但不少人是先在本地Windows上试跑碰到的第一个坎就是“OpenClaw could not safely verify the WSL2 environment”。这个报错的原因不复杂OpenClaw的Windows安装脚本需要确认WSL2已正确安装并且版本达标。常见场景包括只装了WSL1没有迁移到WSL2Windows上跑着多个发行版默认版本没有设置成WSL2系统更新后WSL内核版本过旧。解决方式是先检查WSL状态wsl --status wsl --set-default-version 2然后打开“Windows功能”确认“适用于Linux的Windows子系统”和“虚拟机平台”两项都已开启。重启后再跑OpenClaw安装脚本。坦率说就算你把WSL2验通过了Windows本地运行依然要面对电脑休眠、网络不稳定、防火墙拦截等问题。这也是我最终选择京东云的原因之一。如果你只是简单体验本地装一下问题不大如果要稳定用一步到位上云才是正解。6.3 二维码图片与登录态异常还有一个小问题经常有人问OpenClaw绑定手机端时二维码图片去哪找常规路径是在Web管理面板的“渠道绑定”页面系统会生成一张动态二维码。如果你用的是终端版也可能输出一个二维码的ASCII码或者生成一张图片文件存到数据目录下。有几种二维码加载不出来的情况管理面板端口没放行页面打不开二维码图片路径指向本地文件但容器内和宿主机的路径没对应上登录态过期生成的二维码其实已经失效。我的建议是优先在Web管理面板里操作生成二维码后尽快扫码如果提示二维码过期刷新页面重新生成不要拿一个旧二维码反复扫。6.4 其他平台部署补充飞牛、macOS、安卓Termux搜索词里还能看到“飞牛OpenClaw”“mac下安装OpenClaw”“安卓termux原生部署openclaw”。飞牛fnOS作为NAS场景的部署我简单提一句OpenClaw在NAS上用Docker方式跑是最舒服的因为NAS天生就是长期在线设备数据卷挂载到NAS存储还能做快照备份。macOS安装则相对简单官方脚本直接支持只要注意Homebrew环境的依赖冲突就行。安卓Termux原生部署属于进阶玩法不用Proot也能跑但问题在于手机端CPU和内存资源有限适合轻度体验不适合长期接微信。从我这几个平台试下来的稳定程度排序云服务器Docker部署 NAS Docker部署 macOS本地 Windows本地 安卓Termux。最后聊几句我实测后的体会整套折腾下来我最大的感受是OpenClaw本身不难装真正消耗时间的其实是两件小事——选对运行环境、配好API和Skill。如果你一上来就在本地Windows硬啃WSL2那大概率会被环境问题消磨掉热情但你有了一台干净的云服务器之后整个流程变得非常线性装依赖、起容器、配API、装Skill、接微信半小时内搞定主流程。最后再分享一个小习惯不管你是用脚本还是Docker部署都建议在数据目录外定期做一次快照或压缩备份。OpenClaw跑久了以后里面会积累不少自定义Skill配置、会话记录、定时任务这些东西丢了比重新部署一次还肉疼。我就在京东云控制台给服务器挂了个自动快照策略每周一次保留两周成本几乎可以忽略但带来的安全感很足。我已经把个人建议和实践中的弯路放在上面各个章节里了剩下的就是动手试一把。