被问得最多的一个问题就是"龙虾怎么装"。说实话，第一次看到OpenClaw的安装文档时我也觉得有点头大——支持的平台多、部署方式多、配置项也多。但真正动手操作之后发现，整个过程并没有文档看起来那么复杂。关键是你要知道哪些步骤是必须做的，哪些是可选的，哪些是容易踩坑的。这篇文章我就按照"从装到配"的完整流程，把每个环节都掰开揉碎讲清楚。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

先搞清楚你的运行环境

在开始安装之前，先确认你要把OpenClaw装在哪里。这个问题看起来很简单，但很多人的后续问题都是因为一开始环境没选好。

OpenClaw支持三种主要的运行环境：本地电脑（Windows/macOS/Linux桌面版）、云服务器（阿里云、腾讯云、AWS等各种VPS）、以及容器环境（Docker、K8s）。

怎么选？如果你只是想自己玩一玩、体验一下功能，装在本地电脑上就行，最省事。如果你需要24小时运行（比如设置定时任务、接入微信等），就得装在云服务器上。如果你是运维工程师或者DevOps出身，喜欢容器化的工作流，直接上Docker。

下面我分别讲三种环境的安装方法。你可以直接跳到你需要的部分看，不用从头读。

Windows本地安装

Windows环境是最多开发者用的，所以我先讲这个。

前提条件：Windows 10（版本2004及以上）或Windows 11。至少4GB可用内存。至少10GB可用磁盘空间。需要安装Node.js v18以上版本。

Node.js的安装建议用官方的msi安装包，不要用包管理器。安装时勾选"Add to PATH"选项，确保命令行可以直接使用node和npm命令。安装完之后打开PowerShell或者CMD，输入node -v和npm -v确认安装成功。

下载安装包：从部署包页面下载Windows版本的安装包，文件名通常类似openclaw-windows-x64.zip。下载完成后解压到你喜欢的目录，建议用一个路径简短的目录名，比如D:\openclaw。路径中尽量不要有中文和空格，避免后续出现奇怪的问题。

运行安装脚本：打开PowerShell，cd到安装目录，运行安装脚本。安装脚本会自动检查Node.js版本、安装必要的npm依赖、创建默认配置文件、初始化数据目录。

启动服务：安装完成后运行启动脚本。服务启动后，控制台会显示访问地址，通常是http://localhost:3000。打开浏览器访问这个地址，如果能看到登录页面，说明安装成功了。

设置开机自启（可选）：如果你希望OpenClaw开机自动启动，可以用Windows的任务计划程序来实现。创建一个基本任务，触发器选"计算机启动时"，操作选"启动程序"，指向OpenClaw的启动脚本。

Linux服务器安装

Linux是生产环境的标配，安装流程比Windows稍微复杂一点。

前提条件：推荐Ubuntu 22.04 LTS（其他发行版也支持，但文档主要基于Ubuntu编写）。需要root或者sudo权限。SSH访问（如果是远程服务器）。

系统更新：第一步永远是更新系统。运行sudo apt update && sudo apt upgrade -y，确保所有系统包都是最新的。这不是形式主义，很多奇怪的安装问题都是因为系统包太旧导致的。

安装Node.js：推荐通过NodeSource安装。NodeSource提供了针对不同Node.js版本的APT仓库。安装完Node.js之后，顺便安装一些常用的全局工具：pm2（进程管理器，后面会用到）。

创建专用用户（推荐）：不要用root用户跑OpenClaw。创建一个专用的系统用户，比如叫openclaw。给这个用户设置适当的目录权限。这样做的好处是即使OpenClaw出了安全问题，攻击者也只能获得这个受限用户的权限，而不是root权限。

下载和安装：切换到openclaw用户，下载Linux版本的安装包，解压后运行安装脚本。跟Windows版本的流程基本一致，只是命令换成Linux的版本。

用PM2管理进程：在生产环境中，直接用node启动进程不够可靠——进程挂了没人拉起来，重启服务器也不会自动启动。PM2就是解决这个问题的。安装PM2之后，用它来启动OpenClaw进程。PM2会自动监控进程状态，崩溃了自动重启。运行pm2 startup命令可以设置开机自启。

Docker安装

Docker安装是最"干净"的方式——不会在你的系统里乱装东西，卸载也方便。

前提条件：已安装Docker（v20.10以上）和Docker Compose（v2.0以上）。有一定的Docker使用基础。

获取镜像：OpenClaw提供官方Docker镜像。如果你用国内镜像源加速了Docker，拉取速度会很快。直接运行docker pull命令拉取最新版本。

编写docker-compose.yml：这是Docker安装的核心文件。需要配置端口映射、数据卷挂载、环境变量、资源限制等。下面给一个最小可用的配置示例供参考。

端口映射：把容器内部的3000端口映射到宿主机的3000端口。如果你希望用80端口访问，把宿主机端口改成80就行。

数据卷：至少挂载两个目录——配置目录和数据目录。这样即使容器被删除重建，配置和数据也不会丢失。

环境变量：设置时区为Asia/Shanghai。如果你的模型API需要API Key，也可以通过环境变量传入。

资源限制：建议设置内存限制（memory: 2g）和CPU限制（cpus: 2.0），防止单个容器吃掉所有资源。

启动容器：在docker-compose.yml所在目录运行docker compose up -d。容器会在后台启动。用docker ps确认容器运行状态，用docker logs查看日志。

安装后的必要配置

不管你用哪种安装方式，装好之后有几项配置是必须做的。

管理员账号：首次访问Web界面时，系统会要求你设置管理员账号和密码。密码务必设置得强一些，16位以上包含各种字符。这个账号拥有最高权限，一旦泄露后果严重。

模型API配置：没有模型API，OpenClaw就是一个空壳。在管理面板的"模型配置"中，添加至少一个模型提供商。你需要提供API端点地址和API Key。建议配置至少两个模型——一个主力模型和一个备用模型。当主力模型不可用的时候，系统会自动切换到备用模型。

基本网络配置：如果服务器有防火墙，确保OpenClaw的端口（默认3000）对外开放。如果你用Nginx做了反向代理，确保WebSocket的upgrade请求能正确转发。WebSocket对于Web聊天功能是必需的，如果配置不正确，Web界面能打开但聊天功能会报错。

安装失败的排查方法

安装过程中如果出了问题，按以下顺序排查：

看日志。这是最重要的排查手段。OpenClaw的日志文件在数据目录下的logs子目录中，打开最新的日志文件查看错误信息。如果日志文件太大不好看，可以用tail -n 100命令看最后100行。

检查Node.js版本。很多问题是Node.js版本不兼容导致的。确保你用的是v18以上的版本。用node -v确认。

检查端口占用。如果启动时报"端口已被占用"的错误，用netstat -tlnp（Linux）或者netstat -ano（Windows）查看是哪个进程占用了端口。可以修改OpenClaw的配置改用其他端口，也可以关掉占用端口的进程。

检查权限。Linux环境下注意文件和目录的权限。OpenClaw需要对配置目录和数据目录有读写权限。如果用了专用用户，确保chown设置正确。

实在搞不定的话，可以去CSDN或者OpenClaw的中文社群提问。提问时把日志里的错误信息贴出来，比单纯描述"装不上"有效得多。

安装是所有后续使用的基础，花点时间把它搞对是值得的。希望这篇文章能帮你顺利完成OpenClaw的安装，少走弯路。