跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Jetson + OpenClaw + 飞书机器人:构建边缘设备 AI Agent 远程交互系统

综述由AI生成记录了在 Jetson ARM64 环境下部署 OpenClaw 并接入飞书机器人的完整流程。主要步骤包括安装 Node.js 与 pnpm、解决 CMake 版本兼容性问题、配置模型 API 及 Gateway Token、启动服务以及配置飞书应用权限与回调。文章重点解决了 Jetson 编译依赖、环境变量配置、Token 认证匹配及飞书应用发布等常见坑点,实现了通过飞书群聊或私聊调用本地 AI Agent 的功能。

星辰大海发布于 2026/4/6更新于 2026/5/2231 浏览
Jetson + OpenClaw + 飞书机器人:构建边缘设备 AI Agent 远程交互系统

1. 背景

本文旨在在 Jetson 上部署本地 OpenClaw,并通过飞书机器人进行远程交互,实现闲置边缘设备作为 AI 助手的功能。整体目标如下:

  • 在 Jetson 上运行 OpenClaw
  • 接入模型 API(如阿里云百炼)
  • 通过飞书群聊 @机器人 或私聊直接调用本地 Agent

工作流如下:

Feishu Group -> Feishu Bot -> OpenClaw Gateway (Jetson) -> Agent -> LLM API -> 返回飞书消息 

2. 环境信息

Jetson 环境
uname -a
lsb_release -a
nvcc --version

当前平台配置:

  • Jetson ARM64
  • Ubuntu 20.04
  • CUDA 11.4

注意:ARM64 + Ubuntu 20.04 环境下可能存在额外的依赖兼容性问题。

3. 安装 Node.js 与 pnpm

OpenClaw 是 Node.js 项目,需准备 Node 环境。

建议使用 Node 20。

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc

# 配置镜像加速(可选)
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

# 安装并使用 Node.js 20
nvm install 20
nvm use 20
nvm alias default 20

# 配置 npm 镜像加速
npm config set registry https://registry.npmmirror.com

# 验证安装
node --version
npm --version

安装 pnpm:

npm install -g pnpm
pnpm -v

4. 配置 pnpm 环境变量

将以下内容加入 ~/.bashrc:

export PNPM_HOME="/home/user/.local/share/pnpm"
case ":$PATH:" in
  *":$PNPM_HOME:*") ;;
  *)  PATH= ;;

export
"$PNPM_HOME:$PATH"
esac

保存后执行 source ~/.bashrc 并验证:

echo $PNPM_HOME
which pnpm

5. 克隆 OpenClaw 源码

cd ~
git clone https://github.com/openclaw/openclaw.git
cd openclaw

6. 解决 Jetson 上 CMake 版本过低的问题

Jetson Ubuntu 20.04 自带 CMake 版本较低,OpenClaw 依赖更高版本。

典型报错:

CMake 3.19 or higher is required. You are running version 3.16.3

手动升级 CMake:

cd ~
wget https://github.com/Kitware/CMake/releases/download/v3.31.6/cmake-3.31.6-linux-aarch64.sh
chmod +x cmake-3.31.6-linux-aarch64.sh
sudo ./cmake-3.31.6-linux-aarch64.sh --skip-license --prefix=/usr/local

检查版本:

/usr/local/bin/cmake --version

若找不到新版本,临时加入 PATH:

export PATH=/usr/local/bin:$PATH
hash -r
cmake --version

建议加入 ~/.bashrc。

7. 安装依赖并编译 OpenClaw

cd ~/openclaw
pnpm install
pnpm build

如遇原生模块编译问题,检查 CMake 版本、build-essential 及 pnpm 路径。

8. 配置模型 API

OpenClaw 通过 ~/.openclaw/openclaw.json 配置。

mkdir -p ~/.openclaw
nano ~/.openclaw/openclaw.json

参考官方文档配置模型 API。

9. 配置 Gateway Token

OpenClaw 架构为 CLI/TUI -> Gateway -> Agent -> Model。CLI 是 Gateway 的客户端,涉及认证。

若只配置服务端 token 而未配置客户端 token,会出现 unauthorized: gateway token mismatch。

推荐配置 ~/.openclaw/openclaw.json:

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "YourToken"
    },
    "remote": {
      "token": "YourToken"
    }
  }
}
  • gateway.auth.token:Gateway 服务端认证 token
  • gateway.remote.token:客户端连接 Gateway 时使用的 token 两者必须一致。

10. 启动 Gateway 服务

openclaw gateway install
systemctl --user start openclaw-gateway.service
openclaw gateway status

正常输出应包含 Runtime: running 和 Listening: 127.0.0.1:18789。

修改配置后重启:

systemctl --user restart openclaw-gateway.service

11. 验证 TUI 是否可用

openclaw tui

若成功,界面显示已连接并能对话。

文章配图

若出现 token mismatch,检查 auth.token 和 remote.token 是否一致。

12. 配置飞书机器人

第一步:创建飞书应用

进入飞书开放平台创建企业自建应用。

文章配图

第二步:启用机器人能力

在应用后台启用机器人。

文章配图

文章配图

文章配图

第三步:配置权限

选择'开发配置 > 权限管理',批量导入权限:

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.send_as_bot",
      "cardkit:card:write"
    ],
    "user": [
      "offline_access",
      "base:field:read",
      "im:message",
      "im:message.send_as_user"
    ]
  }
}

确认无误后申请开通。

文章配图

第四步:发布应用

完成应用创建流程。

文章配图

第五步:配置 Feishu Channel

运行:

openclaw channels add

选择 Feishu / Lark,输入 App ID 和 App Secret。

文章配图

第六步:重启 Gateway
openclaw gateway restart
第七步:配置事件与回调

选择使用长连接接收事件,添加事件 im.message.receive_v1。

文章配图

添加回调地址。

文章配图

第八步:发布应用版本

进入'版本管理与发布',创建并发布版本。未发布会导致配置不生效。

第九步:配置私聊飞书机器人

在飞书 APP 中找到开发者小助手,发送信息获取 Pairing code。

在 Jetson 终端输入:

openclaw pairing approve feishu NHMC7CRG

文章配图

至此,可在飞书中召唤边缘设备。

文章配图

13. 常见坑总结

  1. CMake 版本过低:导致依赖编译失败。
  2. 未配置 pnpm PATH:全局命令或 UI 构建异常。
  3. 误以为需要单独安装 Feishu 插件:源码版已内置。
  4. 未配置 gateway.remote.token:CLI 连接 Gateway 时 token mismatch。
  5. App ID / App Secret 使用旧凭证:导致连接失败。
  6. 飞书应用修改后未发布版本:配置不生效。

14. 最终效果

完成配置后可实现:

  • 在 Jetson 上运行 OpenClaw Gateway
  • 接入模型 API
  • 在飞书群中 @机器人
  • 机器人调用本地 Agent 并返回回复

扩展方向:远程查询状态、执行自动化任务、统一管理实验设备等。

15. 总结

在 Jetson 上部署 OpenClaw 并接入飞书机器人的过程涉及 ARM 平台依赖编译、pnpm 环境变量及 Gateway token 机制等关键点。处理好这些细节后,OpenClaw + 飞书链路较为顺畅。

目录

  1. 1. 背景
  2. 2. 环境信息
  3. Jetson 环境
  4. 3. 安装 Node.js 与 pnpm
  5. 安装 nvm
  6. 配置镜像加速(可选)
  7. 安装并使用 Node.js 20
  8. 配置 npm 镜像加速
  9. 验证安装
  10. 4. 配置 pnpm 环境变量
  11. 5. 克隆 OpenClaw 源码
  12. 6. 解决 Jetson 上 CMake 版本过低的问题
  13. 7. 安装依赖并编译 OpenClaw
  14. 8. 配置模型 API
  15. 9. 配置 Gateway Token
  16. 10. 启动 Gateway 服务
  17. 11. 验证 TUI 是否可用
  18. 12. 配置飞书机器人
  19. 第一步:创建飞书应用
  20. 第二步:启用机器人能力
  21. 第三步:配置权限
  22. 第四步:发布应用
  23. 第五步:配置 Feishu Channel
  24. 第六步:重启 Gateway
  25. 第七步:配置事件与回调
  26. 第八步:发布应用版本
  27. 第九步:配置私聊飞书机器人
  28. 13. 常见坑总结
  29. 14. 最终效果
  30. 15. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 4G Cat.1 模组赋能 AI 教育机器人:算力与物联网融合分析
  • Windows 系统常用 CMD 命令大全(108 个)
  • 企业电子招投标系统首页设计与核心功能架构
  • SkyWalking 与 Spring Cloud Alibaba 全链路追踪实战
  • 用 Selenium 搭建免费 Web 搜索 API 服务
  • OpenWebUI 联网搜索实战:用 SearXNG 让本地大模型获取实时信息
  • Linux 高频面试题与详细解析
  • OpenClaw 飞书机器人搭建流程
  • 双指针算法详解:移动零、复写零、快乐数及盛水容器问题
  • Hashcat 实战指南:从安装到高级密码恢复技巧
  • Llama 3-8B-Instruct 在昇腾 NPU 上的 SGLang 性能实测
  • Java 网络编程:Socket 套接字基础与实现
  • Python 实战:基于 Pygame 的微信风格生日祝福程序
  • 快速排序核心原理与多版本实现详解
  • 无人机 Remote ID Beacon 帧字段详解
  • Node.js 安装与环境配置实战指南
  • Seedance 2.0 重构 AIGC 视频工作流:语义映射与热更新实战
  • 基于 GLM-4.6V-Flash-WEB 构建智能阅卷系统实战
  • Node.js v22 安装与环境配置指南
  • Python 推导式底层实现:从语法糖到 CPython 字节码分析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online