OpenClaw 安装指南：从零搭建你的 AI 智能体
OpenClaw 是 2026 年现象级开源本地 AI 智能体（AI Agent）框架，主打 AI 不止聊天、可以直接操控电脑自动执行任务，网友因其红色龙虾图标俗称"小龙虾"。本文将带你从零开始，在全平台上完成安装和配置。
一、什么是 OpenClaw
OpenClaw 是一个自主智能体框架，具备感知、规划、执行、反馈四层闭环能力，区别于传统 AI 的单向输入输出模式。它支持本地部署，数据隐私可控，可接入 Ollama 等本地大模型，同时拥有丰富的生态扩展能力。
二、系统要求
- Node.js：>= 22.0，推荐 Node 24
- 包管理器：pnpm / npm，强烈推荐 pnpm
- Git：任意版本
- 操作系统：macOS / Linux / Windows（Windows 推荐使用 WSL2）
三、安装方法
提供三种安装方式，根据你的需求选择最适合的方案。
3.1 一键安装脚本（推荐新手）
最简单的安装方式，官方脚本自动完成环境检测、依赖安装和项目构建，全程约 5 分钟。
macOS / Linux / WSL2
终端中运行：
curl -fsSL https://openclaw.ai/install.sh | bash国内用户推荐使用中国社区版镜像，下载速度更快：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bashWindows
以管理员身份运行 PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex注意：Windows 原生环境需要先手动安装 Git，推荐使用 WSL2 获得更好的兼容性。
3.2 从源码安装（开发者推荐）
适合需要定制开发、参与贡献或需要最新功能的开发者。
步骤 0：安装 pnpm（如未安装）
npm install -g pnpm步骤 1：克隆代码仓库
# 官方原版
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 国内镜像（推荐）
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn步骤 2：配置国内加速（关键！）
pnpm config set registry https://registry.npmmirror.com/国内用户务必执行此步骤，否则依赖下载会非常慢甚至失败。
步骤 3：安装依赖与构建
# 安装依赖
pnpm install
# 构建前端界面
pnpm ui:build
# 构建核心服务
pnpm build源码方式不是全局安装，请通过 pnpm openclaw ... 运行命令。
3.3 Docker 安装（服务器部署）
适合 VPS、云服务器等容器化部署场景。
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker Compose 启动
docker-compose up -d适用场景：VPS / 云服务器部署、隔离环境运行、快速测试体验。需要注意先安装 Docker、配置端口映射和数据持久化挂载卷。
四、初始化配置
安装完成后，运行初始化向导完成 AI 模型配置：
# 一键安装方式
openclaw onboard --install-daemon
# 源码安装方式
pnpm openclaw onboard --install-daemon向导将引导你完成以下配置：
- 选择 AI 模型提供商：支持 OpenAI、Claude、DeepSeek、Gemini 等
- 输入 API 密钥：配置对应服务商的 API Key
- 配置网关服务：设置端口、认证等网关参数
- 选择工具和插件：启用需要的工具集和扩展插件
国内用户推荐：在 Select Provider 步骤选择 DeepSeek，系统会自动完成配置，价格实惠且访问速度快。
五、启动与验证
5.1 验证安装
openclaw --version如果显示版本号，说明安装成功。如出现 "command not found"，请重启终端或检查 Node.js 是否在系统 PATH 中。
5.2 启动网关服务
# 启动 Gateway 网关
openclaw gateway
# 打开管理仪表板
openclaw dashboard启动成功后，浏览器会自动打开管理面板，默认地址：http://127.0.0.1:18789
5.3 常用检查命令
openclaw doctor— 环境诊断，检查所有依赖是否正常openclaw status— 查看网关服务状态openclaw health— 健康检查，确认服务正常运行
5.4 试一试：你的第一个任务
启动成功后，在管理面板中给 Agent 下达第一个指令：
"请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件，并在里面写入：大道至简，实战落地。"
OpenClaw Agent 会自动规划任务、调用文件系统工具并完成操作，感受 AI 智能体的强大能力！
六、常见问题
Q1: Windows 提示"Windows已保护你的电脑"怎么办？
这是 Windows Defender 的常规安全提示，并非程序有风险。解决方法：点击左下角"更多信息"，选择"仍要运行"，继续安装流程即可。
Q2: 安装依赖速度很慢怎么办？
国内用户务必配置 npm 镜像源：
pnpm config set registry https://registry.npmmirror.com/或者直接使用中国社区版的一键安装脚本。
Q3: Node.js 版本不够怎么办？
推荐使用 nvm 管理 Node.js 版本：
# 安装 nvm（macOS/Linux）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装并使用 Node 22
nvm install 22
nvm use 22Windows 用户可使用 nvm-windows。
Q4: 如何卸载 OpenClaw？
# 全局卸载
npm uninstall -g openclaw
# 删除配置文件（可选）
rm -rf ~/.openclaw如果是源码安装，直接删除项目文件夹即可。
Q5: 可以使用本地大模型吗？
可以！OpenClaw 支持通过 Ollama 接入本地模型，实现完全离线运行：
- 先安装 Ollama 并下载模型（如 Llama 3、Mistral 等）
- 在 onboard 向导中选择 Ollama 作为提供商
- 配置 Ollama 服务地址（默认 http://localhost:11434）
注意：本地模型需要较好的硬件配置，建议至少 16GB 内存。
💬 评论区