OpenClaw 入门教程（10）：节点（Node）安装完全指南

OpenClaw 入门教程（10）：节点（Node）安装完全指南创建日期：2026-04-21作者：小龙 🐉版本：v1.0适用版本：OpenClaw 2026.4.14+

📖 概述本文详细介绍 OpenClaw Node（节点）在各平台的系统要求和安装步骤，包括 iOS、Android、macOS、Windows、Linux 等主流操作系统。

📱 1. 手机 Node 支持的系统 iOS（苹果手机）

项目

要求

系统版本

iOS 15.0+

支持设备

iPhone 6s 及更新机型

iPad

iPad Air 2 及更新机型

安装方式

App Store

应用名称

OpenClaw Node

应用大小

~50MB

所需权限

相机、麦克风、网络、通知、定位（可选）

功能支持

功能

支持情况

说明

相机拍照

✅ 完全支持

支持前后摄像头

相机录像

✅ 完全支持

最高 4K 录制

麦克风录音

✅ 完全支持

支持降噪

GPS 定位

✅ 完全支持

支持 GPS/北斗

文件访问

⚠️ 受限支持

仅限 App 沙盒内

屏幕截图

❌ 不支持

iOS 系统限制

传感器

✅ 完全支持

加速度计/陀螺仪等

后台运行

⚠️ 受限

iOS 后台限制

推送通知

✅ 完全支持

APNs 推送

Android（安卓手机）

项目

要求

系统版本

Android 10.0+

支持设备

所有 Android 10+ 设备

安装方式

Google Play / 应用宝 / APK 直装

应用名称

OpenClaw Node

应用大小

~60MB

所需权限

相机、麦克风、存储、网络、通知、定位（可选）

功能支持

功能

支持情况

说明

相机拍照

✅ 完全支持

支持多摄像头

相机录像

✅ 完全支持

最高 8K 录制

麦克风录音

✅ 完全支持

支持降噪

GPS 定位

✅ 完全支持

支持 GPS/北斗/GLONASS

文件访问

⚠️ 受限支持

Android 11+ 受限

屏幕截图

⚠️ 部分支持

Android 11+ 支持

传感器

✅ 完全支持

所有可用传感器

后台运行

✅ 完全支持

后台服务

推送通知

✅ 完全支持

FCM/厂商推送

💻 2. 电脑 Node 支持的系统 macOS（苹果电脑）

项目

要求

系统版本

macOS 12.0+ (Monterey)

支持架构

Intel / Apple Silicon (M1/M2/M3)

安装方式

DMG 安装包 / Homebrew

应用名称

OpenClaw Desktop

应用大小

~150MB

所需权限

文件访问、屏幕录制、网络、相机（可选）

功能支持

功能

支持情况

说明

文件访问

✅ 完全支持

全文件系统访问

屏幕截图

✅ 完全支持

支持多显示器

屏幕录制

✅ 完全支持

支持音频录制

终端命令

✅ 完全支持

zsh/bash

相机访问

✅ 完全支持

FaceTime 相机

麦克风

✅ 完全支持

内置/外置麦克风

GPS 定位

❌ 不支持

桌面设备无 GPS

后台服务

✅ 完全支持

LaunchAgent

Windows（微软电脑）

项目

要求

系统版本

Windows 10 (20H2+) / Windows 11

支持架构

x64 / ARM64

安装方式

MSI 安装包 / PowerShell / Winget

应用名称

OpenClaw Desktop

应用大小

~180MB

所需权限

文件访问、网络、相机（可选）、麦克风（可选）

功能支持

功能

支持情况

说明

文件访问

✅ 完全支持

NTFS/ReFS

屏幕截图

✅ 完全支持

支持多显示器

屏幕录制

✅ 完全支持

支持音频录制

终端命令

✅ 完全支持

PowerShell/CMD/WSL

相机访问

✅ 完全支持

USB 摄像头

麦克风

✅ 完全支持

内置/外置麦克风

GPS 定位

⚠️ 部分支持

部分设备支持

后台服务

✅ 完全支持

Windows Service

Linux

项目

要求

系统版本

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / Fedora 35+

支持架构

x64 / ARM64

安装方式

DEB/RPM 包 / 源码编译 / Snap

应用名称

OpenClaw Desktop

应用大小

~160MB

所需权限

文件访问、网络、相机（可选）、麦克风（可选）

功能支持

功能

支持情况

说明

文件访问

✅ 完全支持

ext4/xfs/btrfs

屏幕截图

✅ 完全支持

X11/Wayland

屏幕录制

✅ 完全支持

FFmpeg

终端命令

✅ 完全支持

bash/zsh

相机访问

✅ 完全支持

V4L2

麦克风

✅ 完全支持

PulseAudio/PipeWire

GPS 定位

❌ 不支持

服务器设备无 GPS

后台服务

✅ 完全支持

systemd

📥 3. 详细安装步骤 iOS 手机安装步骤 1：下载 App

打开 App Store
搜索 "OpenClaw Node"
点击"获取"下载
等待安装完成（约 1-2 分钟）
桌面出现 OpenClaw 图标

截图说明： App Store 搜索界面 ┌─────────────────────────────────┐ │ 🔍 搜索 │ │ │ │ OpenClaw Node │ │ ⭐⭐⭐⭐⭐ (4.9) │ │ OpenClaw Team │ │ [获取] │ └─────────────────────────────────┘

步骤 2：打开 App

点击 OpenClaw 图标打开
首次运行提示权限请求
允许通知（可选）
允许相机权限（推荐）
允许麦克风权限（推荐）
进入主界面

步骤 3：配对 Gateway 方法 1：扫描二维码

点击"扫描配对码"
相机自动打开
扫描 Gateway 的二维码
自动识别并连接
确认配对
完成

方法 2：手动输入

点击"手动配对"
输入 Gateway 地址
- 公网 IP：http://47.89.152.28:13878
- 或内网 IP：http://172.19.36.194:13878
输入配对码（6 位数字）
- 示例：123456
点击"配对"
等待连接（约 3-5 秒）
显示"配对成功"
完成

步骤 4：配置权限 Dashboard → 节点 → iPhone → 权限配置

推荐权限配置： ┌──────────────────────────────────────┐ │ 节点权限配置 - iPhone │ ├──────────────────────────────────────┤ │ ☑ 相机访问 [允许] ✅ │ │ ☑ 麦克风访问 [允许] ✅ │ │ ☑ 定位服务 [允许] ✅ │ │ ☐ 文件访问 [拒绝] ⚠️ │ │ ☐ 屏幕截图 [不支持] ❌ │ │ ☐ 终端命令 [不支持] ❌ │ │ ☐ 系统设置 [不支持] ❌ │ ├──────────────────────────────────────┤ │ [保存] [取消] │ └──────────────────────────────────────┘

Android 手机安装步骤 1：下载 App 方式 1：Google Play

打开 Google Play
搜索 "OpenClaw Node"
点击"安装"
等待下载和安装
完成

方式 2：应用宝（国内）

打开应用宝
搜索 "OpenClaw Node"
点击"安装"
等待下载和安装
完成

方式 3：APK 直装

访问 OpenClaw 官网 https://openclaw.ai/download
选择 Android 版本
下载 APK 文件
打开文件管理器
点击 APK 文件
允许"未知来源"安装
点击"安装"
完成

步骤 2：权限配置首次打开会请求权限：

相机权限 ┌─────────────────────────────────┐ │ 允许 OpenClaw Node 使用相机吗？ │ │ [仅使用 App 期间允许] │ │ [仅这一次] │ │ [不允许] │ └─────────────────────────────────┘ → 选择"仅使用 App 期间允许"
麦克风权限 → 选择"仅使用 App 期间允许"
存储权限 → 选择"允许"
网络权限 → 选择"允许"
通知权限（可选） → 选择"允许"或"不允许"

步骤 3：配对 Gateway 与 iOS 相同：

扫描二维码
或手动输入地址 + 配对码

macOS 电脑安装方式 1：DMG 安装包步骤 1：下载安装包

访问 https://openclaw.ai/download
选择 macOS 版本
选择架构：
- Apple Silicon (M1/M2/M3)
- Intel (旧款 Mac)
点击"下载 DMG"
等待下载完成（约 150MB）

步骤 2：安装

双击 DMG 文件
弹出安装窗口
拖动 OpenClaw 到"应用程序"文件夹
等待复制完成
弹出安装完成提示
打开"应用程序"文件夹
找到 OpenClaw
双击打开

步骤 3：首次运行

首次运行可能提示"无法验证开发者"
点击"仍要打开"
输入 Mac 密码确认
App 打开
允许网络权限
进入主界面

步骤 4：配对

打开 OpenClaw Desktop
点击"添加节点"
输入 Gateway 地址
- http://47.89.152.28:13878
输入配对码
点击"配对"
等待连接
显示"配对成功"
完成

方式 2：Homebrew 安装

步骤 1：安装 Homebrew（如果没有）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤 2：添加 OpenClaw tap

brew tap openclaw/tap

步骤 3：安装 OpenClaw Node

brew install openclaw-node

步骤 4：启动服务

brew services start openclaw-node

步骤 5：配对

openclaw-node pair

输出示例：

配对码：123456 有效期：10 分钟二维码：[显示二维码]

步骤 5：配置权限系统偏好设置 → 安全性与隐私 → 隐私

需要授权的权限： ┌──────────────────────────────────────┐ │ 权限类型状态 │ ├──────────────────────────────────────┤ │ 文件访问 [已授权] ✅ │ │ 屏幕录制 [已授权] ✅ │ │ 相机 [按需] ⚠️ │ │ 麦克风 [按需] ⚠️ │ │ 辅助功能 [不授权] ❌ │ └──────────────────────────────────────┘

Dashboard 权限配置： ☑ 文件访问 ✅ ☑ 屏幕截图 ✅ ☐ 相机（按需） ☐ 麦克风（按需） ☐ 终端命令（危险，不推荐）

Windows 电脑安装方式 1：MSI 安装包步骤 1：下载安装包

访问 https://openclaw.ai/download
选择 Windows 版本
选择架构：
- x64（大多数电脑）
- ARM64（Surface Pro X 等）
点击"下载 MSI"
等待下载完成（约 180MB）

步骤 2：安装

双击 MSI 文件
用户账户控制提示 → 点击"是"
安装向导打开
点击"下一步"
接受许可协议
选择安装位置
- 默认：C:\Program Files\OpenClaw\
点击"安装"
等待安装完成
点击"完成"

步骤 3：首次运行

桌面双击 OpenClaw 图标
首次运行提示防火墙 → 点击"允许访问"
App 打开
进入主界面

步骤 4：配对

打开 OpenClaw Desktop
点击"添加节点"
输入 Gateway 地址
输入配对码
点击"配对"
完成

方式 2：PowerShell 安装

步骤 1：以管理员身份运行 PowerShell

右键点击 PowerShell → 以管理员身份运行

步骤 2：下载安装脚本

iwr -useb https://openclaw.ai/install.ps1 | iex

步骤 3：安装 Node

openclaw-node install

步骤 4：启动服务

openclaw-node start

步骤 5：配对

openclaw-node pair

输出示例：

配对码：123456 有效期：10 分钟

方式 3：Winget 安装

Windows 10 1709+ 支持

安装

winget install OpenClaw.Node

启动

openclaw-node start

配对

openclaw-node pair

步骤 5：配置权限 Dashboard 权限配置： ┌──────────────────────────────────────┐ │ 节点权限配置 - Windows-PC │ ├──────────────────────────────────────┤ │ ☑ 文件访问 [允许] ✅ │ │ ☑ 屏幕截图 [允许] ✅ │ │ ☑ 屏幕录制 [允许] ✅ │ │ ☐ 相机 [按需] ⚠️ │ │ ☐ 麦克风 [按需] ⚠️ │ │ ☐ 终端命令 [拒绝] ❌ │ │ ☐ 系统设置 [拒绝] ❌ │ ├──────────────────────────────────────┤ │ [保存] [取消] │ └──────────────────────────────────────┘

Linux 电脑安装方式 1：DEB 包（Ubuntu/Debian）

步骤 1：下载安装包

wget https://github.com/openclaw/node/releases/latest/download/openclaw-node_amd64.deb

步骤 2：安装

sudo dpkg -i openclaw-node_amd64.deb

如果依赖问题

sudo apt-get install -f

步骤 3：启动服务

sudo systemctl start openclaw-node

步骤 4：设置开机自启

sudo systemctl enable openclaw-node

步骤 5：配对

openclaw-node pair

输出示例：

配对码：123456 有效期：10 分钟

方式 2：RPM 包（CentOS/RHEL/Fedora）

步骤 1：下载安装包

wget https://github.com/openclaw/node/releases/latest/download/openclaw-node.x86_64.rpm

步骤 2：安装

sudo rpm -ivh openclaw-node.x86_64.rpm

步骤 3：启动服务

sudo systemctl start openclaw-node

步骤 4：设置开机自启

sudo systemctl enable openclaw-node

步骤 5：配对

openclaw-node pair

方式 3：Snap 安装（所有 Linux）

步骤 1：安装 Snap（如果没有）

sudo apt-get install snapd # Ubuntu/Debian sudo yum install snapd # CentOS/RHEL

步骤 2：安装 OpenClaw Node

sudo snap install openclaw-node

步骤 3：连接权限

sudo snap connect openclaw-node:home sudo snap connect openclaw-node:network

步骤 4：启动

sudo snap start openclaw-node

步骤 5：配对

openclaw-node pair

🔑 4. 获取配对码在 Gateway 上获取方法 1：命令行

执行命令

openclaw node pair

输出示例：

┌──────────────────────────────────────┐ │ 节点配对 │ ├──────────────────────────────────────┤ │ 配对码：123456 │ │ 有效期：10 分钟 │ │ │ │ 二维码： │ │ ┌───────────────┐ │ │ │ █████████████ │ │ │ │ ████ ██ ████ │ │ │ │ █████████████ │ │ │ └───────────────┘ │ │ │ │ 使用手机 App 扫描此二维码 │ │ 或手动输入配对码 │ └──────────────────────────────────────┘

方法 2：Dashboard

打开 Dashboard http://47.89.152.28:13878/988b222f/
点击左侧"节点"
点击"添加节点"
显示配对码和二维码
使用手机/电脑扫描或输入
等待连接
配对成功

配对流程详解 ┌─────────────────────────────────────────────────────────┐ │ 配对流程 │ ├─────────────────────────────────────────────────────────┤ │ │ │ 1. Gateway 生成配对码（6 位数字） │ │ - 随机生成 │ │ - 有效期 10 分钟 │ │ ↓ │ │ 2. 手机/电脑扫描二维码或输入配对码 │ │ - 扫描二维码（推荐） │ │ - 或手动输入 │ │ ↓ │ │ 3. 设备发送配对请求到 Gateway │ │ - HTTPS 加密 │ │ - 包含设备信息 │ │ ↓ │ │ 4. Gateway 验证配对码 │ │ - 检查是否有效 │ │ - 检查是否过期 │ │ ↓ │ │ 5. 配对成功，建立加密连接 │ │ - TLS 1.3 加密 │ │ - 交换设备证书 │ │ ↓ │ │ 6. 设备出现在 Dashboard 节点列表 │ │ - 显示设备名称 │ │ - 显示在线状态 │ │ - 可配置权限 │ │ │ └─────────────────────────────────────────────────────────┘

📊 5. 系统支持对比手机 Node 详细对比

功能

iOS 15+

Android 10+

相机拍照

✅ 完全

相机录像

✅ 4K

✅ 8K

麦克风录音

✅ 支持

GPS 定位

✅ GPS/ 北斗

✅ 多系统

文件访问

⚠️ 沙盒内

⚠️ 受限

屏幕截图

❌ 不支持

⚠️ Android 11+

传感器

✅ 全部

后台运行

⚠️ 受限

✅ 支持

推送通知

✅ APNs

✅ FCM/厂商

Widget

✅ 支持

⚠️ 部分支持

快捷指令

✅ 支持

❌ 不支持

应用大小

~50MB

~60MB

安装方式

App Store

多商店/APK

电脑 Node 详细对比

功能

macOS 12+

Windows 10+

Linux

文件访问

✅ APFS/HFS+

✅ NTFS

✅ ext4/xfs

屏幕截图

✅ 支持

屏幕录制

✅ 支持

终端命令

✅ zsh/bash

✅ PS/CMD

✅ bash/zsh

相机访问

✅ 支持

麦克风

✅ 支持

GPS 定位

❌ 不支持

⚠️ 部分

❌ 不支持

后台服务

✅ LaunchAgent

✅ Service

✅ systemd

开机自启

✅ 支持

应用大小

~150MB

~180MB

~160MB

安装方式

DMG/Brew

MSI/Winget

DEB/RPM/Snap

💡 6. 安装建议个人用户推荐配置手机： ┌──────────────────────────────────────┐ │ iOS 用户 │ │ - App Store 下载 ✅ │ │ - 权限：相机 + 麦克风 + 定位 │ │ - 用途：拍照、录音、定位 │ └──────────────────────────────────────┘

┌──────────────────────────────────────┐ │ Android 用户 │ │ - 应用宝下载 ✅ │ │ - 权限：相机 + 麦克风 + 存储 + 定位 │ │ - 用途：拍照、录音、文件 │ └──────────────────────────────────────┘

电脑： ┌──────────────────────────────────────┐ │ macOS 用户 │ │ - DMG 安装包 ✅ │ │ - 权限：文件 + 屏幕截图 │ │ - 用途：文件操作、截图 │ └──────────────────────────────────────┘

┌──────────────────────────────────────┐ │ Windows 用户 │ │ - MSI 安装包 ✅ │ │ - 权限：文件 + 屏幕截图 │ │ - 用途：文件操作、截图 │ └──────────────────────────────────────┘

┌──────────────────────────────────────┐ │ Linux 用户 │ │ - DEB/RPM 包 ✅ │ │ - 权限：文件 + 终端 │ │ - 用途：开发、自动化 │ └──────────────────────────────────────┘

企业用户推荐配置批量部署方案：

iOS:

Apple Business Manager
MDM 推送安装
统一配置策略

Android:

Google Zero Touch
MDM 解决方案
企业应用商店

macOS:

Jamf Pro
Kandji
MDM 部署

Windows:

Group Policy
SCCM/MECM
Intune

Linux:

Ansible
Puppet
Chef

统一配置：

集中管理配对码
统一权限策略
定期安全审计
设备分组管理

⚠️ 7. 注意事项安全注意事项

配对码保护 ⭐⭐⭐
- 不公开分享配对码
- 配对后及时失效
- 定期更换配对码
- 配对码有效期：10 分钟
网络安全 ⭐⭐⭐
- 使用 HTTPS 加密连接
- 避免使用公共 WiFi
- 建议使用 VPN
- 配置防火墙规则
权限管理 ⭐⭐⭐
- 最小权限原则
- 敏感权限审批
- 定期权限审查
- 权限变更日志
设备安全 ⭐⭐
- 设备密码保护
- 启用设备加密
- 定期系统更新
- 安装安全软件

系统要求最低要求： ┌──────────────────────────────────────┐ │ 手机 │ │ - iOS 15+ / Android 10+ │ │ - 2GB+ 内存 │ │ - 100MB 可用存储 │ │ - 稳定的网络连接 │ └──────────────────────────────────────┘

──────────────────────────────────────┐ │ 电脑 │ │ - macOS 12+ / Windows 10+ / Linux │ │ - 4GB+ 内存 │ │ - 500MB 可用存储 │ │ - 稳定的网络连接 │ └──────────────────────────────────────┘

推荐配置： ┌──────────────────────────────────────┐ │ 手机 │ │ - 最新 2 代设备 │ │ - 4GB+ 内存 │ │ - 1GB 可用存储 │ │ - WiFi 或 4G/5G │ └──────────────────────────────────────┘

┌──────────────────────────────────────┐ │ 电脑 │ │ - 8GB+ 内存 │ │ - SSD 硬盘 │ │ - 2GB 可用存储 │ │ - 有线网络或 WiFi 6 │ └──────────────────────────────────────┘

常见问题排查 Q1: 配对失败可能原因：

Gateway 不在线
配对码错误
网络不通
配对码过期

解决方法：

检查 Gateway 状态 openclaw gateway status
重新获取配对码 openclaw node pair
检查网络连接 ping 47.89.152.28
重新尝试配对

Q2: 节点离线可能原因：

设备网络断开
App 未运行
设备休眠
防火墙阻止

解决方法：

检查设备网络
打开 App
禁用设备休眠
检查防火墙规则

Q3: 权限被拒绝可能原因：

用户拒绝权限
系统限制
MDM 策略

解决方法：

设备设置 → 应用管理
找到 OpenClaw Node
重新授权权限
重启 App

Q4: 功能不工作可能原因：

权限未授权
系统不支持
配置错误

解决方法：

检查 Dashboard 权限配置
查看系统支持表
重新配置节点

📝 8. 总结系统支持总结

平台

最低版本

推荐版本

安装方式

难度

iOS

15.0+