OpenClaw 新手保姆级安装配置指南：从零开始，连接飞书

欢迎来到 OpenClaw！本文将手把手带你完成从环境准备、软件安装到连接飞书的全过程，让你快速上手这个强大的自动化工具。

官方文档：https://docs.openclaw.ai

📋 一、准备工作（前置条件）

在开始之前，请确保你的电脑满足以下条件：

• Node.js 环境：版本必须 >= 22。
• 包管理器：推荐安装 pnpm，如果你计划从源代码构建。
• API 密钥（可选但推荐）：如果你想使用联网搜索功能，可以准备一个 Brave Search API 密钥。配置方法很简单：openclaw configure --section web。
• 操作系统提示：
  • macOS：如果仅使用命令行和网关功能，Node.js 足够。若要构建桌面应用，需安装 Xcode 或 Command Line Tools。
  • Windows：强烈推荐使用 WSL2（建议 Ubuntu）。原生 Windows 环境未经充分测试，可能会遇到更多兼容性问题。请先安装 WSL2，然后在 WSL 内部进行以下所有操作。

🛠️ 二、安装 OpenClaw CLI

本次教程我们将使用 VS Code 进行演示。首先，打开 VS Code 的终端

1. 检查 Node.js 版本

在终端输入以下命令，确认 Node 版本在 22 或以上：

node -v

如果版本过低，请先更新或切换 Node 版本。

检查Node版本

2. 安装 CLI 工具

这里我们使用 npm 进行全局安装（这是最直接的方式）：

npm install -g openclaw@latest

npm安装过程

看到安装成功的提示后，说明 CLI 已经安装好了。

其他安装方式（供参考）：

• 一键脚本 (macOS/Linux)：curl -fsSL https://openclaw.ai/install.sh | bash
• PowerShell (Windows)：iwr -useb https://openclaw.ai/install.ps1 | iex
• pnpm：pnpm add -g openclaw@latest

3. 验证安装

运行以下命令，如果能正常显示版本号或帮助信息，则表示安装成功。

openclaw --version
# 或
openclaw -h

验证安装

(可选) 查看安装位置：

which openclaw
npm list -g --depth=0

🚀 三、快速启动与配置向导

这是最关键的一步，OpenClaw 提供了一个交互式向导来帮你完成初始设置。

在终端中执行以下命令开始配置：

openclaw onboard

接下来，跟着向导一步步操作：

1. 风险确认：你会看到一句提示 I understand this is powerful and inherently risky. Continue?，直接输入 Yes 并回车。这是因为 OpenClaw 可以操作你的电脑，需要你明确授权。

风险确认

1. 选择模式：选择 QuickStart，它将自动帮你配置好大部分默认设置，对新手最友好。

选择快速启动

1. 配置 AI 模型：OpenClaw 需要一个“聪明的大脑”（大语言模型）来理解你的指令。这里你可以：
   • Model/auth provider：选择你希望使用的模型供应商。如果你还没有 API Key，可以先选择 “Skip for now” 跳过，后续在网页界面配置也一样方便。
   • Filter models by provider：同样，可以先选择 “All providers” 或直接跳过。

小贴士：即使没有 API Key，也可以先完成向导，我们后续会介绍如何配置。

跳过模型配置

选择所有供应商

跳过具体模型选择

1. 配置通信渠道：问你想通过什么软件和它聊天，比如 Telegram、飞书。第一次尝试，建议选择 “Skip for now” 跳过，我们先使用它自带的网页版界面。

跳过渠道配置

1. 配置技能（Skills）：是否现在添加特定技能？同样，先选 “No” 跳过。

跳过技能配置

1. 配置钩子（Hooks）：这是高级功能，用于在启动时加载文档、记录日志等。直接选择 “Skip for now” 并回车。

选择跳过钩子

稍等片刻，看到完成界面，向导就成功结束了！

向导完成

🌐 四、链接ai的api

1️⃣ 获取 API Key

拿到你自己 的api key的值

2️⃣ 运行配置向导

openclaw onboard

在这里插入图片描述

3️⃣ 关键选项选择

当出现以下选项时，按图示选择：

第 1 步 Model/auth provider 选择你的ai

在这里插入图片描述

2.Enter Moonshot API Key 粘贴你刚才复制的 API Key

在这里插入图片描述

按你之前习惯选，或者全跳过

💬 五、进阶配置：连接飞书机器人

想让你的 OpenClaw 接入飞书，成为团队里的智能助手吗？跟着下面的步骤来配置吧。

第一部分：飞书开发者后台配置

1. 登录并进入开发者后台
   • 访问 飞书开放平台 并登录你的账号。
   • 点击右上角的头像，选择「开发者后台」。

进入开发者后台

1. 创建企业自建应用
   • 点击「创建应用」->「企业自建应用」。

创建企业自建应用

• 填写应用名称和描述，然后点击「创建」。

填写应用信息

1. 添加机器人能力
   • 创建成功后，在应用详情页找到「添加能力」卡片，点击「机器人」。

添加机器人

1. 配置权限
   • 点击左侧菜单的「权限管理」。
   • 在搜索框中输入 im:，然后将出现的所有权限全部勾选，点击「批量开通」。

搜索并勾选IM权限

勾选所有IM权限

确认开通

• （重要） 再次搜索「通讯录」，找到「通过手机号或邮箱获取用户ID信息」这个权限，也点击开通。这能让机器人知道是谁在和它说话。

1. 发布第一个版本
2. 点击左侧菜单的「版本管理与发布」。
3. 点击「创建版本」，填写版本号（如 1.0.0）和更新说明，然后点击「保存」。 - 保存后，点击「确认发布」。

创建版本

填写版本信息

确认发布

发布需要管理员审核，通常很快，也可以自己审核自己。

第二部分：在 OpenClaw CLI 中连接飞书

1. 进入配置面板
2. 回到 VS Code 终端，输入以下命令：openclaw config
3. 选择 local（本地配置）。

进入配置面板

1. 配置通信渠道
2. 选择 Channels -> Link 添加新渠道。
3. 选择 feishu。

选择飞书渠道

添加飞书

1. 安装渠道插件
2. 系统检测到缺少飞书插件，选择 Install 进行安装。安装完成后，按 Enter 键继续。

安装飞书插件

1. 填写飞书应用凭证
2. 不要关闭终端！ 现在回到飞书开发者后台，找到你的应用。
3. 点击左侧菜单的「凭证与基础信息」。
4. 分别复制 App ID 和 App Secret 到终端中粘贴。

复制App Secret和ID

粘贴App Secret

粘贴App ID

1. 完成后续配置
2. Endpoint type：选择 im（实时通讯）。
3. Environment：根据你的飞书版本选择 国内 或 国际。
4. Allow group chat：是否允许群聊使用，选择 open。
5. 看到 finished 选项，选择它完成渠道配置。
6. 之后会询问是否配置私聊访问策略，新手可以先选择 No 跳过。

选择Endpoint和Environment

完成配置

跳过私聊策略

1. 保存并退出
2. 一直按 Esc 或选择 Finish 退出配置面板。

退出配置

第三部分：飞书后台最终配置与测试

1. 确保网关已启动 openclaw gateway start
2. 在终端中，确保 OpenClaw 的网关服务正在运行。如果没有，请启动它：
3. 设置飞书事件订阅方式
   • 回到飞书开发者后台，点击左侧菜单的「事件与回调」。
   • 在「订阅方式」卡片中，点击「修改」，将方式改为 「长连接」，点击「确认」。OpenClaw 会通过长连接与飞书通信，无需公网地址。

修改订阅方式

选择长连接

1. 添加消息接收事件
   • 在「事件与回调」页面下方，点击「添加事件」。
   • 搜索并选择 接收消息 事件（im.message.receive_v1），然后点击「确认添加」。

添加接收消息事件

1. 再次发布版本
   • 权限和事件都配置好了，需要再次发布一个新版本才能生效。回到「版本管理与发布」，创建一个新版本（如 1.0.1）并发布。

再次发布版本

1. 测试连接
   • 现在，去飞书客户端，找到你刚刚创建的这个机器人，给它发送一条消息，比如“hello”。如果一切顺利，你应该能收到 OpenClaw 的回复！

在这里插入图片描述

恭喜！你已经成功地将 OpenClaw 接入飞书，可以开始探索它的更多强大功能了。祝你使用愉快！

您好，我是肥晨。

欢迎关注我获取前端学习资源，日常分享技术变革，生存法则；行业内幕，洞察先机。