整体的安装分为几大部分：

1、系统要求

2、命令安装

3、创建 API key

4、接入飞书-机器人

5、安装 Skills

6、配置飞书回调

话不多说，我们正式开始，我们用图文的形式，带着大家一步一步的走一遍，内容比较长建议收藏。

1、系统要求

在 macOS 12 及以上系统 的 Mac 电脑上，只要安装好 Node.js 20+、Git 和 Homebrew，基本就可以正常安装和运行 OpenClaw（推荐 M 系列芯片 + 16GB 内存 体验更好）。

相关安装命令如下：

brew install node

2、命令安装

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

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

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

默认回车，选择快速安装。

提示你选择使用哪个大模型，上下键可以选择不同的大模型，回车就是选中具体的模型。

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

3 、创建 API key

可以看到国内的很多大模型 API 都在其中，比如 MiniMax\Qwen\Qianfan\Kimi\Z.AI(智谱），因为智谱给的免费额度比较高，我们演示用智谱来继续。

智谱的官网如下，注册后，打开这个地址：

https://bigmodel.cn/usercenter/proj-mgmt/apikeys

创建一个小龙虾1的项目，专业系统会自动一个 API key ，右侧有一个复制的按钮，点击复制就可以拿到完整的 API key 了。

接着上一步，根据提示选择模型Z.AI(就是智谱），选择不同的 Method，选择输入 API key

复制到命令行即可。

选择glm-4.7，继续往下走。

接下来让你选择接入的社交软件，支持 Telegram\飞书 等各种软件，我们这里以飞书为例。

4、接入飞书-机器人

登录飞书开放平台 https://open.feishu.cn/，登录后进入开发者后台 创建应用。

  1. 在左侧目录树选择“应用能力 > 添加应用能力”。
  2. 选择“按能力添加”页签，单击“机器人”能力卡片的“添加”按钮

添加完成以后就会多一个菜单，叫：机器人。

配置权限。

在左侧目录树选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。

在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message.send_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

在弹窗中确认权限无误后，单击“申请开通”按钮，完成操作。

弹出了一个确认界面，点击确认。

发布应用。

单击顶部的“创建版本”按钮。

按需配置应用版本号、默认能力及更新说明等信息。

单击页面底部的“保存”按钮，创建版本。单击页面右上角的“确认发布”按钮，完成应用发布。

获取配置信息。

  1. 在左侧目录树选择“基础信息 > 凭证与基础信息”。
  2. 在“应用凭证”模块中，获取并记录App ID与App Secret信息。

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

安装插件

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

一路按照提示往下走。

5、安装 Skills

接下来，让你选择哪个 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 安装成功了。

然后就可以愉快的，在网页端和你的小龙虾聊天了，让它成为你真正的 Ai 数字助手！

6、配置飞书回调

接下来还有最后一步，配置飞书的回调，这样我们才可以在手机上，直接指挥我们的小龙虾干活。

事件回调设置

点击左侧菜单 事件与回调 ，在事件配置中设置订阅方式，使用长连接

点击右侧 添加事件

添加接收消息事件

设置回调配置

到这里配置已经完成，需要进行发布版本。

配置完成后，你就可以在飞书上和你的小龙虾愉快的交流了，手机端更方便一些。

以上所有的安装教程就算结束了，有几个常见问题，如果大家遇到也可以按照下发方式来解决。

常见问题：

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

这个提示是说 你请求 API 的次数已经达到上限，所以当前无法继续访问服务。大概率是 API 模型没有钱了。

2 、报错：OpenClaw: access not configured.

如果报错：

Your Feishu user id: ou_16xxx

说明你的 OpenClaw 已经成功“接头”了，但由于它有一套严格的安全权限体系，作为管理员，你需要给你的飞书账号授权。

别担心，这正是 OpenClaw 安全的地方——防止随便谁加了你的机器人都能调包你的 AI 算力。

你只需要在你的 Mac 终端（Terminal） 里复制并运行下面这条命令：

openclaw pairing approve feishu 7xLxxx
正文到此结束
  • 本文作者：xinyu.he
  • 文章标题：老大爷都在养龙虾了！本地装 OpenClaw + 飞书
  • 本文地址：https://www.hxy.bj.cn/archives/803/
  • 版权说明：若无注明，本文皆Xinyu.he blog原创，转载请保留文章出处。
最后修改：2026 年 03 月 09 日
© 允许规范转载
如果觉得我的文章对你有用，请随意赞赏