OpenClaw安装教程：本地部署+飞书机器人对接 附报错解决+模型替换

我就不废话了，直接开搞~~

环境准备

下载安装Node.js

我们需要下载的Node.js版本必须为v22.0.0或更高~

官网地址

nodejs.org/zh-cn

如图

这里我们直接点击绿色的Windows 安装程序 (.msi)，这是最省事的方式，无需 Docker

如图

双击安装包一路下一步即可完成 Node.js 部署!

如图

安装这个基本上就注意一下安装路径，其他的都是傻瓜式下一步即可

如图

安装完成之后，我们使用快捷键Ctrl + Win快捷键， 在命令行中直接输入以下命令

node -v

出现以下提示说明你的node.js环境已经安装完成~

如图

注意:这里我还是建议大家检查一下自己系统中的环境变量, 确保把node.js配置到环境变量中

如图

下载安装Git

OpenClaw安装需要Git，所以我们还需要Git工具，安装好之后才能执行后面的操作~

否则你安装OpenClaw的时候可能就会出现类似于这样的错误~

官网下载

git-scm.com/download/wi...

跟之前一样，根据提示傻瓜式安装即可

如图

主要就是注意一下安装路径，自己定义

如图

其他选项基本上默认就行了, 最后开始安装!

如图

最后直接按 Win + R 输入 powershell

输入 git --version 回车，能显示 git 版本号就说明安装成功了

如图

安装OpenClaw

终于到了我们的主角了~

官网

openclaw.ai/

这里我们就采用Windows (PowerShell)安装方式!

根据官网在Windows系统中的执行命令如下:

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

详细参考: docs.openclaw.ai/zh-CN/start...

这是 PowerShell 专属的命令，cmd里跑不了，大家打开PowerShell 执行就行了

当然如果想在cmd里操作，也可以先输入 powershell 回车切换到PowerShell环境，再执行上面这个安装命令，效果一样～

报错解决方案

注意:

Windows PowerShell 的执行策略限制，默认不允许运行未签名的脚本，可能会导致 OpenClaw安装脚本无法执行。

报这样的错误~

如图

所以我们要在管理员身份的PowerShell中执行以下命令，临时放宽执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这里我就直接按 Win + Q 输入 powershell 回车,以管理员形式打开powershell

如图

然后执行以下上面的命令

如图

在这个提示后面输入Y然后回车，确认更改执行策略，之后就能继续安装OpenClaw

到这里我们再来执行以下安装命令!

切换国内镜像

这里为了杜绝一些网络问题，我个人建议切换国内镜像（避免网络下载失败）

npm config set registry https://registry.npmmirror.com

如图

执行安装命令

然后再执行OpenClaw安装脚本

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

等待安装完成，期间不要关闭 PowerShell 窗口~

如图

默认参数配置

等待一会要进入配置选项

这一步是OpenClaw在跟你交底,它现在是个人用的 AI 助手，默认只信任你一个人，不会随便给别人权限

在光标那里输入 Yes，按回车就行

然后提示如下:

用键盘上下方向键 ↓ 把光标移到QuickStart，然后按 回车 Enter 确认

如图

这里用同样方向键选中Skip for now，按回车 先跳过配置，后续用命令再填飞书API

如图

继续用方向键↑/↓找到并选中All providers，按回车

这一步是筛选模型来源, 我们选All providers会显示所有可用模型，避免漏掉你后续要配置的目标选项~

如图

然后继续用方向键选中 Keep current (default: anthropic/claude-opus-4-6)，然后按回车确认，直接用默认模型即可

如图

继续用方向键选中 Feishu/Lark(飞书)然后按回车确认，这是我们要对接的目标平台~

如图

继续用方向键选中Use local plugin path（本地插件路径），然后按回车确认

如图

到了这里 我们就可以先暂停一下了

配置选项会提示我们先去飞书开放平台 申请App ID 和 App Secret

如图

这个窗口你可以先不要关闭~

飞书配置

注册飞书账号

没有飞书账号的朋友自行去免费注册一个即可~

www.feishu.cn/accounts/pa...

如图

创建应用

然后接下来这一步是让 OpenClaw 对接你的飞书账号，需要你先在飞书开放平台创建应用并获取凭证~

接入地址

open.feishu.cn/app

好了，不废话了，我们直接开始~ 点击 创建企业自建应用

如图

然后继续填写应用名称, 比如 OpenClaw智能管家 和描述，点击"确定创建

如图

获取App ID和App Secret

创建好之后，进入凭证与基础信息页面，我们就可以看到App ID和App Secret了

把它们复制保存下来~

注意:千万别泄露出去，否则后果自负~

如图

添加机器人

然后在：左侧菜单的 添加应用能力 → 选择 机器人 并添加开启

如图

效果如图

批量开启权限

然后继续配置一下权限, 左侧菜单点击权限管理

找到批量导入

如图

复制以下这段json代码

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.id:readonly",
      "contact:contact.base:readonly",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:read",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "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.urgent",
      "im:message.urgent.status:write",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:url_preview.update",
      "im:user_agent:read",
      "passport:session_mask:readonly"
    ],
    "user": []
  }
}

直接粘贴进去~

如图

点击申请开通

如图

现在这些杂七杂八的权限就都已开通~

如图

版本管理与发布

接着我们可以创建版本并发布~

左侧导航栏找到版本管理与发布，点击进入, 继续点击右上角的创建版本

如图

应用版本号，这里以1.0.0为例，我们可以自行定义版本号以及描述说明，点击保存并确认发布

如图

等待飞书通过发布审核

如图

审核发布成功后，可以在版本管理与发布页面，查看到已经发布的版本号和状态

如图

配置事件回调

然后继续，我们还需要配置一下事件回调~

目的是为了我们给机器人发消息的时候，要通知OpenClaw 操作也很简单~

左侧菜单点击事件与回调, 右侧点击订阅方式旁边的这个笔

如图

选择使用长连接接收事件， 其实背后的原理也就是WebSocket长连接模式

如图

但是这里你点击保存可能会报错~

如图

OpenClaw配置飞书

那是因为我们还没有去OpenClaw那边还没配置飞书的App ID和App Secret

所以这里一步我们要回到刚刚保留的PowerShell窗口

然后在这里把App ID 和 App Secret 输入进去

如图

然后直接按回车确认默认的 WebSocket (default)连接模式， 同时选择China

如图

继续选择Open - respond in all groups (requires mention)

如图

用方向键选中Skip for now，按回车跳过网络搜索配置，先把核心功能跑通

如图

用方向键选中No，按回车跳过技能配置，先完成基础安装

如图

用方向键选中Skip for now，按回车确认，先跳过 Hooks 配置

先按一下 空格键 选中Skip for now，然后按 回车提交，就跳过了!

如图

最后OpenClaw就已经成功启动并连上飞书的运行日志窗口 `

注意: 这个小黑屏窗口是 OpenClaw 的网关服务，必须保持打开才能让飞书机器人持续运行

还有一步，刚刚我们在事件回调中，不能点击保存，现在就赶紧去点击保存吧~

如图

启动 OpenClaw

修改默认模型

可能刚开始你启动OpenClaw会出现这种错误信息

如图

那么这种问题的原因是OpenClaw 找不到相关模型的API Key，所以无法调用模型生成回复~

还记得吗？前面我们在配置的时候选择的是这个默认模型

但是这个默认模型是收费的Claude，你没密钥，所以直接用不起，必须换成其他能使用的模型来代替一下~

当然你都可以把默认模型换成OpenAI 或其他你有Key的模型，那都是可以的!

如图

这里我们为了把OpenClaw跑起来， 可以先用一个有免费额度的模型!

在 PowerShell 里直接运行：

openclaw configure

回车，继续选择Local (this machine) 再回车

如图

选择Model

这里我以 千问大模型为例

如图

然后浏览器会打开，让我们登录一下千问账号

如图

再次返回到命令行窗口，

直接选 qwen-portal/coder-model，按空格勾选，回车确认！

这个就是你阿里云百炼的通义千问模型，直接用！回车

如图

把光标移到最下面的 Continue，按回车

如图

启动OpenClaw

最后执行以下命令

openclaw gateway

在浏览器中输入以下地址:

 http://127.0.0.1:18789/

现在我们终于可以开始虐待这个小龙虾AI了，，哈哈哈

如图

飞书客户端接入OpenClaw AI

最后我们还要来配置一下飞书整合OpenClaw

核心就是把OpenClaw网关作为后端，让飞书机器人能接收消息、触发配对授权、

在飞书里直接调用OpenClaw能力!

添加事件

首先打开飞书后台管理，来到事件与回调, 点击添加事件

如图

然后在搜索栏中 搜索关键字:im.message.receive_v1, 并且勾选接收消息, 点击`添加``

``如图`

然后发布一下新版本

如图

客户端配置

继续...在电脑端打开飞书, 搜索你的机器人名称~ 比如: 我这里叫 : OpenClaw智能管家

如图

对接配对码

尝试直接发一条消息~

此时，我们就可以得到一个配对码

如图

注意:如果没有看到消息回复，可以稍等一会再发,或者按照以下步骤来排查问题

飞书开放平台 → 你的应用 → 权限管理
事件与回调 → 事件订阅
确认订阅了 im.message.receive_v1 事件，且订阅方式是「长连接」，不是「HTTPS 推送」，并且已经发布版本。
应用发布状态
确认应用已经发布到「测试环境」或「正式环境」，不是「草稿状态」------ 草稿状态下机器人发不出消息。

然后去终端执行以下这个配对码

openclaw pairing approve feishu <配对码>

如图

最后 对接成功✅

✅ 配对成功了！我们的飞书账号已经被 OpenClaw 网关批准了

现在你再去飞书客户端发消息，机器人就会正常回复了，整个飞书接入流程彻底跑通了！🎉

如图

到此我们的OpenClaw已成功部署并完成飞书集成，能正常接收指令并执行操作，安装运行成功!