乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 零基础安装教程:从环境搭建到飞书集成

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

当前时间： 2026-03-10 19:25:57 分类：办公文件 评论(0)
OpenClaw 零基础安装教程:从环境搭建到飞书集成

今日分享

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

1. 准备工作

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

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

2. 安装 Node.js 环境

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

① 安装 nvm

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

② 安装 Node.js 22

  1. 按 Win 键，搜索 PowerShell，右键选择 “以管理员身份运行”。
  2. 在 PowerShell 中依次输入以下命令：
    # 安装 Node.js 22 版本nvm install 22# 使用该版本nvm use 22.22.0
  3. 看到 “Now using node v22.22.0” 的提示即表示成功。

3. 一键安装 OpenClaw

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

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

4. 初始化配置

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

根据提示一步步选择：

  1. 风险提示：

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

  2. 选择模型提供商：

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

  3. 配置 API Key：

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

  4. 配置通信渠道：

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

  5. 配置 Skills（技能）：

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

  6. 完成：

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

5. 验证安装

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

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

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

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

6.1 安装飞书插件

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

6.2 配置飞书应用

  1. 创建应用：访问飞书开放平台]https://open.feishu.cn/app，点击 “创建企业自建应用”，填写名称等信息。
  2. 添加机器人能力：在应用左侧菜单栏，点击 “添加应用能力”，选择 “机器人”。
  3. 获取凭证：在左侧菜单栏点击 “凭证与基础信息”，复制 App ID 和 App Secret。
  4. 配置权限：在左侧菜单栏点击 “权限管理”，点击 “批量导入导出权限”，将下方 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"    ]  }}
  5. 配置事件订阅：
    • 点击左侧 “事件与回调”。
    • 在“事件配置”中，将 “订阅方式” 改为 “使用长连接接收事件”，点击保存。
    • 点击下方的 “添加事件”，搜索并添加 **im.message.receive_v1**（这是接收消息的关键）。
  6. 发布版本：点击左侧 “版本管理与发布”，创建一个版本并发布。只有发布后配置才会生效。

6.3 将 OpenClaw 与飞书绑定

  1. 回到 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
  2. 重启网关使配置生效：
    openclaw gateway restart
  3. 打开飞书，搜索你刚刚创建的应用名称，给它发一条消息。它会自动回复一个配对码。
  4. 将这个配对码复制，粘贴到 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

更多教程看这里：

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

 1

点个在看你最好看