教程:VENTUNO Q/安装 OpenClaw

来自WindwizPi wiki

概述

本教程提供在 Arduino® VENTUNO™ Q 开发板上安装 OpenClaw、将其与 Telegram 机器人集成，以及配置 AI 模型以实现智能交互的分步指南。完成本教程后，你将拥有一套可用于 AI 项目的可用 OpenClaw 环境。

所需硬件与软件

硬件

软件

  • Telegram 账户
  • Google AI Studio 账户（或类似的 AI 模型提供商）以获取 API 密钥

访问开发板 Shell

要访问 VENTUNO Q 上的 shell（终端），可以使用 adb 或 ssh。

注意：

重要： 在将 USB-C® 线缆连接到电脑之前，必须先用连接到电源圆口的电源为 VENTUNO Q 供电，否则开发板可能会崩溃。推荐电源最低为 65 W，电压范围为 7–24 V。

要通过 adb 连接，用 USB-C® 线缆连接 VENTUNO Q 与电脑，然后运行： 

# Using adb (Android Debug Bridge)
adb shell

要通过 ssh 连接，请确保 VENTUNO Q 与电脑连接到同一 Wi-Fi® 网络，然后运行： 

# Using ssh (Secure Shell)
ssh arduino@<ip-address>

说明：

有关远程访问开发板的更多替代方式，请参阅 Remote Access 教程。

安装 OpenClaw

本节将指导你在由 Qualcomm® Dragonwing™ QCS8275 处理器驱动并运行 Ubuntu 的 VENTUNO Q 上安装 OpenClaw。

OpenClaw 以 npm 包形式分发，因此安装程序需要较新的 Node.js。VENTUNO Q 镜像未预装 Node.js，且 Ubuntu® 软件源中的版本低于 OpenClaw 所支持的版本，因此安装程序会主动为你安装受支持的发行版。该步骤需要管理员权限，这就是脚本会要求输入密码的原因。

  1. 安装 OpenClaw：
    执行以下命令安装 OpenClaw：
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

说明： 说明： 请在开发板上的交互式终端中运行此命令。安装程序会提示输入密码以安装 Node.js；如果通过非交互会话管道传递该命令，则无法读取该提示。

  1. 安装程序会将 OpenClaw 放在 ~/.npm-global/bin，并在 ~/.bashrc 中将该目录添加到你的 PATH。
  2. 重置 Shell：
    重新加载 shell，使新的 PATH 生效：
    source ~/.bashrc
hash -r
  3. 验证安装：
    可通过检查版本来验证 OpenClaw 是否已正确安装：
    openclaw --version
    这会打印已安装的发行版，例如 OpenClaw 2026.7.1-2。
  4. 完成引导设置：
    运行引导式设置，它会引导你完成身份验证、模型选择、Gateway 和工作区：
    openclaw onboard
    你可以随时重新运行它；openclaw doctor 会检查结果配置并建议修复。

设置 Telegram 机器人

在此，你将创建新的 Telegram 机器人，并获取将其与 OpenClaw 集成所需的凭据。

  1. 与 BotFather 开始聊天：
    打开 Telegram，搜索 BotFather。与其开始聊天。
  2. 创建新机器人：
    向 BotFather 发送命令 /newbot，并按照说明为机器人选择名称和用户名。BotFather 会提供 HTTP API Token。请保存此令牌，后续将用于配置 OpenClaw。
  3. 获取你的 Chat ID：
    要让机器人能够向你发送消息，需要你的 Telegram Chat ID。先向新创建的机器人发送任意消息以开始对话。然后，你可以在网页浏览器中使用类似 https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates 的服务（将 <YOUR_BOT_TOKEN> 替换为机器人的 API 令牌），在 JSON 响应中查找你的 chat ID。在 chat 对象中查找 id 字段。

配置 AI 模型与 API 密钥

OpenClaw 支持多种 AI 模型。本教程将重点介绍配置类似 Google Gemini 的模型。

  1. 获取 API 密钥：
    如果使用 Google Gemini，可从 Google AI Studio 获取 API 密钥。按照说明创建新的 API 密钥。
  2. 使用 API 密钥配置 OpenClaw：
    凭据和模型选择由交互式配置命令处理：
    openclaw configure
    这会引导你完成凭据、通道、Gateway 和智能体默认设置，并将结果写入 OpenClaw 的配置文件。
    要查看在你提供的凭据下 OpenClaw 可访问哪些模型：
    openclaw models list
  3. 检查配置文件（可选）：
    OpenClaw 将配置以 JSON 形式存储在 ~/.openclaw/openclaw.json。你很少需要手动编辑——config 子命令会安全地读写它：
    openclaw config file      # print the configuration file path
openclaw config get       # read the current configuration
openclaw config validate  # check the file is well formed

运行 OpenClaw Gateway 与聊天功能

安装并配置好 OpenClaw 后，现在可以运行其 gateway 和聊天功能。

  1. 连接 Telegram 通道：
    注册你从 BotFather 获得的机器人令牌。Telegram 是 OpenClaw 支持的通道之一：
    openclaw channels add --channel telegram --bot-token <YOUR_BOT_TOKEN>
    检查通道是否已启动：
    openclaw channels status
openclaw status
  2. 运行 OpenClaw Gateway：
    Gateway 是将你的通道连接到 AI 模型的 WebSocket 服务。在开发板上，你通常希望它在后台运行并在重启后继续存在；内置安装程序会将其设置为 systemd 服务：
    openclaw gateway install
    检查其是否健康：
    openclaw gateway health
openclaw doctor
  3. 与你的智能体聊天：
    向 Telegram 机器人发送消息，OpenClaw 会使用你配置的模型处理它。你也可以从开发板终端与同一智能体对话：
    openclaw chat
    如果消息未按预期到达，openclaw channels logs 会显示最近的通道活动。

结论

你已成功在 VENTUNO Q 上安装 OpenClaw，完成 Telegram 机器人集成，并配置了 AI 模型。你现在可以探索 OpenClaw 的能力，并在开发板上开发自己的 AI 驱动应用。

原文：https://docs.arduino.cc/tutorials/ventuno-q/install-openclaw/ 本页为 Arduino 官方教程的中文翻译，供内部查阅。命令与代码保持原文。

检索自“https://windwiz-pi.com/index.php?title=教程:VENTUNO_Q/安装_OpenClaw&oldid=2022”