干这行越久越有体会一个新工具最折腾人的往往不是工具本身而是刚开始那几步“装不上、跑不起来、不知道去哪看报错”。OpenClaw这段时间热度很高很多人本地用整合包跑通了一放到云服务器就卡住——不是缺依赖就是安全组没放行要么就是装完根本不知道接下来该配置什么。这篇文章就专门写给想把OpenClaw部署到阿里云上的朋友目标很明确从选服务器到跑起来新手也能在五分钟内完成并且装完之后知道怎么配置大模型、挂技能、接微信、升版本遇到问题也知道去哪排查。先说清楚一个基本认知OpenClaw不是一个网页应用部署它不等于上传文件然后访问一个网址。它是一个长期运行在后台的AI代理进程你需要给它配一个大模型作为“大脑”再装一些技能插件作为“手脚”它才能帮你干活。所以部署只是开始真正让OpenClaw有用的是后面的配置。这篇文章会把整个链路串起来讲不跳步不藏坑。1. 部署前先搞清楚OpenClaw是什么为什么选阿里云1.1 OpenClaw不是单一程序而是一套代理编排框架很多第一次接触OpenClaw的人会把它理解成一个聊天机器人装上就能和AI对话。实际上准确的说法是OpenClaw是一个开源的AI代理运行框架核心作用是让AI能根据任务调用各种技能比如读网页、操作浏览器、管理文件、执行脚本甚至以“计算机操作员”的方式操作桌面系统。它的架构可以拆成四个部分核心调度进程负责接收指令、拆解任务、编排技能执行顺序渠道接入层负责连接各种入口常见的有Web控制台、命令行、微信插件技能层是若干独立安装的skill每个skill完成一类具体操作模型网关则负责和底层大模型交互OpenClaw本身不生产模型能力它更像是一个指挥系统把大模型的“想法”翻译成具体动作。这也是为什么部署前要先把“大模型API密钥”准备好。没有模型接入OpenClaw装得再顺利也只是一个空壳进程你跟它说话它没法回答更别提执行任务了。1.2 为什么把OpenClaw部署到云端而不是留在自己电脑上如果你只在本地电脑上玩那部署在Windows或者Mac上都行热词里那个“windows离线整合包”就是这么来的。但如果你想让它作为个人助理长期在线、定时处理任务、通过微信随时调用那本地电脑有几个很难绕过去的问题电脑会休眠Wi-Fi会断IP会变家人一重启路由器可能整个服务就失联了。放到阿里云ECS上这些问题基本不存在。ECS是7x24小时运行的只要不手动关机服务就是一直在线状态。它有固定的公网IP微信插件或Web控制台回连的时候地址稳定。另外国内服务器访问阿里云百炼、通义千问这些大模型API时延迟很低因为模型服务和服务器在同一片网络内比你在家跨省访问要稳得多。还有人问用轻量应用服务器行不行。可以轻量服务器其实更适合新手价格便宜控制台操作直观部署OpenClaw完全够用。这篇教程里说的“阿里云”ECS和轻量应用服务器两种都适用只是入口位置和控制台按钮有点区别核心的Linux命令完全一样。2. 阿里云ECS的选型陷阱配置、镜像、安全组一次性配齐2.1 新手最容易纠结的配置问题2核2G到底够不够选配置是新手问得最多的。我的结论很直接OpenClaw最低建议2核4G带宽3M以上系统盘40G起步。网上有些教程说2核2G也能跑理论上确实能启动但一旦你装上Computer Use这类重技能或者同时挂上微信插件做长时间会话内存很容易冲到90%以上然后整个进程被系统OOM Kill干掉表现就是“服务莫名其妙消失了”。如果你打算长期使用我建议一步到位选2核8G或者4核8G。阿里云的控制台里选“按量付费”或者包年包月都行新手第一次买可以先按量付费跑几天确认运行稳定再转包年包月这样能省一笔不必要的支出。阿里云经常有新人优惠活动2C4G的实例价格通常在几十块一个月这个成本换取一个7x24小时在线的AI助理性价比是很高的。下面是当前比较稳妥的配置参考使用场景实例规格内存带宽系统盘说明个人轻量使用2vCPU4GiB3Mbps40GiB ESSD基础对话、简单skill、低频微信接入长期挂机多技能2vCPU8GiB5Mbps60GiB ESSDWeb/Computer Use/多用户同时使用重度使用/团队共享4vCPU8GiB10Mbps80GiB ESSD多个渠道并发、大量技能并行执行2.2 系统镜像选什么安全组如何放行镜像方面选Ubuntu 22.04 LTS或24.04 LTS都可以这两个版本都是长期支持版本软件源丰富遇到问题网上也容易搜到答案。不建议新手上来就选Alibaba Cloud Linux虽然兼容性不错但社区资料相对少遇到问题排查成本高。更不建议选Windows Server因为OpenClaw相关的安装脚本、Docker镜像、文档示例基本都是围绕Linux写的你用Windows系统等于给自己增加难度。安全组是阿里云自带的一层云防火墙很多人安装失败就是栽在它上面。你在控制台买了一台ECS之后默认安全组通常只开放了22端口SSH登录用。如果你需要通过Web方式访问OpenClaw的控制台需要手动添加入方向规则放行对应的端口比如3000或8080。注意一个容易混淆的点安全组放行和服务器内部防火墙是两回事。阿里云的公网访问控制首先看安全组如果安全组没放行服务器内部即使开着端口也进不来。而Linux服务器内部如果启用了ufw或firewalld也需要单独放行端口。我的建议是服务器内部就不要额外开防火墙了统一用阿里云安全组来控这样管理链路简洁不容易出现“两边规则打架”的情况。2.3 登录后第一时间要做的基础加固拿到服务器后不要急着装东西先花两分钟做基础加固。第一件事是用密码登录后立刻换成密钥对登录如果购买时已经选了密钥对就确认SSH登录不需要密码。第二件事是创建一个普通用户比如叫deploy以后所有操作都在这个用户下进行不要直接使用root。OpenClaw官方安装脚本通常也不建议在root下直接跑因为不少安装步骤会创建配置目录和用户权限root环境容易把目录权限搞混乱。# 创建普通用户并加入sudo组 sudo useradd -m -s /bin/bash deploy sudo usermod -aG sudo deploy sudo passwd deploy登录服务器用普通用户后后续的安装都简洁很多。如果你觉得每次sudo输密码麻烦可以把SSH密钥拷贝到普通用户下实现免密登录。这一步不属于OpenClaw的必需步骤但长期运维体验会舒服很多。3. 三分钟快速安装脚本安装与Git源码分支构建双路线3.1 官方脚本安装适合赶时间的人OpenClaw提供了一键安装脚本这是新手最推荐的方式。你登录服务器之后先把系统包索引更新一下然后安装几个基础工具再执行官方安装脚本即可。官方脚本会自动检测系统环境、下载对应平台的二进制包、创建配置目录、写入系统服务文件。整个流程大概是下面这样sudo apt update sudo apt upgrade -y sudo apt install -y git curl vim然后打开OpenClaw官方文档或GitHub仓库的Release页面复制上面提供的安装命令。不同版本的安装脚本地址不一样不要从第三方博客里复制命令尽量以官方文档为准。安装脚本执行完之后一般的预期结果是输出OpenClaw的版本号并且提示你配置文件生成的位置。安装完成后最好立刻跑一下自检命令。OpenClaw带了类似“体检”的功能能检查Node环境、配置目录权限、依赖完整性等常见问题。这一步能让你在正式配置之前就发现环境问题而不是等启动失败后回头猜原因。不同版本的自检命令名可能略有差异常见的是openclaw doctor如果提示一切正常那说明核心安装已经成了接下来只需要配置模型和对齐技能。3.2 用--git方式从main分支拉源码构建拿到最新特性脚本安装默认用的是release版本优点是经过测试、稳定缺点是版本可能不是最新的。如果你看到社区里讨论某个刚合并的新功能但自己的OpenClaw还没有那就需要用Git源码方式安装。OpenClaw的安装脚本支持指定Git安装方式会从GitHub仓库的main分支拉取源码然后本地构建可执行文件。这种方式能拿到最新开发成果但可能有未充分测试的问题生产环境慎用。命令格式大致是在安装脚本后加参数curl -fsSL 官方安装脚本地址 | bash -s -- --git --branch main从main分支拉取源码后构建过程会读package.json、下载依赖、编译核心模块。这里最容易出现的坑有两个一是网络问题导致Git拉取超时国内服务器直连GitHub有时候很慢如果拉取失败可以尝试用镜像仓库地址或者把GitHub仓库手动打包上传到服务器上再解压二是Node版本太低导致依赖安装失败OpenClaw通常要求Node 20以上版本建议提前用nvm装一个最新的LTS版本。安装完成后进入OpenClaw的源码目录你会看到bin目录下的启动入口和配置目录。以后想升级时只需要在源码目录执行git pull再重新跑一次构建命令就行不需要重新下载全部内容。3.3 安装完成后的初始化与验证不管是脚本安装还是Git源码编译安装完都要初始化。找到配置文件目录执行初始化操作让它生成一份默认配置。不同版本会生成不同格式的配置文件但核心内容大致相同模型提供方、模型名称、API密钥、渠道开关、技能列表等。启动服务前先验证两件事版本号能正常输出、配置目录里出现了模型和技能相关的默认文件。然后前台启动OpenClaw观察日志第一次启动不要直接后台化因为你还需要确认日志里没有明显报错。如果一切正常你会看到类似“服务已启动监听端口XXXX”的日志输出。此时再关掉前台进程改用systemd或者Docker方式做常驻运行。初始化这一步不建议跳过。很多人安装成功后就急着配模型结果配置文件的格式写错了导致服务反复重启最后绕了一圈才发现是配置目录权限的问题。正确顺序应该是安装 - 自检 - 初始化 - 前台启动看日志 - 配置模型 - 正式后台运行。4. 不想污染系统就用DockerCompose编排与守护进程管理4.1 为什么推荐Docker部署而不是裸机脚本安装是最快的方式但从长期运维角度看我更推荐用Docker Compose方式部署OpenClaw。原因有三个一是环境隔离OpenClaw依赖Node、Git、各种编译工具和技能运行时如果装在系统里升级系统或安装其他软件时很可能互相影响Docker把这些依赖全部打包在镜像里和宿主机完全隔离二是升级回滚方便脚本安装升级失败后想回滚很麻烦Docker只需要换镜像tag一条命令就能回到旧版本三是备份迁移非常轻松OpenClaw的数据基本都在配置目录和日志目录里把这两个目录挂载成数据卷之后无论迁移到哪台服务器只要把目录带走容器启动就能恢复原样。缺点也有主要是Docker本身多占一点系统资源大约200到400M内存但对于2C4G的服务器来说完全能接受。4.2 docker-compose.yml关键配置与数据持久化用Docker部署前先确保服务器上装好了Docker和Compose插件。装好之后在用户目录下建一个openclaw目录里面放docker-compose.yml文件。配置的核心思路是容器可销毁数据不丢失。services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - 3000:3000 volumes: - ./config:/home/openclaw/.openclaw - ./logs:/home/openclaw/logs - ./skills:/home/openclaw/skills environment: - TZAsia/Shanghai extra_hosts: - host.docker.internal:host-gateway注意几个关键点。restart: unless-stopped表示容器异常退出后会自动重启这是长期挂机的最重要保障。数据卷挂载把配置、日志、技能三个目录映射到宿主机以后即使删掉容器重建配置和技能都还在。TZ设置成Asia/Shanghai能避免日志时间戳和本地时间差八小时的问题。镜像名以官方仓库实际镜像名为准发布新版本后把latest换成具体版本号即可锁定版本。启动命令固定为cd ~/openclaw docker compose pull docker compose up -d服务启动后通过docker compose ps查看状态通过docker compose logs -f --tail200 openclaw实时查看日志。这一套命令比裸机的systemctl更直观尤其是查看日志的时候不需要去翻文件路径直接一条命令就能看到最近的输出。4.3 升级镜像与容器迁移的注意事项Docker方式升级非常简单先拉取新镜像再重新创建容器旧容器会自动销毁。执行之前建议先把配置目录做一个压缩备份tar czf openclaw-backup-$(date %Y%m%d).tar.gz ~/openclaw/config ~/openclaw/skills然后执行docker compose pull docker compose up -d这里面有一个需要小心的点如果升级跨度较大新版本可能对配置文件结构做了调整。有的版本升级后会自动迁移配置有的不会导致启动后一直报配置解析错误。遇到这种情况先别急着回滚可以看看日志里有没有提示迁移命令比如openclaw migrate之类执行后再重启。如果在生产环境使用建议先在本地电脑或者另一台测试机上跑一遍升级流程确认无误再对正式服务操作。5. 接通大模型和技能体系阿里云百炼、Skills与微信插件衔接5.1 配置阿里云百炼通义千问作为推理后端OpenClaw本身不带模型它通过模型网关调用外部大模型。国内用户最方便的选择是阿里云百炼平台因为它在国内访问速度快开通流程简单还有免费额度可以试用。在百炼控制台创建一个API Key然后在OpenClaw配置文件的模型部分填入对应的参数。下面是一份典型配置{ llm: { provider: dashscope, baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1, apiKey: sk-xxxxxxxxxxxxxxxx, model: qwen-plus } }其中model这一栏可以根据你的需求换日常对话用qwen-plus性价比高复杂推理任务用qwen-max效果更好编码类任务可以考虑qwen-coder系列。如果你同时有OpenAI的Key也可以把provider换成openai并填入对应的baseUrl和apiKeyOpenClaw支持多模型源。配置完成后先跑几个简单对话发现回复延迟大或者超时就换模型不要指望一个模型通吃所有场景。阿里云百炼的接口兼容OpenAI协议所以baseUrl填的是兼容模式的地址不是百炼控制台首页地址。不少人在这里填错过导致一直报401或者404。仔细看文档里的baseUrl是compatible-mode不是dashscope.aliyuncs.com/api。5.2 技能skill安装与Computer Use等工具的权限边界OpenClaw的技能体系类似于手机里的App核心进程只负责调度具体做事的是各个skill。技能安装命令一般是openclaw skill install skill名称热词里常被问到的cau computer其实就是Computer Use技能作用是让AI以图形界面的方式操作电脑模拟鼠标键盘行为完成“帮你在网页上填表”“自动操作某个软件”这类任务。这个技能的安装比较简单但要真正在服务器上跑起来需要额外配置虚拟显示环境。先解释一下原因OpenClaw跑在ECS上服务器默认没有物理显示器。Computer Use技能要“看屏幕”就需要用虚拟显示工具在服务器上创建一个虚拟屏幕让AI有东西可以“看”。一种常见做法是安装Xvfb虚拟显示服务器然后设置DISPLAY环境变量指向这个虚拟屏幕。但这属于进阶玩法对内存占用不小如果只是日常使用OpenClaw处理文本类任务不建议在一开始就装Computer Use。使用Computer Use技能时一定要划清权限边界。AI操作计算机和真人操作一样存在误操作的可能比如不小心删掉文件、点掉正在运行的服务。建议在配置里把AI可操作的路径限制在指定目录比如只允许读写workspace目录不允许执行sudo命令遇到危险操作要求人工确认。如果OpenClaw配置里没有单独的权限选项那就通过系统用户权限来控制让OpenClaw进程只运行在一个受限用户下访问不了系统关键目录。5.3 微信插件连接方法、会话残留与频率控制很多用户部署OpenClaw就是为了接微信让自己的微信号变成个人AI助理。微信插件的配置思路是把OpenClaw接入微信的收发消息通道让AI在后台接收消息处理后把回复发回对应会话。接入方式一般有两种一种是运行微信客户端程序并点击授权登录OpenClaw通过第三方库读取消息另一种是使用Webhook方式把消息转发接口和服务端对接。前者更像“自动操作”后者更可控但对于普通用户来说前者更常见。微信插件的坑主要集中在一个地方长时间运行后出现“会话残留”表现为AI明明看到了新消息却一直回复上一段对话内容或者消息发出去后长时间没有反应。这通常是因为服务端的会话上下文没有及时清理旧会话占用上下文窗口导致新消息排不上队。处理思路是先看OpenClaw日志找到有没有明确的错误码提示然后尝试重启插件服务这是最快的方式如果重启后正常那基本可以判断是会话残留接着考虑清理会话缓存目录或者调整会话超时时间让没有活跃的会话自动释放。另外需要注意自动操作微信本身就处在平台的规则边缘别用这个功能发广告、搞群发频率也不宜过高。建议先用小号测试稳定后再考虑主力微信号避免影响正常使用。6. 版本升级与常见故障排查从拉流到日志的一整条链路6.1 升级前先备份升级后先验证升级OpenClaw版本这件事本身不难难的是升级完发现配置不兼容又来不及排查。所以我的习惯是升级前固定做一个备份动作不光是配置目录技能目录也要一起备份因为技能和版本之间有时存在兼容问题。备份命令前面已经给过就是压缩config和skills两个目录。升级后用三条命令验证是否正常版本号输出、健康检查、看启动日志。如果日志里出现配置字段找不到之类的提示优先查找新版本是否提供了自动迁移命令。如果迁移后仍然异常不要在一个错误上纠结太久直接把备份恢复回去先保证服务可用再研究新版本的问题。个人项目稳定运行比追新功能重要得多。6.2 常见故障端口冲突、模型接入失败、会话残留端口冲突是新手很常见的故障。OpenClaw默认会在某个端口起Web控制台但这个端口可能被其他服务占用了。排查命令很简单sudo ss -lntp | grep 端口号看到LISTEN状态的进程如果没有显示出来说明端口被占。找到罪魁祸首后要么停掉旧进程要么修改OpenClaw配置换一个端口。换端口之后记得同步修改阿里云安全组的放行规则否则外部访问仍然不通。模型接入失败是最让人头疼的因为它会伪装成各种奇怪的现象。如果你发现OpenClaw启动正常但一对话就报错优先检查三样东西API Key是否有效、baseUrl是否填的是兼容模式地址、模型名称是否为百炼平台支持的名字。这三样看起来基础但80%的模型接入问题都出在这里。再有一个容易忽略的点是服务器的系统时间如果系统时间和真实时间差太多调用HTTPS接口时证书验证会失败表现为“连接被重置”或者“证书过期”。装完系统后顺手配置好NTP时间同步很多奇怪问题都会消失。会话残留问题在微信插件部分已经提到了它在Web控制台也可能出现症状更隐蔽浏览器里打开控制台页面正常加载但发送消息后一直没有响应。这时候先看后台日志有没有新增记录如果没有记录说明消息根本没到核心进程问题可能出在浏览器与服务之间的WebSocket连接刷新页面或者清除浏览器缓存通常能解决。6.3 资源占用与性能调优OpenClaw长期运行后内存占用会缓慢上涨这是正常的。如果内存涨到一定程度后开始频繁使用Swap整个服务会变得很卡。有几个缓解手段值得一试给服务器额外配置1到2G的Swap空间作为兜底设置一个每日凌晨的定时任务让OpenClaw低峰期自动重启一次释放长期积累的内存碎片技能不要装太多用不到的skill先停用因为每个skill都会在启动时加载自己的运行时环境。还有一点是关于日志体积的。OpenClaw的日志在长时间运行后可能长到几十G把磁盘塞满然后服务就再也起不来了。建议在日志目录配置一个简单的日志轮转保留最近7天的日志超过自动清理。Docker部署的话可以用Docker自带的log rotation在docker-compose.yml里的服务级别加一段日志配置控制单文件大小和保留份数这块撑死几百M比裸机部署更省心。另外关于阿里云时间服务器顺手提一句如果发现日志时间对不上在/etc/systemd/timesyncd.conf里配置阿里云的内网NTP服务地址然后重启时间同步服务。这个细节看起来不起眼但在排查证书错误、消息延迟问题时能帮你排除一大类隐患。OpenClaw真正常态化运行之后你会发现它更像一个“需要长期陪伴的服务”而不是一次性安装的软件。我自己的习惯是配置目录和技能目录每周打包一次到OSS存储升级前必看更新日志升级后先跑几个测试对话再放正式流量。这套习惯帮我避开了好几次半夜处理故障的情况。希望这篇教程能让你少走一些弯路。如果你也准备开始部署我的建议是不要一上来就追求装完全部技能先把最基础的大模型对话跑通再逐步加技能、加渠道。基础链路稳了后面加什么都不会太慌。