OpenClaw 小白部署指南

零基础也能看懂的 OpenClaw 安装教程

---

🤔 OpenClaw 是什么？

简单说，OpenClaw 是一个开源的 AI 助手框架，你可以：

• 在自己的电脑上运行 AI 助手
• 连接 WhatsApp、Telegram、Discord、飞书等聊天平台
• 让 AI 帮你处理消息、管理日程、自动化任务
• 完全掌控自己的数据和隐私

---

📋 安装前准备

系统要求

系统	支持情况	推荐方式
macOS	✅ 完美支持	直接安装
Linux	✅ 完美支持	直接安装
Windows	⚠️ 需要 WSL2	先装 WSL2

必备条件

已安装：Node.js 22 或更高版本
已安装：Git

如何安装 Node.js？

方式一：使用 nvm（推荐）

macOS / Linux：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重启终端后，安装 Node.js 22
nvm install 22
nvm use 22

Windows（PowerShell）：

# 安装 nvm-windows
winget install CoreyButler.NVMforWindows

# 重启终端后
nvm install 22
nvm use 22

方式二：直接下载安装包

访问 https://nodejs.org/ 下载 LTS 版本（长期支持版），双击安装即可。

验证安装

打开终端（Windows 用 PowerShell），输入：

node -v

如果显示 v22.x.x 或更高版本，就 OK 了！

---

🚀 开始安装

Windows 用户请先看这里！

Windows 必须通过 WSL2 运行 OpenClaw。WSL2 就是让 Windows 能运行 Linux 环境。

安装 WSL2（只需一次）：

1. 以管理员身份打开 PowerShell
2. 输入以下命令：

wsl --install

3. 重启电脑
4. 重启后会自动打开 Ubuntu，设置用户名和密码
5. 之后的操作都在 Ubuntu 终端里进行

启用 systemd（重要）：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

然后关闭 Ubuntu，在 PowerShell 执行：

wsl --shutdown

重新打开 Ubuntu，继续下面的步骤。

---

macOS / Linux / WSL2 用户

方式一：一键安装（最简单推荐）

打开终端，复制粘贴这条命令：

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

脚本会自动：

• 检测系统环境
• 安装 OpenClaw CLI
• 启动新手引导

方式二：npm 全局安装

如果你已经装好 Node.js：

npm install -g openclaw@latest

---

🎯 首次配置

安装完成后，运行新手引导：

openclaw onboard --install-daemon

引导会问你几个问题：

1. 选择 AI 模型提供商

推荐选项：

• OpenAI：需要 API Key 或 Code 订阅
• Anthropic Claude：需要 API Key
• 智谱 GLM：国内用户友好，访问 https://open.bigmodel.cn 获取

2. 选择聊天平台

支持多种平台，选你需要的：

• WhatsApp：扫码登录
• Telegram：创建机器人，获取 Token
• Discord：创建机器人应用
• 飞书：配置机器人应用

3. 安装后台服务

选择「是」，让 OpenClaw 开机自启。

---

✅ 验证安装

检查状态

# 查看 OpenClaw 状态
openclaw status

# 健康检查
openclaw health

# 问题诊断
openclaw doctor

启动 Gateway 网关

openclaw gateway --port 18789

打开 Web 控制台

浏览器访问：http://127.0.0.1:18789/

---

📱 连接聊天平台

WhatsApp

openclaw channels login

1. 命令会显示一个二维码
2. 打开手机 WhatsApp → 设置 → 已链接的设备 → 链接设备
3. 扫描二维码

Telegram

1. 找 @BotFather 对话
2. 发送 /newbot 创建机器人
3. 按提示设置名称
4. 获得 Token 后，运行：

openclaw configure --section channels.telegram

飞书

1. 访问飞书开放平台 https://open.feishu.cn
2. 创建企业自建应用
3. 配置机器人能力和权限
4. 获取 App ID 和 App Secret
5. 运行配置命令

---

🔐 私信安全设置

默认情况下，陌生人发来的私信需要你手动批准。

查看待审批的配对请求：

openclaw pairing list whatsapp

批准配对：

openclaw pairing approve whatsapp <配对码>

---

🎉 发送第一条消息

openclaw message send --target +8613800138000 --message "Hello from OpenClaw!"

---

❓ 常见问题

Q: 命令找不到 openclaw

原因：npm 全局安装路径没加到 PATH

解决：

# 查看全局安装路径
npm prefix -g

# macOS / Linux 添加到 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Windows 添加到系统环境变量 PATH

Q: sharp 安装失败

解决：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Q: Gateway 启动失败

检查端口占用：

# macOS / Linux
lsof -i :18789

# Windows
netstat -ano | findstr :18789

Q: WhatsApp 连接问题

确保使用 Node 运行 Gateway，而不是 Bun：

openclaw gateway --port 18789

---

📚 进阶学习

• Dashboard 面板：openclaw dashboard
• 配置文件位置：~/.openclaw/
• 查看日志：openclaw logs
• 更新版本：npm update -g openclaw@latest
• 卸载：npm uninstall -g openclaw

---

🔗 有用的链接

• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw
• 社区 Discord：https://discord.com/invite/clawd
• Skills 插件市场：https://clawhub.com

---

📝 小结

安装 Node.js 22+ 
    ↓
运行安装命令
    ↓
执行新手引导
    ↓
连接聊天平台
    ↓
开始使用！

就是这么简单！有问题欢迎到社区提问 🎊