OpenClaw 部署完全教程：30 分钟搞定你的 AI 助理

教程 | 预计 800-1500 字

---

前言

OpenClaw 是个好东西，能让你的 AI 从"只会聊天"变成"真正做事"。但很多兄弟卡在部署这一步。

说实话，我第一次部署也踩了不少坑。今天把完整流程梳理一遍，照着做，30 分钟搞定。

读完这篇，你能：

• 在一台新机器上部署 OpenClaw
• 配置网关和通道
• 登录 WhatsApp/Telegram
• 开始使用技能

---

环境准备

系统要求

OpenClaw 支持 Windows、macOS、Linux。我用的是 Windows 11，其他系统命令大同小异。

需要的东西：

• Node.js 22+（必须）
• Python 3.8+（部分技能需要）
• 一个能上网的环境（你懂的）

检查 Node.js：

node -v
# 输出 v22.x.x 或更高

如果没有，去 nodejs.org 下载安装。

---

第一步：安装 OpenClaw

一键安装（推荐）

打开命令行，运行：

npm install -g openclaw

等几分钟，看到 openclaw 命令就成功了。

验证安装：

openclaw --version
# 输出版本号，比如 2026.3.7

源码安装（可选）

如果你想用最新版，可以克隆源码：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm link

---

第二步：初始化配置

运行配置向导：

openclaw init

会提示你选择：

1. 工作空间目录：建议用默认的 ~/.openclaw/workspace
2. 模型提供商：选你有的（我用的通义千问）
3. API Key：填你的密钥

配置完成后，会生成 ~/.openclaw/.env 文件。别弄丢了这个文件，里面都是你的密钥。

---

第三步：启动网关服务

网关是 OpenClaw 的核心，负责处理消息路由。

openclaw gateway start

看到 Gateway started 就成功了。

检查状态：

openclaw gateway status

应该显示运行中。如果失败了，看看是不是端口被占用了（默认 3000）。

---

第四步：配置通信通道

OpenClaw 支持多种通道：WhatsApp、Telegram、Discord、飞书等。

WhatsApp 登录（最常用）

openclaw channel whatsapp

会显示一个二维码，用手机 WhatsApp 扫描。

注意：

• 二维码 30 秒过期，过期了重新运行命令
• 登录后别急着关窗口，等显示 Connected 再关闭

Telegram 登录

openclaw channel telegram

需要你的 Bot Token，找 @BotFather 申请一个。

飞书登录（国内推荐）

openclaw channel feishu

需要创建飞书应用，获取 App ID 和 Secret。详细步骤看官方文档。

---

第五步：安装技能

OpenClaw 的核心是技能。先装几个常用的：

# 查看可用技能
clawhub list

# 安装技能
clawhub install skill-name

我推荐的技能组合：

• tavily-search - 网络搜索
• summarize - 内容总结
• weather - 天气查询
• feishu-doc - 飞书文档操作

---

常见问题

Q1: 安装时提示权限错误

解决： 用管理员权限运行命令行，或者：

npm install -g openclaw --unsafe-perm

Q2: 网关启动失败

可能原因：

• 端口被占用 → 改端口 openclaw gateway start --port 3001
• 配置文件错误 → 检查 ~/.openclaw/.env

Q3: WhatsApp 二维码扫不上

试试这些：

• 手机和电脑在同一网络
• 重启 WhatsApp 再试
• 用 Telegram 或飞书（更稳定）

Q4: 技能安装失败

检查网络，有些技能仓库在国内访问慢。可以：

# 使用镜像
npm config set registry https://registry.npmmirror.com

---

验证部署

发条消息试试：

"今天天气怎么样？"

如果 AI 回复了，恭喜你，部署成功！🎉

---

总结

OpenClaw 部署其实就 5 步：

1. 安装 OpenClaw
2. 初始化配置
3. 启动网关
4. 配置通道
5. 安装技能

核心就两点：

• Node.js 环境要装好
• API Key 要配置对

遇到问题别慌，看日志。日志在 ~/.openclaw/logs/ 目录。

---

下一步建议

部署完成后，可以试试：

• 写一个自定义技能
• 配置定时任务（Heartbeat）
• 接入更多通道（飞书、Discord）

有问题的话，去官方 Discord 社区问：https://discord.com/invite/clawd

---

发布于 2026-03-10
字数：约 1200 字