装上 OpenClaw

多种安装方式任选，极速启用。OpenClaw 稳定版

⚙️

系统要求

Memory

Node.js 20 或更高版本（推荐 21）

最低 4GB 内存，推荐 8GB+

OS

Windows 10+, macOS 12+, Linux

(Ubuntu 20.04+, Debian 11+)

RAM

至少 2GB 内存，推荐 4GB+

Disk

安装目录至少预留 1GB 磁盘空间

GPU

可选，支持 CUDA (NVIDIA) 或 Metal (Apple)

Network

需联网以拉取依赖、模型及配置

📥

多种方式安装

iwr -useb https://openclaw.ai/install.ps1 | iex

适用于 Windows 10/11，PowerShell 5.1+ 环境

curl -sSL https://openclaw.ai/install.sh | bash

适用于 macOS 12+、Ubuntu、Debian、Fedora 等

docker run -d --name openclaw -p 3000:3000 openclawai/openclaw:latest

需提前安装 Docker Engine，支持所有系统

# 克隆仓库
git clone https://github.com/openclaw-ai/openclaw.git
# 进入目录
cd openclaw
# 安装依赖
npm install
# 启动服务
npm start

适用于自定义部署、二次开发场景

复制以上命令，在终端执行即可，大多数人就这一步。

✅

验证安装

openclaw --version

应输出已安装的版本号（如 v2026.3.7）。

openclaw doctor

对环境做健康检查，包含 Node、依赖、配置文件和网络连通性。

openclaw whoami

交互式配置检查，将自动配置 API Key 及聊天平台初始配置。

🔧

初始配置

安装完成后，openclaw 命令将引导你完成配置，每一步的作用如下：

1. 选择 AI 模型

支持 OpenAI (GPT)、Anthropic (Claude)、Google (Gemini) 或本地模型，随时可以在配置中切换。

2. 配置 API Key

从对应 AI 服务商获取 API Key，存在本地 .env 文件中—除了你自己，不会有任何第三方获取。

3. 选择聊天平台

支持微信、飞书、Telegram、Discord 或 Bot Server 本地交互。

4. 完成激活

通过已配置的聊天平台给 OpenClaw 发送消息，就能收到回复了。就是这么简单，试试和它聊什么！

提示：所有配置文件存放在 ~/.openclaw/config.json，你也可以直接编辑该文件来修改配置，如 API Key 更换、模型切换等。

⬆️

升级 OpenClaw

保持 OpenClaw 最新版本，获取最新功能、修复完全补丁。

npm

npm update -g openclaw@latest

yarn

yarn global upgrade openclaw@latest

Git

cd openclaw && git pull && npm install
npm run build && npm link

Docker

docker pull openclawai/openclaw:latest
docker restart openclaw

查看更多历史版本 →

🔍

故障排查

常见故障及解决方法，快速定位问题。

安装时权限不足 +

Windows：以「管理员身份」运行 PowerShell；macOS/Linux：在命令前添加 sudo，如 sudo curl -sSL https://openclaw.ai/install.sh | bash。

Node.js 版本不兼容 +

使用 nvm 管理 Node 版本：nvm install 21 && nvm use 21，安装完成后重新执行安装命令。

端口已被占用 (3000/8080) +

修改配置文件 ~/.openclaw/config.json 中的 port 字段，或停止占用端口的进程后重启 OpenClaw。

API Key 配置后无响应 +

1. 检查 API Key 是否有效；2. 确认网络可访问对应 AI 服务商；3. 执行 openclaw doctor 检查网络连通性。

Docker 启动后无法访问 +

检查容器日志：docker logs openclaw；确认端口映射正确，本地防火墙未拦截 3000 端口。

Windows 上 WSL2 相关问题 +

确保 WSL2 已启用并安装 Linux 发行版，执行 wsl --status 检查状态，问题未解决可参考微软官方 WSL2 安装文档。