📱 平台指南

macOS App、iOS/Android 节点、Canvas 可视化完整指南

🍎

macOS App

菜单栏伴侣应用，最强功能集成

核心功能：

Canvas 可视化Voice Wake 语音唤醒系统级集成菜单栏控制

要求：macOS 12+, 已安装 OpenClaw Gateway

获取：从官网下载 OpenClaw.dmg

📱

iOS App

iPhone 节点应用，随身 AI 助手

核心功能：

Canvas 渲染相机拍照屏幕录制语音对话

要求：iOS 16+, Gateway 在局域网或 Tailnet 运行

获取：TestFlight 内测（尚未公开发布）

🤖

Android App

Android 节点应用，开放生态

核心功能：

Canvas 支持相机/录屏通知集成后台服务

要求：Android 10+, Gateway 可访问

获取：APK 内测版本

🍎 macOS App 功能详解

🎛️

菜单栏控制中心

点击菜单栏图标即可查看 Gateway 状态、快速发送消息、查看会话

✓ 实时显示 Gateway 连接状态

✓ 快速发送消息给 AI

✓ 查看最近的会话列表

✓ 一键打开 WebChat

🎨

Canvas 可视化面板

无边框悬浮窗口，AI 可以在这里画图、展示数据、创建交互界面

✓ 支持 HTML/CSS/JS

✓ A2UI 组件系统

✓ 自动记忆窗口位置

✓ 可捕获为图片

常用命令：

openclaw nodes canvas present

显示 Canvas 面板

openclaw nodes canvas navigate --url /

导航到本地页面

openclaw nodes canvas snapshot

截取 Canvas 画面

🎙️

Voice Wake 语音唤醒

说唤醒词即可激活 AI，不用动手

✓ 默认唤醒词：'Hey OpenClaw'

✓ 支持自定义唤醒词

✓ 完全本地处理，不上传云端

✓ 需授权麦克风权限

设置步骤：

1. 系统设置 → 安全性与隐私 → 麦克风 → 允许 OpenClaw
2. OpenClaw 设置 → Voice Wake → 开启
3. 训练唤醒词（安静环境说3遍）

💬

Talk Mode 持续对话

像打电话一样和 AI 持续对话，无需每次点击

✓ 自动监听和回复

✓ 支持打断

✓ 显示语音转文字

✓ 按 ESC 退出

⚙️

系统工具集成

AI 可以直接控制你的 Mac

✓ system.run - 执行 shell 命令

✓ system.notify - 发送系统通知

✓ camera.snap - 调用摄像头

✓ screen.record - 屏幕录制

🔒 所有系统操作都需要你在 Exec Approvals 中授权

📱 iOS/Android 节点

📢 注意：iOS 和 Android App 目前处于内测阶段，尚未公开发布。如需体验，请关注官方 Discord 获取 TestFlight/TF 邀请。

🔗

节点配对

将 iPhone 作为 Gateway 的节点，扩展 AI 能力到手机

1 确保手机和 Gateway 在同一 WiFi 或 Tailnet

2 iOS App 会自动发现 Gateway

3 在 Gateway 上批准配对请求

4 开始使用手机功能

openclaw nodes pending

查看待批准的配对请求

openclaw nodes approve <requestId>

批准配对

openclaw nodes status

查看已连接节点

📷

相机与录屏

AI 可以看到你的摄像头画面和屏幕内容

拍张照片让 AI 分析内容

录制操作步骤发给 AI

实时屏幕共享给 AI 指导

🖼️

Canvas 渲染

在手机上查看 AI 创建的 Canvas 内容

🎨 Canvas 完全指南

Canvas 是什么？

Canvas 是 OpenClaw 的可视化交互界面。AI 可以在 Canvas 上画图、展示数据、创建表单，就像给你看一个动态网页。

如何使用 Canvas

显示 Canvas

openclaw nodes canvas present --node <id>

导航到页面

openclaw nodes canvas navigate --node <id> --url /

执行 JS

openclaw nodes canvas eval --node <id> --js "alert('Hello')"

截图保存

openclaw nodes canvas snapshot --node <id>

A2UI 组件系统

A2UI 是 OpenClaw 的 UI 组件协议，AI 可以用它创建按钮、文本、图表等界面元素。

// A2UI v0.8 示例
{
  "surfaceUpdate": {
    "surfaceId": "main",
    "components": [
      {
        "id": "title",
        "component": {
          "Text": {
            "text": {"literalString": "Hello Canvas!"},
            "usageHint": "h1"
          }
        }
      }
    ]
  }
}

实际应用场景

数据分析

AI 读取 CSV 后在 Canvas 上生成图表

界面设计

描述需求，AI 生成 HTML 原型展示

步骤演示

AI 在 Canvas 上画流程图解释操作步骤

游戏开发

AI 创建简单的交互式游戏 demo

🍎 macOS 设置步骤

下载 OpenClaw.dmg 并安装
首次启动时授予必要权限（通知、麦克风、辅助功能）
App 会自动检测本地 Gateway，或手动配置远程 Gateway
在菜单栏看到 🦞 图标即表示成功

📱 iOS 设置步骤

通过 TestFlight 安装 iOS App（目前内测）
确保 iPhone 和 Gateway 在同一网络
打开 App，选择发现的 Gateway
在 Gateway 上运行 openclaw nodes approve 批准配对

🔧 常见问题

[macOS] 权限请求反复弹出

系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加 OpenClaw

[macOS] Canvas 不显示

检查 Settings → Allow Canvas 是否开启，或尝试重启 App

[iOS] 找不到 Gateway

确保手机和电脑在同一 WiFi，或配置 Tailscale 网络

[iOS] 配对请求不出现

在 Gateway 上运行 openclaw nodes pending 查看，手动批准

[通用] NODE_BACKGROUND_UNAVAILABLE

将 App 切换到前台，iOS 限制后台运行

←

🔒 安全指南

部署与运维 🐳

→