OpenClaw 第四篇：安装与初始化 —— 本地+云端双路线，5分钟跑起来

上一篇我们完成了环境准备，Node.js、Git、依赖都已配置到位。这一篇就是真正让 OpenClaw 跑起来的完整步骤：从下载、安装、配置、第一次启动，到验证运行成功。其他模型如 Gemini、Claude 也可以在这里配置，OpenClaw 支持自动切换。全程复制粘贴即可完成，Windows / macOS / Linux 通用，新手零失败。OpenClaw 第四篇：安装与初始化 —— 本地+

LAI.wolves

712人浏览 · 2026-03-09 09:35:21

LAI.wolves · 2026-03-09 09:35:21 发布

OpenClaw 第四篇：安装与初始化 —— 本地 + 云端双路线，5 分钟跑起来

上一篇我们完成了环境准备，Node.js、Git、依赖都已配置到位。这一篇就是真正让 OpenClaw 跑起来的完整步骤：从下载、安装、配置、第一次启动，到验证运行成功。

全程复制粘贴即可完成，Windows /macOS/ Linux 通用，新手零失败。

一、开始前确认（3 秒自查）

确保你已经完成：

Node.js 18+ 安装成功
npm 可用
拥有一个可用的 大模型 API Key（OpenAI / Gemini / Claude 都行）
文件夹路径不含中文、空格、特殊符号

满足以上四点，直接往下走。

二、方式一：本地安装（最推荐・极速版）

1. 拉取代码

打开终端，进入你想放 OpenClaw 的文件夹，执行：

plaintext

git clone https://github.com/openclaw/openclaw.git
cd openclaw

2. 安装依赖

plaintext

npm install

等待 1～2 分钟，出现成功提示即完成。

3. 复制配置文件

把示例配置复制成正式配置：

plaintext

# Windows
copy .env.example .env

# macOS / Linux
cp .env.example .env

4. 填写 API Key

用记事本 / VS Code 打开 .env 文件，找到：

plaintext

OPENAI_API_KEY=你的API Key

把你的密钥粘贴进去即可。

其他模型如 Gemini、Claude 也可以在这里配置，OpenClaw 支持自动切换。

5. 启动！

plaintext

npm start

看到以下类似提示，就是启动成功：

plaintext

OpenClaw is running on http://localhost:3000
Agent 已就绪，可以开始执行任务

6. 验证是否正常运行

浏览器打开：

plaintext

http://localhost:3000

能看到控制台 → 安装完成！

三、方式二：云端一键部署（不想装环境选这个）

如果你不想在本地装任何东西，可以直接云端跑：

支持平台

Vercel
Render
Railway
Docker 一键部署

云端通用命令（Docker）

plaintext

docker pull openclaw/openclaw
docker run -d -p 3000:3000 --env-file .env openclaw/openclaw

同样把 .env 配置好，直接运行即可。

云端部署优势：

不占本地资源
24 小时运行
可在外网用手机控制

四、初始化：第一次使用必须知道的 3 件事

1. 工作目录

OpenClaw 默认会在项目内创建：

memory/ 记忆文件
logs/ 操作日志
tasks/ 任务缓存

所有数据都在本地，不上传云端，隐私安全。

2. 权限初始化

第一次启动会自动：

开启沙箱保护
创建默认安全规则
限制危险命令（rm -rf、格式化磁盘等）

你不需要手动设置，开箱即用。

3. 通道初始化（可选但超好用）

你可以在 .env 里配置：

Telegram
Discord
飞书 / 钉钉
Web 页面

配置后，手机就能远程指挥电脑。

五、最常见的 5 个坑（看完避免 99% 问题）

路径含中文 → 启动失败解决：全部改成英文路径。
API Key 错误 / 余额不足解决：去平台检查密钥与额度。
端口 3000 被占用解决：在 .env 里改 PORT=3001。
npm install 失败解决：切换淘宝镜像：

plaintext
```
npm config set registry https://registry.npmmirror.com
```
启动后马上闪退解决：用管理员 /root 权限重新运行。