代码改变世界

老大爷都在养龙虾了!小白3分钟本地装 OpenClaw + 飞书打通全攻略(零基础必看)

2026-03-09 10:16  狼人:-)  阅读(1130)  评论(0)    收藏  举报

在我的印象中,好像还没有哪个软件,像 OpenClaw 这样用这么快的速度,覆盖了这么多的人群。

现在你去各个各个社区,大家组织线下活动只要是讨论 OpenClaw 的,现场都是这样子的。

 

 

北京、深圳很多城市,甚至在街道上摆起了大桌子,免费帮助市民在电脑上安装 小龙虾, 甚至很多大妈、大爷也在其中。

 

 

然后我的很多读者,也在着急的问到底如何安装小龙虾,今天给大家写一份小白从 0 入手的图文教程。(写的比较着急错别字比较多,懒得改了)

说实话,整体安装确实蛮复杂的,并且现在小龙虾并不稳定,肯定会出现各种各样的小问题。

但只要一比一按照我这个教程走下来,基本上没问题。(以 Mac 系统为例,Win 参考流程)

当然了,如果你不想看整个细节,等用的时候在看,直接拉到文末加微信进群,我这个文档都放在群公告了。

 

 

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

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、接入飞书-机器人

登录飞书开放平台 ,登录后进入开发者后台 创建应用。

 

 

  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,先跳过

选择之后,就安装完了,

本地会跳出  这个地址,弹出了一个 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