从零开始：OpenClaw安装+飞书机器人全流程配置指南（附踩坑实录）

优质文章学习记录

— 9 min read

从零开始：OpenClaw 安装 + 飞书机器人全流程配置指南（附踩坑实录）

本文面向完全零基础的小白，手把手带你从一台干净的 Linux 机器开始，安装 OpenClaw、配置 AI 模型、对接飞书机器人，最终实现在飞书里和 AI 直接对话。全程附带我自己踩过的坑和解决方案。

目录

一、OpenClaw 是什么？

OpenClaw 是一个开源的 AI Agent 框架，简单理解就是：它让你拥有一个私人 AI 助手，可以接入飞书、Telegram、WhatsApp、Discord 等各种聊天平台。

它的核心架构很简单：

你的消息 → 飞书/Telegram/... → OpenClaw Gateway → AI 模型 → 回复

为什么选 OpenClaw？

  • 🔒 数据自托管，隐私可控
  • 🔌 支持多种聊天平台（飞书、Telegram、WhatsApp、Discord……）
  • 🧠 支持多种 AI 模型（Claude、GPT、Gemini……）
  • 🛠 可扩展的 Skill 系统，像安装 App 一样给 AI 加技能
  • 💻 完全开源免费

二、环境准备

2.1 系统要求

项目要求
操作系统Linux / macOS / Windows (WSL2)
Node.jsv22 或更高
网络能访问飞书开放平台 + AI API

2.2 安装 Node.js（如果还没装）

# 检查是否已安装node--version# 如果没有或版本太低，用 nvm 安装curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh |bashsource ~/.bashrc nvm install22 nvm use 22
💡 小白提示：输入 node --version 后如果显示 v22.x.x，说明安装成功。

三、安装 OpenClaw

3.1 一键安装

macOS / Linux：

curl-fsSL https://openclaw.ai/install.sh |bash

Windows (PowerShell)：

iwr-useb https://openclaw.ai/install.ps1 |iex

安装完成后验证：

openclaw --version

看到版本号（如 2026.3.2）就说明安装成功了。

3.2 手动安装（备选）

如果一键脚本有问题，也可以用 npm 安装：

npminstall-g openclaw
⚠️ 踩坑预警：如果遇到 EACCES: permission denied 错误，不要用 sudo npm install -g！正确做法是：

四、初始配置（onboard 向导）

安装完后，运行引导向导：

openclaw onboard --install-daemon

向导会引导你配置：

  1. AI 模型密钥 — 输入你的 Anthropic / OpenAI / Google API Key
  2. Gateway 设置 — 默认端口 18789，一般不用改
  3. 聊天渠道 — 这里先跳过，我们后面单独配飞书
💡 --install-daemon 参数会把 Gateway 安装为系统服务，开机自动启动。

配置完后检查 Gateway 状态：

openclaw gateway status

如果显示 running，基础安装就完成了 ✅

此时你已经可以通过 Web UI 聊天了：

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789，这就是 OpenClaw 的控制面板。

五、飞书机器人配置全流程

这是本文的重头戏。飞书机器人配置分 三大步：飞书侧建应用 → OpenClaw 侧配置 → 联调测试。

5.1 安装飞书插件

OpenClaw 的飞书支持是通过插件提供的，先安装：

openclaw plugins install @openclaw/feishu

安装完后重启 Gateway：

openclaw gateway restart

5.2 飞书开放平台：创建应用

Step 1：登录飞书开放平台

打开 https://open.feishu.cn/app，用你的飞书账号登录。

⚠️ 如果你用的是 Lark（国际版），地址是 https://open.larksuite.com/app。
Step 2：创建企业自建应用
  1. 点击 「创建企业自建应用」
  2. 填写应用名称（比如 “我的AI助手”）
  3. 填写应用描述
  4. 选一个图标
Step 3：获取凭证（重要！）

进入应用后，在 「凭证与基础信息」 页面，复制两个东西：

  • App ID（格式：cli_xxxxxxxxx）
  • App Secret
🔐 App Secret 务必妥善保管，不要泄露给任何人，不要提交到 Git。
Step 4：配置权限

进入 「权限管理」，点击 「批量开通」，粘贴以下 JSON：

{"scopes":{"tenant":["im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","contact:user.employee_id:readonly"],"user":["im:chat.access_event.bot_p2p_chat:read"]}}
💡 上面是最基本的权限集。如果后续需要操作飞书文档、多维表格等，可以追加更多权限（如 docx:document、bitable:app 等）。
Step 5：开启机器人能力

进入 「应用能力」→「机器人」：

  1. 开启机器人能力
  2. 设置机器人名称
Step 6：配置事件订阅（⚠️ 这步容易翻车！）

进入 「事件与回调」：

  1. 选择「使用长连接接收事件」（WebSocket 方式）
  2. 添加事件：搜索并勾选 im.message.receive_v1（接收消息 v1）
🚨 大坑警告：一定要选「长连接」而不是「Webhook」！长连接不需要公网 IP，不需要域名，不需要配置 HTTPS，对个人开发者友好得多。配置事件订阅之前，OpenClaw Gateway 必须在运行！ 否则飞书检测不到长连接端，可能导致保存失败。先跑 openclaw gateway status 确认 Gateway 在线，再来配这一步。
Step 7：发布应用
  1. 进入 「版本管理与发布」
  2. 创建一个版本
  3. 提交审核并发布
  4. 等待管理员审批（企业自建应用一般秒批）
⚠️ 不发布 = 不生效！ 很多人配完权限和机器人就以为搞定了，结果发消息没反应——因为应用还没发布。

5.3 OpenClaw 侧配置

方式一：交互式向导（推荐）
openclaw channels add

选择 Feishu，然后按提示输入 App ID 和 App Secret。

方式二：手动编辑配置文件

编辑 ~/.openclaw/openclaw.json，添加飞书配置：

{"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","accounts":{"main":{"appId":"cli_xxxxxxxxx","appSecret":"你的AppSecret"}}}}}

配置完后重启 Gateway：

openclaw gateway restart

5.4 首次联调

  1. 在飞书里找到你的机器人，发一条消息（比如 “你好”）
  2. 机器人会回复一个 配对码（Pairing Code）
  3. 在终端执行配对确认：
openclaw pairing approve feishu <配对码>
  1. 配对成功后，再次发消息，AI 就会正常回复了 🎉

六、踩坑实录 & 避坑指南

以下是我们实际配置过程中踩过的坑，排列按「痛苦指数」从高到低 😂

🕳️ 坑 1：事件订阅保存失败

现象：在飞书开放平台配置长连接事件订阅时，点保存没反应或报错。

原因：OpenClaw Gateway 没有在运行，飞书检测不到 WebSocket 连接。

解决：

# 先确保 Gateway 在跑 openclaw gateway start openclaw gateway status # 确认是 running# 然后再去飞书平台配置事件订阅

🕳️ 坑 2：机器人不回复消息

现象：飞书里发消息，机器人完全没反应。

排查清单（按顺序检查）：

  1. ✅ 应用有没有 发布？（最常见原因！）
  2. ✅ 事件订阅里有没有添加 im.message.receive_v1？
  3. ✅ 是否选择了 「长连接」 方式？
  4. ✅ 权限是否已经全部开通？
  5. ✅ Gateway 是否在运行？
# 实时查看日志，发消息后观察输出 openclaw logs --follow

🕳️ 坑 3：群聊里机器人不回复

现象：私聊正常，群聊里 @机器人 没反应。

原因：默认配置下，群聊需要 @mention 机器人才会响应。而且机器人必须被 添加到群里。

解决：

  1. 确认机器人已加入群聊
  2. 发消息时 @机器人
  3. 如果想不 @也能回复，修改配置：
{"channels":{"feishu":{"groups":{"oc_你的群ID":{"requireMention":false}}}}}
💡 群 ID 怎么获取？启动 Gateway 后在群里 @机器人，然后 openclaw logs --follow 里找 chat_id。

🕳️ 坑 4：权限不足导致各种奇怪问题

现象：消息发送失败、无法读取文件、操作飞书文档报错。

原因：飞书权限是细粒度的，缺什么权限就报什么错。

解决：回到飞书开放平台 → 权限管理，按需补充权限。常用的：

场景需要的权限
收发消息im:message, im:message:send_as_bot
读取群消息im:message.group_at_msg:readonly
操作文档docx:document, docx:document:readonly
操作多维表格bitable:app
云盘操作drive:drive, drive:file
⚠️ 添加新权限后，需要 重新发布应用版本 才能生效！

🕳️ 坑 5：配对码（Pairing）一直等不到

现象：发消息后机器人没有回复配对码。

原因：Gateway 没有成功连接飞书 WebSocket。

解决：

# 查看详细日志 openclaw logs --follow# 看看有没有 feishu 连接成功的日志# 如果有 error，根据错误信息排查（通常是 App ID/Secret 填错了）

🕳️ 坑 6：Node.js 版本太低

现象：安装 OpenClaw 报错，或启动后各种奇怪问题。

原因：OpenClaw 要求 Node.js 22+，很多系统默认装的是 18 或 20。

解决：

node--version# 检查版本 nvm install22# 升级到 22 nvm use 22 openclaw gateway restart # 重启

七、验证一切正常

跑完整个流程后，用这个清单逐项确认：

# 1. OpenClaw 安装正常 openclaw --version# 2. Gateway 在运行 openclaw gateway status # 3. 飞书插件已安装 openclaw plugins list # 应该能看到 @openclaw/feishu# 4. 飞书连接正常 openclaw status # 应该显示 feishu: connected# 5. 在飞书里发一条消息测试# → 收到 AI 回复 = 全部搞定 ✅

八、进阶：常用命令速查

命令用途
openclaw gateway status查看 Gateway 状态
openclaw gateway restart重启 Gateway
openclaw logs --follow实时查看日志
openclaw channels add添加聊天渠道
openclaw pairing list feishu查看飞书配对请求
openclaw pairing approve feishu <CODE>确认配对
openclaw dashboard打开 Web 控制面板
openclaw skills list查看已安装技能
openclaw doctor健康检查 + 快速修复

在飞书里可以发的命令

命令用途
/status查看机器人状态
/reset重置对话
/model查看/切换 AI 模型

写在最后

OpenClaw + 飞书机器人的配置确实有不少坑，但只要按照本文的流程走，应该能少走很多弯路。核心要记住的就是：

  1. 先装插件，后配飞书
  2. 先跑 Gateway，后配事件订阅
  3. 配完权限，别忘了发布应用
  4. 有问题先看日志：openclaw logs --follow

如果本文对你有帮助，欢迎点赞收藏 👍

有问题可以在评论区交流，也欢迎加入 OpenClaw Discord 社区 一起讨论。

本文基于 OpenClaw 2026.3.2 版本，飞书开放平台截至 2026 年 3 月。如有版本差异请以官方文档为准：https://docs.openclaw.ai

Read more

【FPGA入坑指南第二章】安装vivado/vitis2023.1软件

【FPGA入坑指南第二章】安装vivado/vitis2023.1软件

本栏目的初心 降低FPGA的门槛，让所有对FPGA感兴趣的，之前望而却步的朋友也能上手玩一玩，体验一下FPGA的世界。【本栏作者贯彻“先进入再深入”的中心思想】 引文 * AMD官方软件下载地址 vivado开发者工具 * 百度云下载包 Xilinx2023.1安装包「其他版本可以联系作者」 简介 Vivado和Vitis是Xilinx（现为AMD的一部分）推出的两款核心软件工具，它们在FPGA和SoC（系统级芯片）设计中占据着重要地位。这两款软件的推出代表了Xilinx在数字设计领域的持续创新与发展，并且逐步取代了早期的ISE和SDK工具套件。 ISE和SDK的历史背景 在Vivado和Vitis推出之前，Xilinx的ISE（Integrated Software Environment）是FPGA设计的主要开发环境。ISE主要用于Xilinx早期的FPGA系列，如Spartan和Virtex系列。ISE支持从RTL设计、综合、布局布线到生成比特流文件的整个设计流程，但其在时序优化、设计复杂度和开发效率方面逐渐暴露出一些局限性，尤其是对于更高端的FPGA系列和

无人机数据集汇总无人机航拍各个方面检测分割数据集合集

本数据集集合了面向无人机视觉任务的大规模、多场景、多目标标注数据资源，涵盖了地理环境、智慧城市、基础设施巡检、农业生产、公共安全与灾害监测等多个关键领域。数据主要以两种主流格式提供：适用于目标检测的VOC/YOLO格式与适用于像素级语义分割的LabelMe格式，为算法开发与模型训练提供了高度结构化的标注支持。 在地理与农业监测方面，包含田地、道路、森林、水体等地理要素的分割数据集，以及作物病害、杂草识别、农田农机、牛羊牲畜等农业目标的检测数据，支持精准农业与生态研究。智慧城市与交通领域提供了丰富的城市街道场景数据，涵盖行人、车辆、交通标志、占道经营、消防通道、广告牌等目标的检测与分割，助力城市智能化管理。基础设施巡检是另一重点，覆盖电力线、光伏板、桥梁、铁路、风力发电机等设备的缺陷与异常检测，以及工地车辆、施工人员、物料垃圾的识别，满足工业自动化巡检需求。在灾害与安全监控中，包含滑坡、洪水、火灾烟雾、河道垃圾、违规建筑等应急场景的检测与分割数据，同时提供了溺水人员、海上救援、军事目标等特殊任务的专项数据集。此外，

Project IceStorm：开源FPGA比特流逆向工程与开发工具套件

Project IceStorm：开源FPGA比特流逆向工程与开发工具套件 【免费下载链接】icestorm 项目地址: https://gitcode.com/gh_mirrors/ice/icestorm Project IceStorm是一个专注于Lattice iCE40 FPGA系列的开源逆向工程项目，通过深入解析比特流格式，为硬件开发者提供完整的FPGA开发工具链。该项目彻底改变了传统FPGA开发依赖商业工具链的局面，让开发者能够更深入地理解和控制FPGA的底层配置。 🔧 核心工具解析 比特流处理工具 icepack - 位图文件打包工具 位于 icepack/ 目录，负责将逻辑网表转换为FPGA可识别的比特流格式，实现设计到硬件的最终转换。 iceunpack - 比特流解包分析 能够逆向解析现有的比特流文件，提取其中的配置信息，帮助开发者理解FPGA内部资源的使用情况。 时序分析与优化 icetime - 时序分析与路径优化 位于 icetime/ 目录，提供详细的时序报告和路径延迟分析，确保设计满足时序约束要求。 硬件编程接口 iceprog

【无人机3D路径规划】基于改进蝙蝠优化算法的无人机3D路径规划研究附Matlab代码

✅作者简介：热爱科研的Matlab仿真开发者，擅长毕业设计辅导、数学建模、数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。 🍎 往期回顾关注个人主页：Matlab科研工作室  👇 关注我领取海量matlab电子书和数学建模资料  🍊个人信条：格物致知,完整Matlab代码获取及仿真咨询内容私信。 🔥 内容介绍  一、引言 在当今科技飞速发展的时代，无人机在众多领域得到了广泛应用，从物流配送、农业监测到航空测绘等。在这些应用场景中，无人机需要在三维空间中规划出一条安全、高效的飞行路径，以完成各种任务。传统的路径规划算法在处理复杂的 3D 环境时，往往存在收敛速度慢、易陷入局部最优等问题。蝙蝠优化算法（Bat Algorithm，BA）作为一种新兴的智能优化算法，模拟了蝙蝠的回声定位行为，为解决此类问题提供了新的思路。然而，标准的蝙蝠优化算法也有其局限性，因此本文聚焦于基于改进蝙蝠优化算法的无人机 3D 路径规划研究，旨在提升路径规划的性能。 二、蝙蝠优化算法基础 1. 蝙蝠回声定位模拟：蝙蝠在飞行过程中通过发出超声波，并根据回声来感知周围环