保姆级OpenClaw安装部署教程|从零开始搭建你的AI智能体网关

想搭建自己的 AI 智能体网关，但不知道从何下手？OpenClaw 开源框架，一台电脑就能搞定多平台聊天机器人！本教程全程 Windows 系统、Node.js 环境、PowerShell 安装，跟着步骤走不踩坑，建议收藏备用～

一、准备工作：了解 OpenClaw 是什么 🤔

OpenClaw 是什么？

OpenClaw 是一个开源的 AI 智能体网关，通过一个 Gateway 守护进程，统一连接 WhatsApp、Telegram、Discord、微信等多种聊天平台，让 AI 智能体在这些平台上和你对话。它还支持 iOS/Android 节点，可以调用手机摄像头、屏幕记录等能力。

简单理解：OpenClaw = AI 网关 + 多平台消息桥接 + 智能体运行时

核心特性一览

• 📨 多平台支持：WhatsApp、Telegram、Discord、iMessage、飞书、Signal 等
• 🧠 多模型接入：支持 Claude、GPT、Gemini、DeepSeek 等多种 LLM
• 🔌 插件生态：通过 ClawHub 安装技能（Skill），扩展 AI 能力
• 🎨 Canvas 交互：AI 可以生成实时交互界面，不止是文字聊天
• 📱 移动节点：配对 iOS/Android 设备，调用硬件能力

二、系统要求与前期准备 📋

1. 系统要求

• 操作系统：Windows（推荐 WSL2）、macOS、Linux 均可
• Node.js 版本：≥ 22（注意！低于 22 版本无法运行）
• 网络：需要能访问 npm 源（国内用户建议配置镜像）
• 硬盘空间：至少 2GB 剩余空间
• 💡 本教程以 Windows 系统为例全程演示

2. 检查 Node.js 是否安装

按下「Win+R」，输入「powershell」打开 PowerShell，执行以下命令检查 Node：

node --version

如果显示版本号（如 v22.x.x），说明 Node 已安装且版本 ≥ 22，可跳过下一步。

如果未安装或版本过低，进入下一步安装 Node.js。

3. 安装 Node.js（重点！）

打开 Node.js 官网（复制到浏览器访问）：

https://nodejs.org/^[1]

下载 LTS 长期支持版（版本 ≥ 22），点击下载安装包。

安装注意事项：

• ✅ 安装路径默认即可（C:\Program Files\nodejs）
• ✅ 勾选「Automatically install the necessary tools」
• ✅ 一路 Next，等待安装完成
• ❌ 无需额外配置

验证安装：

node --versionnpm --version

两个命令都显示版本号，说明安装成功 ✅

三、全局安装 OpenClaw 🚀

1. 配置 npm 国内镜像源（推荐）

国内用户下载 npm 包速度慢，先配置淘宝镜像源提速：

npm config set registry https://registry.npmmirror.com

配置成功后无报错，后续下载全程高速 ⚡

2. 安装 OpenClaw（全局安装）

在 PowerShell 中执行以下命令：

npm install -g openclaw@latest

等待安装完成（约 30 秒～2 分钟，视网络而定），无报错即安装成功。

如果遇到 sharp 安装报错，执行以下命令重试：

$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1npm install -g openclaw@latest

3. 验证安装

openclaw --version

如果显示版本号（如 1.x.x），说明 OpenClaw 安装成功 ✅

4. 新手引导并安装服务

openclaw onboard --install-daemon

此命令会：

• 配置 Gateway 网关服务
• 设置管理员账号密码
• 安装系统服务（后台自动运行）
• 提示是否要配对聊天渠道

💡 全程有交互式提示，按需选择即可。如果暂时不配渠道，可以后面再配。

四、启动并验证 Gateway 网关 🌐

1. 检查网关状态

openclaw gateway status

如果看到「running」状态，说明网关已正常运行 ✅

2. 检查健康状态

openclaw doctor

该命令会进行全面体检，包括 Node 版本、npm 配置、Gateway 运行状态等，绿色通过即表示一切正常 ✅

3. 打开 Web 控制面板

openclaw dashboard

执行后会自动在浏览器打开控制面板，地址为：

http://127.0.0.1:18789/^[2]

在这里你可以：

• 💬 直接与 AI 智能体聊天（无需任何渠道配置）
• ⚙️ 管理设置和渠道
• 📊 查看系统状态

五、配对你的第一个聊天渠道 🛠️

1. 渠道支持列表

OpenClaw 支持以下主流聊天平台：

2. 以 Telegram 为例快速配置

第一步：创建 Telegram Bot

在 Telegram 中搜索 @BotFather，发送：

/newbot

按提示设置机器人名称，获取 Bot Token（格式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）

第二步：配置到 OpenClaw

openclaw channels login

选择 Telegram，输入 Bot Token，完成配置。

第三步：发送消息测试

在 Telegram 中向你的 Bot 发送任意消息，OpenClaw 会自动回复 ✅

六、安装技能（Skill）扩展 AI 能力 🧩

1. 安装 ClawHub CLI

npm install -g clawhub

2. 搜索并安装技能

# 搜索天气技能clawhub search weather# 安装天气技能clawhub install weather# 搜索 PPT 生成技能clawhub search ppt# 搜索公众号发布技能clawhub search wechat

3. 常用技能推荐

• 🌤️ weather：查询天气和预报
• 📝 summarize-pro：AI 智能总结（文章、YouTube、PDF 等）
• 📊 ppt-generator：AI 生成精美 PPT
• 📢 wechat-publisher：一键发布到微信公众号
• 🔧 healthcheck：服务器安全巡检
• 🎨 skill-creator：创建自定义技能

七、从源码安装（进阶选项）⚡

如果你需要参与开发或自定义修改，可以从 GitHub 源码安装：

1. 克隆源码

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

2. 安装依赖

pnpm install

3. 构建 UI

pnpm ui:build

4. 构建并运行

pnpm buildpnpm openclaw onboard --install-daemon

💡 从源码运行有助于你深入了解 OpenClaw 的内部机制，也方便提交 PR 贡献代码。

八、新手避坑提醒 🚨

1. Node 版本必须 ≥ 22：否则安装报错，用 node --version 确认
2. 国内用户务必配置 npm 镜像源：否则下载速度极慢，甚至超时失败
3. sharp 安装报错：设置环境变量 SHARP_IGNORE_GLOBAL_LIBVIPS=1 后重试
4. 找不到 openclaw 命令：检查 npm 全局 bin 是否在 PATH 中，重启 PowerShell 即可
5. Gateway 端口冲突：默认 18789，可通过 --port 指定其他端口
6. WebChat 无法连接：确认 Gateway 已启动，访问 http://127.0.0.1:18789
7. 渠道配对失败：检查网络是否可访问对应平台，部分渠道需要科学上网
8. 每次升级前建议备份配置：配置文件和状态目录在 ~/.openclaw/

九、升级与维护 🔄

升级 OpenClaw

npm update -g openclawopenclaw doctor

查看运行状态

openclaw gateway statusopenclaw health

查看日志

openclaw log

🎉 至此，OpenClaw 安装部署全部完成！你现在拥有了一个私有的 AI 智能体网关，可以通过多个聊天平台与 AI 对话，还能通过安装技能扩展各种实用功能。后续可以探索多智能体路由、移动节点配对、Canvas 交互等高级玩法，关注我，获取更多 OpenClaw 实战教程～

📌 本文提到的所有资源链接：

• OpenClaw 官网：https://openclaw.ai^[3]
• GitHub 仓库：https://github.com/openclaw/openclaw^[4]
• Node.js 下载：https://nodejs.org^[5]
• 技能市场 ClawHub：https://clawhub.com^[6]
• 官方文档：https://docs.openclaw.ai^[7]

引用链接