openclaw-deploy

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

教程 | 预计 800-1500 字

前言

OpenClaw 堪称效率利器——它能将普通聊天AI升级为真正能处理任务的智能助理。不过说实话，很多人在部署阶段就被卡住了。

回想首次部署经历，确实踩过不少坑。今天就把完整流程梳理出来，按照这个指南操作，半小时内完成部署完全可行。

完成本教程后，你将能够：

• 在新设备上成功部署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的核心组件，负责所有消息路由处理。

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 设置飞书连接模式：

• WebSocket √ (长连接模式，适合个人用户/家庭用户/内网开发)
• webhook (飞书服务器在有消息时主动推送到公网IP地址)

飞书机器人配置详细步骤

现在，我们来走一遍具体的配置流程。请确保你同时登录了飞书开放平台的开发者后台和打开了你的OpenClaw终端。

步骤一：检查OpenClaw飞书配置（在你的电脑上）

虽然之前已经贴出了配置，但为了保险起见，我们再用命令确认一下飞书渠道的状态。

查看飞书渠道状态：在终端中输入以下命令，确认输出为true。

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的回复，恭喜你，部署成功！