OpenClaw 完整安装教程：从零搭建你的个人 AI 智能体

OpenClaw 是什么？

OpenClaw（中文名"龙虾 AI"）是一个开源的个人 AI 智能体执行网关。它的特点是：

自然语言操控 - 用说话的方式让 AI 帮你操作电脑、处理文件
多平台接入 - 支持飞书、企业微信、钉钉、QQ、WhatsApp、Telegram、Discord 等
本地部署 - 完全私有化，数据留在自己手里
国产模型支持 - 无缝接入 DeepSeek、豆包、GLM 等国产大模型
浏览器自动化 - AI 可以自主打开网页、截图、点击、输入

简单说，OpenClaw 就是一个能帮你干活的 AI 助手，不只是聊天，而是真的能执行操作。

系统要求

在开始之前，确保你的设备满足以下要求：

环境	要求
操作系统	macOS、Linux、Windows（推荐 WSL2）
Node.js	推荐 Node 24，支持 Node 22 LTS（需 22.16+）
内存	最低 4GB，推荐 8GB+
磁盘	至少 2GB 可用空间
网络	需要访问 API 接口（国内注意网络问题）

Windows 用户注意：强烈建议在 WSL2 环境下运行，不要直接在 Windows 原生环境安装。

安装方式一：安装脚本（推荐）

这是官方推荐的安装方式，一行命令搞定所有步骤。

macOS / Linux / WSL2

打开终端，执行：

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

安装脚本执行示意

安装脚本会自动：

检测你的 Node.js 版本
安装或升级 Node 24（如果需要）
安装 OpenClaw
启动新手引导

Windows PowerShell

在 PowerShell 中执行：

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

安装方式二：npm 安装

如果你已经自己管理 Node.js 环境，可以用 npm 安装：

# 全局安装
npm install -g openclaw@latest

# 启动新手引导
openclaw onboard --install-daemon

npm 安装示意

安装方式三：从源码安装（开发者）

如果你想研究源码或做二次开发：

# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖
pnpm install

# 3. 构建前端 UI
pnpm ui:build

# 4. 构建项目
pnpm build

# 5. 链接 CLI
pnpm link --global

# 6. 启动新手引导
openclaw onboard --install-daemon

注意：从源码安装需要额外安装 pnpm。

新手引导配置

安装完成后，会自动进入新手引导：

新手引导第一步

步骤 1：配置模型

选择你想使用的大模型。推荐新手先用 DeepSeek 或豆包，国内访问速度快。

# 你也可以手动配置
openclaw config set model.provider deepseek
openclaw config set model.api_key your_api_key

步骤 2：配置通道

选择你要接入的聊天平台：

飞书
企业微信
钉钉
QQ
Telegram
Discord
WhatsApp

通道配置界面

步骤 3：启动服务

配置完成后，启动 OpenClaw：

openclaw start

验证安装

安装完成后，运行以下命令验证是否成功：

# 检查系统配置
openclaw doctor

# 查看网关状态
openclaw status

# 打开 Web 管理界面
openclaw dashboard

Web 控制台

成功启动后，访问 http://127.0.0.1:18789/

OpenClaw Dashboard

首次访问需要 token，命令会打印带 token 的链接：

openclaw dashboard
# 输出：打开浏览器访问 http://127.0.0.1:18789/?token=xxxxxx

其他安装方式

Docker 安装

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

Nix 安装

nix-shell -p openclaw

常见问题

Q1: 安装脚本报错 "Node version not supported"

你的 Node.js 版本太低了。安装脚本会自动帮你升级，或者你也可以手动安装：

# 使用 nvm 管理 Node 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 24
nvm use 24

Q2: Windows 原生环境安装失败

Windows 用户请使用 WSL2：

# 打开 PowerShell（管理员），安装 WSL2
wsl --install
# 重启电脑
# 然后在 WSL2 终端中执行安装命令

Q3: 启动后 Web 界面打不开

检查端口是否被占用：

# 查看 OpenClaw 状态
openclaw status

# 查看端口占用
lsof -i :18789

Q4: 提示 "Command not found"

重新加载环境变量：

# macOS/Linux
source ~/.bashrc  # 或 source ~/.zshrc

# WSL2
source ~/.bashrc

更新与卸载

更新 OpenClaw

# npm 安装的更新
npm update -g openclaw@latest

# 安装脚本安装的更新
curl -fsSL https://openclaw.ai/install.sh | bash

卸载 OpenClaw

# 停止服务
openclaw stop

# 卸载 CLI
npm uninstall -g openclaw

# 删除数据目录
rm -rf ~/.openclaw

下一步

安装完成后，你可以：

配置模型 - 接入 DeepSeek、豆包等国产模型
配置通道 - 连接你的飞书/钉钉/Telegram 账号
开始使用 - 让 AI 帮你完成各种任务

参考链接

官网：https://openclaw.ai
官方文档：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw
中文社区：https://openclawai.cc

有任何问题欢迎在评论区讨论！