title: OpenClaw部署保姆级教程，本地和云端一文搞定
OpenClaw部署保姆级教程，本地和云端一文搞定
上周帮一个做产品的朋友装OpenClaw，从下午两点搞到晚上八点，中间遇到各种奇葩问题。装完之后我就想，应该写一篇真正面向新手的部署教程，把所有坑都标出来，让后面的人少走弯路。
这篇文章会覆盖本地部署和云端部署两种方式，不管你是Mac、Linux还是Windows用户，跟着做就行。
先搞清楚：四种部署方式怎么选
目前OpenClaw的部署方式主要有四种，各有优缺点：
一键脚本安装。 官方提供的安装脚本，一行命令搞定。优点是简单快速，缺点是出了问题不好排查，因为你不知道脚本背后干了什么。适合想快速体验的用户。
npm手动安装。 用Node.js的包管理器安装，过程透明可控。需要你先装好Node.js环境，适合有一点开发基础的用户。
源码编译。 从GitHub拉代码自己编译，适合想魔改或者参与开发的人。普通用户不推荐这种方式，太折腾了。
云平台一键部署。 一些云平台提供了OpenClaw的镜像模板，点几下就能部署好。适合想在云端跑、不想折腾本地环境的用户。
我个人建议新手先用npm手动安装，过程不复杂，但你能清楚知道每一步在干什么，出了问题也好定位。
本地部署详细步骤
Mac用户
Mac上部署是最省心的。先确保你有Node.js 18以上的版本：
node -v
如果版本太低或者没装，推荐用nvm来管理Node版本，灵活方便。装好Node之后，直接npm全局安装OpenClaw就行了。
装完验证一下版本号，能正常输出就说明OK了。
Linux用户
Linux跟Mac差不多，主要区别是有些发行版的Node.js版本比较老，需要自己加源或者用nvm。
另外注意一点，如果你用的是精简版的Linux（比如Docker基础镜像），可能缺少一些编译工具，需要先装build-essential这些依赖。
Windows用户
Windows稍微麻烦一点。首先推荐用WSL2，在Linux子系统里装，体验跟原生Linux一样。
如果不想用WSL，直接在Windows上装也行，但要注意几个问题：路径不要有中文，PowerShell的执行策略可能需要调整，Node.js建议用官网的安装包而不是Chocolatey。
我那个朋友就是因为用户名是中文，路径里有中文字符，折腾了两个小时才定位到这个问题。
云端部署推荐
如果你不想占用本地资源，或者需要7x24小时运行，云端部署是更好的选择。
轻量服务器方案。 阿里云或腾讯云的轻量应用服务器，2核2G的配置就够跑OpenClaw了，一个月大概40-60块。选Ubuntu 22.04的系统镜像，然后按Linux的步骤装就行。
Docker部署。 如果服务器上有Docker环境，直接拉官方镜像运行是最快的方式，也不用操心依赖问题。
云平台模板。 部分云平台已经提供了OpenClaw的应用模板，填几个参数就能一键部署，适合完全不想碰命令行的用户。
配置要点
装好之后，还有几个关键配置需要搞定：
模型选择。 OpenClaw支持接入多种模型，你至少需要配置一个模型的API Key才能用。新手推荐先接DeepSeek或通义千问，注册简单、价格便宜。
Gateway设置。 OpenClaw的Gateway组件负责管理API请求的路由和负载均衡。如果你只用一个模型，默认配置就行。如果需要多模型切换，需要在Gateway配置里添加多个Provider。
飞书/钉钉对接。 很多团队用户希望把OpenClaw接入飞书或钉钉机器人。这个配置稍微复杂一点，需要在飞书/钉钉的开放平台创建应用，拿到webhook地址，然后在OpenClaw里配置对接。官方文档里有详细教程，跟着做就行。
部署后的第一件事
很多人装完OpenClaw之后就直接开始用了，但我建议你先做一件事：安装几个实用的Skill测试一下。
Skill是OpenClaw的核心玩法，可以理解为模型的"技能插件"。你可以先装一些官方推荐的Skill，比如代码助手、文档总结、翻译助手这些，验证一下整个链路是否正常。
如果Skill能正常运行，说明你的OpenClaw已经完全部署好了，可以放心使用了。
常见部署问题
端口被占用。 OpenClaw默认用的端口可能跟你本地其他服务冲突，改一下端口配置就行。
npm安装速度慢。 国内用户建议切换到淘宝npm镜像源，速度能快很多。
权限问题。 Linux和Mac上如果用sudo安装，后续可能会遇到权限问题。建议用nvm装Node，避免全局安装需要sudo。
内存不足。 如果你的服务器只有1G内存，OpenClaw本身能跑起来，但加上系统开销可能会比较紧张。建议至少2G内存。
写在最后
部署这件事，看着步骤多，实际上熟练了也就10分钟的事。关键是不要怕折腾，遇到报错先看错误信息，大部分问题搜一下就能解决。
你们部署的时候遇到过什么奇葩问题？有没有什么独特的部署方案想分享的？评论区交流一下，说不定你踩过的坑正好能帮到别人。