OpenClaw 零基础安装教程:从环境搭建到飞书集成

今日分享

在本教程中，你将一步步学会如何在 Windows 系统上部署 OpenClaw，并将其接入飞书，打造属于你自己的 AI 助理。

1. 准备工作

在开始之前，有几件事需要先确认一下。强烈建议使用一台干净的备用电脑或虚拟机来运行，避免与工作电脑的环境冲突，保护隐私安全。

系统要求：Windows 10/11 专业版或企业版（macOS/Linux 用户也可参考，步骤类似）。
网络：确保电脑可以正常访问互联网。
安装注意事项：在安装过程中，有哪些不懂的，可以直接复制问题去问AI！

2. 安装 Node.js 环境

OpenClaw 依赖 Node.js 运行，版本需要大于或等于 22。为了避免版本冲突，推荐使用 nvm (Node Version Manager) 来安装。

① 安装 nvm

访问 nvm-windows 的 GitHub 发布页，下载最新版的 nvm-setup.exe，或者在这个 https://nodejs.org/zh-cn/download 网页内下载！
双击安装，一路点击 “Next” 即可。

② 安装 Node.js 22

按 Win 键，搜索 PowerShell，右键选择 “以管理员身份运行”。

在 PowerShell 中依次输入以下命令：

# 安装 Node.js 22 版本nvm install 22# 使用该版本nvm use 22.22.0

看到 “Now using node v22.22.0” 的提示即表示成功。

3. 一键安装 OpenClaw

OpenClaw 提供了一键安装脚本，可以帮我们省去很多麻烦。

在刚才的管理员 PowerShell 中，输入以下命令并回车：
```
iwr -useb https://openclaw.ai/install.ps1 | iex
```
如果遇到执行策略报错，可以先运行下面这行命令，然后重新执行安装命令：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

4. 初始化配置

安装脚本通常会自动进入配置向导（Onboarding）。如果没有自动进入，或者想重新配置，可以输入：openclaw onboard --flow quickstart。

根据提示一步步选择：

风险提示：

问题：I understand this is powerful and inherently risky. Continue?
操作：输入 Yes 并回车。

选择模型提供商：

这里可以选择你想要的 AI 模型，比如 Kimi 或 通义千问。如果暂时没有 API Key，可以先选择 “Skip for now” 跳过，后续再配置。

配置 API Key：

如果你选择了某个模型（如 Kimi），需要输入从相应平台获取的 API Key。

配置通信渠道：

这里直接选择 “Skip for now”。因为在 Windows 原生环境下直接安装飞书插件容易出错，我们稍后会单独配置。

配置 Skills（技能）：

可以根据需要选择，初学者建议先 “Skip” 跳过，或者按空格键全选后回车。

完成：

配置完成后，脚本会自动启动 OpenClaw 的网关服务，并打开一个浏览器窗口。

5. 验证安装

如果浏览器自动打开了一个地址（通常是 http://127.0.0.1:18789/），并显示了一个聊天界面，恭喜你，安装成功了！

在网页底部的输入框里发一条消息，比如 “你好”。
如果 AI 有回复，说明核心功能一切正常。

6. 进阶：接入飞书机器人

这一步将让你的 OpenClaw 变成飞书里的机器人。

6.1 安装飞书插件

在刚才的 管理员 PowerShell 中，执行以下命令安装飞书插件：
```
openclaw plugins install @m1heng-clawd/feishu
```

6.2 配置飞书应用

创建应用：访问飞书开放平台]https://open.feishu.cn/app，点击 “创建企业自建应用”，填写名称等信息。
添加机器人能力：在应用左侧菜单栏，点击 “添加应用能力”，选择 “机器人”。
获取凭证：在左侧菜单栏点击 “凭证与基础信息”，复制 App ID 和 App Secret。

配置权限：在左侧菜单栏点击 “权限管理”，点击 “批量导入导出权限”，将下方 JSON 粘贴进去，确认新增权限：

{"scopes": {"tenant": ["im:message","im:message.p2p_msg:readonly","im:message.group_at_msg:readonly","im:message:send_as_bot","im:resource","contact:user.base:readonly"    ]  }}

配置事件订阅：

点击左侧 “事件与回调”。
在“事件配置”中，将 “订阅方式” 改为 “使用长连接接收事件”，点击保存。
点击下方的 “添加事件”，搜索并添加 **im.message.receive_v1**（这是接收消息的关键）。

发布版本：点击左侧 “版本管理与发布”，创建一个版本并发布。只有发布后配置才会生效。

6.3 将 OpenClaw 与飞书绑定

回到 PowerShell，将刚才复制的 App ID 和 App Secret 配置给 OpenClaw：

openclaw config set channels.feishu.appId "你的App ID"openclaw config set channels.feishu.appSecret "你的App Secret"openclaw config set channels.feishu.enabled true

重启网关使配置生效：
```
openclaw gateway restart
```
打开飞书，搜索你刚刚创建的应用名称，给它发一条消息。它会自动回复一个配对码。
将这个配对码复制，粘贴到 OpenClaw 的 Web 控制台 (http://127.0.0.1:18789/) 聊天框里并发送。看到绑定成功的提示后，你就可以在飞书里愉快地和你的 AI 助理聊天了！

7. 常用命令与避坑指南

🛠️ 常用排错命令

当遇到问题时，以下命令非常有用：

# 检查环境配置是否正确openclaw doctor# 查看网关运行状态openclaw status# 启动网关（如果没自动启动）openclaw gateway start# 查看实时日志（定位 bug 神器）openclaw logs follow

⚠️ 常见问题

openclaw 命令找不到：关闭当前 PowerShell，重新用管理员权限打开一个新的窗口，环境变量会自动刷新。
飞书机器人收不到消息：检查飞书开放平台的应用是否已发布；检查事件订阅是否选择了“长连接”；在 PowerShell 中用 openclaw logs follow 查看实时日志，看看有没有报错。
插件安装失败：Windows 原生环境对某些插件支持不太好，可以尝试在 WSL2 (Windows Subsystem for Linux) 中运行 OpenClaw，这是官方推荐的 Windows 玩法。

恭喜！你现在已经拥有了一个完全由你自己掌控的、接入飞书的 AI 助理。在安装过程中，有哪些不懂的，可以直接复制问题，去问AI即可！

更多教程看这里：

1、快速部署OpenClaw（Clawdbot）极简部署教程

https://pan.quark.cn/s/ad6f4e576783

2、即梦AI全面学习+实战教程，即梦AI一站式AI创作平台 https://pan.quark.cn/s/403dc90ae06e

3、2026豆包指令85+提示词合集

https://pan.quark.cn/s/d2ac6cffdd28

4、Seedance 2.0学习资料包，含使用教程+实测案例+玩法分享 https://pan.quark.cn/s/e06ecfef685f

5、《AI提效手册》里面包含AI提效手册豆包即梦剪映飞书扣子5合1实操指南 https://pan.quark.cn/s/a57d2d849d37

6、AI变现实战案例教程（16大课程合集） https://pan.quark.cn/s/f826f3eb72d6

点个在看你最好看