跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Windows 下安装 OpenClaw 并接入飞书机器人教程

综述由AI生成在 Windows 环境下安装 OpenClaw 开源 AI Agent 框架并接入飞书机器人的完整流程。内容涵盖环境准备（Node.js、nvm）、OpenClaw 一键安装与初始化、大模型 API 配置、飞书企业自建应用创建及权限配置、事件订阅设置以及配对操作。同时提供了常用排错命令、常见问题解决方案及进阶技巧，帮助用户快速搭建自动化办公助手。

宁静发布于 2026/4/6更新于 2026/5/3133 浏览

前言

OpenClaw 作为一个强大的开源 AI Agent 框架，与飞书结合可以大幅提升办公效率。本文将手把手教你如何在 Windows 系统上完成 OpenClaw 的安装，并成功接入飞书机器人。全文均为实测可用的步骤，附带排错命令，帮你避开常见坑点。

⚠️ 重要提示：隐私安全优先

在开始之前，有一个非常重要的提醒：由于 OpenClaw 这类自动化工具会深度接触你的系统和数据，如果你的电脑存有重要的商业资料或个人隐私信息，强烈建议使用一台干净的备用电脑，或者在云端虚拟机（VPS）来运行。这样既能保护隐私，也能避免环境冲突。

第一部分：Windows 环境准备

1.1 系统要求

  • 操作系统：Windows 10/11 64 位（专业版或企业版更佳）
  • 权限要求：全程需使用管理员权限运行 PowerShell
  • 网络要求：确保网络通畅，能访问 GitHub 和 npm 源

1.2 安装 nvm for Windows（推荐）

使用 nvm 可以方便地管理 Node.js 版本，避免版本冲突。

  1. 访问 nvm-windows 的 GitHub 发布页：https://github.com/coreybutler/nvm-windows/releases
  2. 下载最新的 nvm-setup.exe 安装包
  3. 一路点击 Next 完成安装

1.3 安装 Node.js 22.x 版本

OpenClaw 要求 Node.js 22 或更高版本。以管理员身份打开 PowerShell（按 Win 键搜索 PowerShell → 右键 → 以管理员身份运行），然后执行以下命令：

# 安装 Node.js 22.x
nvm install 22
# 使用安装好的版本
nvm use 22.22.0

看到提示 Now using node v22.22.0 即表示成功。如果下载失败，也可以手动去 Node.js 官网下载安装。

验证安装：

node --version
npm --version

第二部分：安装 OpenClaw

2.1 一键安装脚本（推荐）

在管理员 PowerShell 中执行以下命令：

# 如果遇到执行策略报错，先解除限制
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 一键安装 OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex

如果网络不稳定，可以使用国内镜像：

iwr -useb https://clawd.org.cn/install.ps1 | iex

安装过程会自动下载并配置 Node.js 和 OpenClaw 核心文件，通常需要等待 5-10 分钟。

2.2 初始化配置

安装完成后会自动进入配置流程。如果意外关闭，可以重新执行：

openclaw onboard --flow quickstart

交互配置步骤（按提示操作）：

  1. 风险提示：I understand this is powerful and inherently risky. Continue? → 输入 Yes
  2. 初始化模式：选择 QuickStart（直接回车）
  3. 模型提供商：建议先选择 Skip for now 跳过，后续再配置
  4. 通讯渠道：同样选择 Skip for now 跳过（飞书稍后单独配置）
  5. 技能配置：选择 No 跳过，后续可根据需要安装

⚠️ 常见问题：如果执行 openclaw 命令提示无法识别，只需关闭当前 PowerShell，重新用管理员权限打开一个新窗口即可。这是因为环境变量还未刷新。

2.3 启动服务并验证

# 启动网关服务
openclaw gateway start
# 访问 Web 控制台（会自动打开浏览器）
openclaw dashboard

浏览器会自动打开控制台地址：http://127.0.0.1:18789/。发一条消息测试，有回复就说明安装成功。

第三部分：配置大模型 API（核心前提）

OpenClaw 的自然语言理解能力依赖大模型，需要先配置 API 密钥。这里以阿里云百炼为例：

  1. 访问阿里云百炼控制台，进入密钥管理页面
  2. 点击创建 API-Key，复制生成的密钥

在 OpenClaw 中配置：

# 配置百炼 API-Key（替换为你的实际密钥）
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启网关使配置生效
openclaw gateway restart

第四部分：飞书机器人配置（核心步骤）

4.1 安装飞书插件

在管理员 PowerShell 中执行：

openclaw plugins install @m1heng-clawd/feishu

插件安装可能需要几分钟，期间可以继续后续的飞书开放平台配置。

4.2 创建飞书企业自建应用

  1. 登录飞书开放平台，进入开发者后台
  2. 点击创建企业自建应用，填写基本信息：
    • 应用名称：如 OpenClaw 智能助手
    • 应用描述：简要说明用途
    • 应用图标：上传一个图标（可选）
  3. 点击创建

4.3 添加机器人能力

在应用详情页左侧导航栏，找到添加应用能力 → 选择机器人 → 点击添加。

4.4 获取核心凭证

进入凭证与基础信息页面，复制以下信息并妥善保存（后续配置需要使用）：

  • App ID：应用的唯一标识
  • App Secret：应用的安全凭证

4.5 批量导入权限

进入权限管理页面，点击批量导入/导出权限，粘贴以下 JSON 配置，然后点击确认新增权限：

{"scopes":{"tenant":["aily:file:read","aily:file:write","contact:user.employee_id:readonly","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user":["aily:file:read","aily:file:write","im:chat.access_event.bot_p2p_chat:read"]}}

这个配置包含了机器人必需的 8 项核心权限。

4.6 配置事件订阅

  1. 进入事件与回调页面 → 事件配置页签
  2. 订阅方式：选择使用长连接接收事件 → 点击保存

⚠️ 注意：如果报错未建立长连接，说明 OpenClaw 网关未正常运行。返回 PowerShell 执行 openclaw gateway restart，等 1-2 分钟再重试。

  1. 保存成功后，点击添加事件，搜索并添加 im.message.receive_v1（接收消息事件）
  2. 如果不添加此事件，机器人将无法收到任何消息

4.7 在 OpenClaw 中配置飞书凭证

方式一：通过命令行配置

# 配置 App ID 和 App Secret（替换为实际值）
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
# 重启网关
openclaw gateway restart

方式二：通过 Web UI 配置

  1. 访问 OpenClaw 控制台 http://127.0.0.1:18789/
  2. 进入 Channels 或通道设置页面
  3. 找到飞书配置，填入 App ID 和 App Secret

4.8 发布应用版本

  1. 回到飞书开放平台，进入版本管理与发布页面
  2. 点击创建版本
  3. 填写版本号（如 v1.0.0）和更新说明
  4. 选择应用可见范围（可先选指定部门用于测试）
  5. 点击保存并提交审批
  6. 若自己就是管理员，可直接审批通过

4.9 配对操作

  1. 在飞书客户端（电脑端或手机端）搜索并添加刚刚创建的机器人
  2. 向机器人发送任意消息（如你好）
  3. 机器人会自动回复一个配对码

复制这个配对码，在 OpenClaw 控制台中执行：

openclaw pairing approve feishu 配对码

或者通过 Web UI 输入配对码完成绑定

配对成功后，你就可以在飞书中与 OpenClaw 愉快交流了！也可以把机器人添加到公司群里，让所有小伙伴都能用。

第五部分：常用排错命令

在配置过程中遇到问题，优先使用以下命令自查：

命令作用
openclaw gateway status查看网关服务运行状态
openclaw gateway restart重启网关（修改配置后必须执行）
openclaw doctor全面诊断系统环境，给出修复建议
openclaw logs follow实时查看日志，出 bug 基本靠它定位
openclaw config交互式修改配置
openclaw --version查看版本，验证安装是否成功

常见问题及解决方案

Q1：安装插件时报错怎么办？

A：先执行 openclaw gateway restart 重启网关，再重试安装。如果仍失败，查看日志 openclaw logs follow 定位具体原因。

Q2：飞书配置时报未建立长连接？

A：这通常是 OpenClaw 网关未正常运行或网络不通。按顺序检查：

  1. openclaw gateway status 确认网关运行中
  2. 18789 端口是否被防火墙阻止
  3. 在飞书开放平台等待 1-2 分钟后重试保存

Q3：机器人收不到消息？

A：检查三点：

  1. 是否已添加 im.message.receive_v1 事件
  2. 应用版本是否已成功发布
  3. 是否已完成配对操作

Q4：Node.js 版本不兼容？

A：OpenClaw 要求 Node.js 22+，执行 node --version 查看版本。如版本过低，用 nvm 切换：nvm install 22 → nvm use 22.22.0。

进阶技巧：让 AI 学会发图片

OpenClaw 默认的 message 工具在飞书上发送本地图片时可能存在问题（飞书收到的是文件路径而非图片）。解决方法是利用 OpenClaw 的 TOOLS.md 机制：

在 OpenClaw 工作区的 TOOLS.md 文件中，加入以下内容（可直接在对话中发给 OpenClaw）：

# 飞书发图片方法
用 exec 工具执行 curl 调飞书 API，分三步：
1. 获取 tenant_access_token
2. 上传图片获取 image_key
3. 发送图片消息
具体命令参考飞书开放平台文档。

OpenClaw 的 AI 助手每次启动都会读取 TOOLS.md，学会这个新技能。这就是 OpenClaw 的设计哲学：用自然语言给 AI 写说明书。

总结

通过本文的详细步骤，你应该已经成功在 Windows 上安装了 OpenClaw，并接入了飞书机器人。整个过程虽然步骤较多，但只要按顺序操作，就能顺利实现飞书聊天窗口下达指令，OpenClaw 自动执行任务的高效协作模式。

如果在配置过程中遇到问题，记得善用 openclaw logs follow 查看日志，它能帮你定位 90% 的问题。祝你在自动化办公的道路上一路畅通！

目录

  1. 前言
  2. ⚠️ 重要提示：隐私安全优先
  3. 第一部分：Windows 环境准备
  4. 1.1 系统要求
  5. 1.2 安装 nvm for Windows（推荐）
  6. 1.3 安装 Node.js 22.x 版本
  7. 安装 Node.js 22.x
  8. 使用安装好的版本
  9. 第二部分：安装 OpenClaw
  10. 2.1 一键安装脚本（推荐）
  11. 如果遇到执行策略报错，先解除限制
  12. 一键安装 OpenClaw
  13. 2.2 初始化配置
  14. 2.3 启动服务并验证
  15. 启动网关服务
  16. 访问 Web 控制台（会自动打开浏览器）
  17. 第三部分：配置大模型 API（核心前提）
  18. 配置百炼 API-Key（替换为你的实际密钥）
  19. 设置默认模型
  20. 重启网关使配置生效
  21. 第四部分：飞书机器人配置（核心步骤）
  22. 4.1 安装飞书插件
  23. 4.2 创建飞书企业自建应用
  24. 4.3 添加机器人能力
  25. 4.4 获取核心凭证
  26. 4.5 批量导入权限
  27. 4.6 配置事件订阅
  28. 4.7 在 OpenClaw 中配置飞书凭证
  29. 配置 App ID 和 App Secret（替换为实际值）
  30. 重启网关
  31. 4.8 发布应用版本
  32. 4.9 配对操作
  33. 第五部分：常用排错命令
  34. 常见问题及解决方案
  35. Q1：安装插件时报错怎么办？
  36. Q2：飞书配置时报未建立长连接？
  37. Q3：机器人收不到消息？
  38. Q4：Node.js 版本不兼容？
  39. 进阶技巧：让 AI 学会发图片
  40. 飞书发图片方法
  41. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • 技术副业变现路径：Python 爬虫开发实战指南
  • 链表核心算法：反转、合并与排序 Python 实现
  • Llama-2-7b 在昇腾 NPU 上的六大核心场景性能基准测试
  • WSL2 Ubuntu 部署 llama.cpp 指南
  • WebLaTeX 在线 LaTeX 编辑器使用指南
  • N8N 对接飞书多维表实现数据增删改查实战详解
  • 热门开源 AI 大模型项目精选与适用场景深度解析
  • MCP Server 实现 Excel 表格一键生成可视化图表 HTML 报告
  • Discord 机器人创建与配置流程
  • StreamVLN 具身导航复现与推理指南
  • 前端防抖（Debounce）和节流（Throttle）详解
  • 2024 年 AI 趋势：初创企业如何利用 LLM 技术赋能业务
  • 前端错误处理最佳实践与策略
  • Windows 10/11 部署 OpenClaw：环境搭建与机器人互联
  • 北漂转行软件测试：从零开始的外企高薪实战指南
  • Openclaw 开源仿生爪：革新机器人抓取技术
  • OpenWebUI 集成 SearXNG 实现本地大模型联网搜索
  • Handy：完全离线的开源语音转文字应用
  • DeepSeek-R1 发布 72 小时：AI 行业主要反响与影响
  • 2026 年主流 AI 写作工具横向测评：逻辑、拟人与成本对比

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online