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 onboard --install-daemon

#仅仅运行配置向导
openclaw onboard

安装检查
步骤 1
yes					 （理解为设置个人账户）
步骤2
QuickStart			（快速开始）√
... 如果提示配置存在了 直接reset 重置即可
步骤3（选择模型）
如果已经存在了OpenAI 或者对应的大模型秘钥 可以对应选择
我这里使用的是阿里的百炼 暂时选择跳过即可
skip for now


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

---

## 第三步：启动网关服务

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

```bash
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。详细步骤看官方文档。
选择渠道 根据实际情况来 国内我个人应用选择飞书
Feishu/Lark(飞书)
输入AppSecret
9g
APP ID
cli_
步骤6 设置飞书连接模式
WebSorcket √ (长连接模式 建议选择适合 个人|家庭用户|内网开发）
webhook (飞书服务器在有消息时主动推送到公网ip地址）

飞书机器人配置详细配置步骤
现在，我们来走一遍具体的配置流程。请确保你同时登录了飞书开放平台的开发者后台和打开了你的 OpenClaw 终端。
步骤一：检查 OpenClaw 飞书配置 (在你的电脑上)
虽然你之前已经贴出了配置，但为了保险起见，我们再用命令确认一下飞书渠道的状态。
查看飞书渠道状态：在终端中输入以下命令，确认输出为 true。
bash
openclaw config get channels.feishu.enabled
核对 App ID 和 App 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 字