Jetson 部署 OpenClaw 接入飞书机器人打造本地 AI 助手

保存后执行 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

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

参考官方文档配置模型服务。

9. 配置 Gateway Token

OpenClaw 架构中 CLI 是 Gateway 客户端，需配置认证 Token。

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "Yours Token"
    },
    "remote": {
      "token": "Yours Token"
    }
  }
}

• gateway.auth.token：Gateway 服务端认证 token
• gateway.remote.token：CLI 连接 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:message.group_at_msg:readonly", ...],
    "user": ["contact:user.employee_id:readonly", "offline_access", "base:app:copy", ...]
  }
}

申请开通权限。

第四步：发布应用

创建版本并发布。

完成后可在 Jetson 连接飞书机器人。

第五步：配置 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：Jetson 上 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 机制。处理好这些关键点后，链路较为顺畅。