保姆级教程：Windows下安装OpenClaw + 接入飞书机器人，看这一篇就够了！

优质文章学习记录

— 10 min read

文章目录

前言

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 # 一键安装OpenClawiwr-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分钟再重试 。
  3. 保存成功后，点击"添加事件"，搜索并添加 im.message.receive_v1（接收消息事件）
  4. 如果不添加此事件，机器人将无法收到任何消息

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%的问题。祝你在自动化办公的道路上一路畅通！

Read more

【干货实操】AI绘画/设计变现：零美术基础也能赚外快，90天落地计划+提示词模板（附可用学习链接）

前言 你是不是羡慕别人靠设计接单赚钱，却苦于没美术基础、没专业软件、没接单渠道？ 当下AI绘画技术的成熟，给普通人打开了一扇零门槛、零成本的变现大门——AI绘画/设计变现。不需要你会手绘、懂PS，只要掌握AI绘画工具的基础操作和精准提示词技巧，依托“AI生成初稿+人工微调优化”的模式，就能做出高质量的设计作品，承接头像、壁纸、海报等刚需订单，适合程序员、职场人、学生党利用碎片化时间赚外快，全程坚守合规底线，可直接落地。 本文整理了90天详细落地计划，包含工具选型、获客渠道、定价策略、版权注意事项等全流程实操步骤，附赠公共可用的学习资料和提示词模板，普通人照做就能上手，轻松实现从0到1的收益突破。 核心原则 1. 零成本起步：拒绝付费会员、培训课程，全部使用免费AI绘画工具和免费获客渠道； 2. AI+人工双驱动：AI负责基础图像生成，人工负责细节优化、风格调整，保证作品差异化； 3. 刚需低竞争赛道切入：避开复杂的商业插画、

Qwen3-Reranker-0.6B效果展示：AR导航指令与空间位置描述语义排序

Qwen3-Reranker-0.6B效果展示：AR导航指令与空间位置描述语义排序 1. 为什么这次重排序让人眼前一亮？ 你有没有试过在AR眼镜里听导航说“左转后第三个门右边的蓝色立柱旁”，结果却站在原地反复确认——到底哪个是“第三个门”？又或者，系统把“电梯口正对面的消防栓”和“电梯右侧三米处的绿植墙”排在了同一相关性层级，让你举着设备左右张望？ 这不是你的问题，是传统检索模型在空间语义理解上的真实短板。 Qwen3-Reranker-0.6B 不是又一个泛用型重排序模型。它专为具身智能、空间计算与AR交互场景打磨过语义感知能力。我们没拿新闻标题或电商商品做测试，而是直接扔进27组真实AR导航指令+空间位置描述对，覆盖商场导览、工厂巡检、博物馆动线、仓储拣货等4类高混淆度场景。结果很实在：在“方向+序数+参照物+方位词”嵌套结构（比如“从主入口直行约15步，左手边第二根银色立柱内侧贴墙的二维码”）上，它的排序准确率比上一代提升38.6%，Top-1命中率首次突破91%。 这不是参数堆出来的指标，而是模型真正“听懂了你在找什么”。 2. 它到底在排序什么？

大疆无人机最怕的5种反制手段实测：从干扰枪到激光武器的效果对比

大疆无人机反制实战手册：从干扰到捕获的五种核心方案深度解析 对于许多依赖无人机进行商业测绘、影视航拍、安防巡检的专业团队而言，无人机的稳定飞行是业务的生命线。然而，在机场周边、大型活动现场、关键基础设施保护区等敏感区域，未经授权的“黑飞”无人机已成为一个不容忽视的安全隐患。作为从业者，我们不仅需要精通飞行，更应了解其潜在的脆弱性，以便在必要时进行合规、有效的安全管控。市面上流传着各种反制手段，从几千元的手持干扰枪到价值不菲的激光系统，它们究竟如何工作？在实际环境中面对精灵4、御系列等主流机型时，效果几何？今天，我们就抛开理论，结合实测数据与场景分析，深入拆解五种主流反制方案的核心机理、操作技巧与效能边界。 1. 无线电频谱压制：干扰枪的实战应用与频段选择 无线电干扰是目前最常见、最便携的反制手段。其原理并不复杂：通过发射大功率的无线电信号，覆盖或淹没无人机与遥控器之间用于飞控和图传的特定频段，迫使通信链路中断。一旦失去控制信号，无人机通常会执行预设的安全策略——自动返航、悬停或降落。 注意：使用无线电干扰设备必须严格遵守当地无线电管理条例，仅在获得授权的特定区域（如重大活动安
微搭低代码MBA 培训管理系统实战 19——教务管理：从订单到课时卡的自动转化

微搭低代码MBA 培训管理系统实战 19——教务管理：从订单到课时卡的自动转化

目录 * 前情回顾 * 一、 数据源设计 * 1.1 学员档案表 (`MBA_StudentProfiles`) * 1.2 课时卡表 (`MBA_LearningCards`) * 二 创建管理页面 * 2.1 搭建财务布局 * 2.2 搭建待支付列表页面 * 2.3 搭建确认支付弹窗 * 2.4 自动化开课 * 三 配置门户数据 * 最终效果 * 总结 前情回顾 上一篇中我们讲解了销售在订单成交后，录入订单。此时订单的状态还是待支付的状态，需要财务确认收款情况。财务人员点击了"确认收款"，订单状态变更为 已清账。此时，资金流已经闭环，但学员在系统里还只是一个"商机客户"，没有上课的权限。