3 分钟本地安装 OpenClaw，接入飞书机器人完整教程

大家好，今天分享一篇适合新手的小白教程：如何在本地安装 OpenClaw，并打通飞书机器人，实现用飞书直接调用你的 AI 助手。

整套流程并不算特别简单，但只要按照步骤一步一步操作，基本都能完成。本文默认以 Mac 为例，Windows 用户也可以参考同样思路进行配置。

本次安装主要分为 6 个步骤：

1. 1.检查系统和网络环境
   
2. 2.安装 OpenClaw
   
3. 3.创建大模型 API Key
   
4. 4.接入飞书机器人
   
5. 5.安装 Skills
   
6. 6.配置飞书事件回调
   

完成后，你可以在本地网页中使用 OpenClaw，也可以直接在飞书里和机器人聊天，让它帮你处理任务。

在 macOS 12 及以上系统中，只要提前安装好以下环境，基本就可以正常运行 OpenClaw：

• •Node.js 20+
  
• •Git
  
• •Homebrew
  

推荐配置：

• •Apple M 系列芯片
  
• •16GB 内存及以上
  

安装命令如下：

代码块Plain Text复制

打开终端，执行以下命令：

代码块Plain Text复制curl -fsSL https://openclaw.ai/install.sh | bash

安装过程中会出现几个常见提示：

1. 是否继续安装

如果提示：

默认这是给“个人使用”的环境，如果要多人共用，需要额外做安全加固。是否继续？

直接选：Yes

2. 安装模式选择

一般直接回车，选择快速安装即可。

3. 选择大模型

系统会提示你选择使用哪个大模型，可以用方向键选择。

翻到最后一个是 Skip for now ，意思是先跳过这一步，后面再添加也可以。

安装时需要接入一个大模型服务。教程里演示的是 智谱 Z.AI，因为它的免费额度相对友好，适合新手上手。
智谱的官网如下，注册后，打开这个地址：

https://www.bigmodel.cn/glm-coding?ic=ZEUNUEMFWZ

进入智谱开放平台后：

1. 1.注册并登录平台
   
2. 2.创建一个项目
   
3. 3.进入 API Key 页面
   
4. 4.复制生成的 API Key
   

API Key 页面地址：

回到终端后，按照提示：

1. 1.选择模型提供商（例如 Z.AI / 智谱）
   
2. 2.选择接入方式 Method
   
3. 3.粘贴你的 API Key
   
4. 4.选择模型，例如：
   

完成后继续下一步。

接下来开始配置飞书。

第一步：登录飞书开放平台

打开飞书开放平台：

https://open.feishu.cn/

进入开发者后台，创建一个应用。

第二步：添加机器人能力

在左侧菜单中进入：应用能力 → 添加应用能力

选择：按能力添加 → 机器人 → 添加

添加成功后，左侧菜单里会出现“机器人”相关配置项。

在左侧菜单进入：开发配置 → 权限管理

然后点击：批量导入 / 导出权限

在“导入”页签中，导入所需权限配置。教程里给的是一整段权限 JSON，建议你在实际发文时单独放成附件，或者放在文末代码块中，避免正文过长。

如果你想在教程里保留这段，可以写成下面这样：

代码块Plain Text复制{  "scopes": {    "tenant": [      "contact:contact.base:readonly",

导入后，点击：

1. 1.下一步，确认新增权限
   
2. 2.申请开通
   
3. 3.在弹窗中确认
   

权限配置完成后，需要发布应用，否则机器人无法正常使用。

操作步骤：

1. 1.点击顶部 创建版本
   

1. 2.填写版本号、更新说明等信息
   

1. 3.点击 保存
   
2. 4.再点击右上角 确认发布
   

发布完成后，进入：

基础信息 → 凭证与基础信息

记录以下两个参数：

• •App ID
  
• •App Secret
  

后面安装过程中会用到。

接着刚才的流程，选择飞书

安装插件

提示输入，创建好的飞书 App ID 和 App Secret

接下来，让你选择哪个 Skills ，按上下键点击空格是选择，提交是 enter 键。

我这里只选择了 Github

后面还会提示安装一堆美国大厂的相关 Key ，直接 选择 NO 即可。

选择 Skip for now
接下来到这个界面：

这个界面是在问你“你想怎么启动（hatch）你的机器人（bot）？”。意思是你现在配置好 了 bot，要选择一个方式让它运行或访问。
具体选项解释如下：
TUI = Text User Interface，即命令行交互界面
Open the Web UI启动后会打开一个网页界面来操作
bot Do this later 不立即启动 bot，先跳过
选择之后，就安装完了，
本 地 会 跳 出 http://127.0.0.1:18789/chat?session=main 这 个 地 址 ， 弹 出 了 一 个 Web 页面，就意味着 本地 Mac 的 Openclaw 安装成功了。

接下来还有最后一步，配置飞书的回调，这样我们才可以在手机上，直接指挥我们的小龙 虾干活。
事件回调设置
点击左侧菜单 事件与回调 ，在事件配置中设置订阅方式，使用长连接：

点击右侧 添加事件

添加接收消息事件

设置回调配置

到这里配置已经完成，需要进行发布版本。
配置完成后，你就可以在飞书上和你的小龙虾愉快的交流了，手机端更方便一些。

1. 提示：API rate limit reached. Please try again later.

这个报错一般表示：

• •API 调用次数达到上限
  
• •或者模型账户额度不足
  

解决方法：

• •检查模型平台账户余额
  
• •更换一个还有额度的模型
  
• •稍后重试
  

2. 报错：OpenClaw: access not configured

代码块Plain Text复制Your Feishu user id: ou_16xxx

说明你的 OpenClaw 已经成功“接头”了，但由于它有一套严格的安全权限体系，作为管理员，你需要给你的飞书账号授权。
别担心，这正是 OpenClaw 安全的地方——防止随便谁加了你的机器人都能调包你的 AI 算力。
你只需要在你的 Mac 终端（Terminal） 里复制并运行下面这条命令：

代码块Plain Text复制

到这里，OpenClaw 本地安装 + 飞书打通的完整流程就结束了。

简单总结一下，你最终会获得两个使用入口：

• •本地 Web 页面
  
• •飞书机器人
  

这样你既可以在电脑上使用，也可以直接在手机飞书里随时调用你的 AI 助手，让它帮你处理消息、自动化任务和日常工作。

如果你是第一次配置，建议按本文顺序一步一步操作，不要跳步骤。