OpenClaw对接飞书Q&A

2026-05-06阅读 0热度 0

后端人工智能服务器

在树莓派Debian系统上部署OpenClaw及飞书对接指南

今天咱们聊聊在树莓派（Raspberry Pi）的Debian系统环境里，部署OpenClaw并成功对接飞书机器人的完整过程。过程中会遇到几个典型的“坑”，别担心，咱们一个一个踩平它。

第一步：基础环境与安装

官方推荐的安装命令很简单：npm -i g openclaw。但先别急着执行，环境准备才是关键。

第二步：解决Node.js版本问题

第一个拦路虎通常是Node.js版本。很多系统默认搭载的是Node 20，但OpenClaw要求版本不低于22。这时候，我们需要请出Node版本管理的神器——nvm。

依次执行下面这组命令，就能把环境搞定：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22

完成后，别忘了用 node -v 和 npm -v 验证一下版本，确保已经切换成功。

第三步：处理网关报错

安装完成后启动，你很可能会遇到一个报错：“找不到 openclaw-gateway.services”。别慌，这只是意味着网关服务没有正常启动。解决方案很直接：运行命令启动OpenClaw网关即可。

第四步：配置访问令牌

当你第一次在浏览器里打开OpenClaw的URL时，页面可能会冷冰冰地提示你“unauthorized: gateway token missing”。这说明访问令牌缺失了。

解决方法就在终端里输入这条命令：

openclaw dashboard --no-open

执行后，命令行会显示出Dashboard的访问URL，里面就包含了所需的令牌信息。

第五步：飞书应用权限配置（关键步骤）

要想让OpenClaw和飞书顺畅对话，在飞书开放平台创建应用时，必须导入下面这一整套权限。这可是对接成功的“通行证”，一个都不能少：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

第六步：完成飞书用户配对

一切配置就绪，在飞书里首次给你的机器人发送消息时，可能会收到这样一段回复：

OpenClaw: access not configured. Your Feishu user id: Pairing code: Ask the bot owner to approve with:
openclaw pairing approve feishu XXXXXXXX

这其实是安全机制在发挥作用。你只需要原封不动地，在运行OpenClaw的终端里执行回复信息末尾提供的那条openclaw pairing approve feishu XXXXXXXX命令，就能完成用户授权配对了。

参考文档

如果在部署中还想深入了解细节，下面这几篇文档会很有帮助：

安装教程
https://cloud.tencent.com/developer/article/2626160

对接飞书
https://ecloud.10086.cn/op-help-center/doc/article/98177
https://www.feishu.cn/content/article/7602519239445974205

整个过程梳理下来，其实就像解一道有序的谜题。按照这个步骤走，从环境准备到最终对话打通，树莓派上的OpenClaw机器人就能顺利在飞书里活蹦乱跳了。