## 前言

OpenClaw 是一个强大的 AI 助手网关工具，支持多种设备的接入与配对。本文详细介绍三种主流配对场景的操作流程及常见问题解决方案。

---

## 一、子节点（Node）配对

适用于将**笔记本、树莓派、服务器**等设备作为执行节点接入网关，实现算力扩展或远程任务执行。

### 1.1 前期准备

确保子节点已安装 OpenClaw：

```bash
npm install -g openclaw
```

### 1.2 操作流程

**步骤一：节点发起连接**

在子节点上执行：

```bash
openclaw node run --host <网关IP> --port <端口> --token <令牌>
```

参数说明：

- `--host`：网关服务器的 IP 地址
- `--port`：网关端口，默认为 `18789`
- `--token`：网关认证令牌

> 💡 **首次连接时**，节点会自动生成密钥对（公钥/私钥），并向网关发送配对请求。此时连接处于"待批准"状态。

**步骤二：网关审批**

在网关机器上查看待审批列表：

```bash
openclaw nodes pending
```

命令输出会显示类似以下内容：

```
Pending nodes:
 - request-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
 hostname: my-laptop
 ip: 192.168.1.100
 last-seen: 2026-04-13T07:30:00Z
```

**步骤三：完成配对**

```bash
openclaw nodes approve <request-id>
```

批准后，节点即可**自动重连**并长期在线，后续无需再次配对。

### 1.3 进阶配置

如果需要指定节点名称或进行精细控制：

```bash
# 运行时指定节点名称
openclaw node run --host 192.168.1.100 --port 18789 --token YOUR_TOKEN --name "my-dev-machine"

# 查看已配对节点列表
openclaw nodes list

# 移除已配对节点
openclaw nodes revoke <node-id>
```

---

## 二、消息渠道（Telegram）配对

让 Telegram 机器人与 OpenClaw 网关通信，实现通过 Telegram 控制 AI 助手。

### 2.1 前期准备

1. 已配置好 Telegram Bot（通过 BotFather 创建）
2. 已在 OpenClaw 配置文件中设置好 Telegram 相关参数

### 2.2 操作流程

**步骤一：获取配对码**

在 Telegram 中向你的机器人发送任意消息：

```
/start
```

机器人会自动回复一串数字/字母组合的配对码，例如：

```
📱 配对码：ABC123XY
请在 5 分钟内在网关完成验证
```

**步骤二：网关审批**

在网关机器上执行：

```bash
openclaw pairing approve telegram <PAIRING_CODE>
```

示例：

```bash
openclaw pairing approve telegram ABC123XY
```

**步骤三：验证成功**

看到类似输出即表示配对成功：

```
✅ Telegram 配对成功！
Bot: @your_bot_name
```

### 2.3 后续使用

配对成功后，可直接在 Telegram 中与机器人对话，消息会自动转发到 OpenClaw 网关处理。

---

## 三、移动设备（Android/iOS）配对

适用于手机上的 OpenClaw App 连接网关，实现移动办公。

### 3.1 操作流程

**步骤一：配置网关信息**

在手机上打开 OpenClaw App，进入设置页面，填写：

- 网关地址：如 `192.168.1.100:18789`
- 认证令牌：在网关配置中获取

**步骤二：网关审批**

在网关机器上查看待处理请求：

```bash
openclaw devices list
```

输出示例：

```
Pending devices:
 - request-id: yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
 device-name: iPhone 15 Pro
 platform: iOS
 last-seen: 2026-04-13T08:00:00Z
```

**步骤三：完成配对**

```bash
openclaw devices approve <request-id>
```

### 3.2 设备管理命令

```bash
openclaw devices list          # 查看所有已配对设备
openclaw devices revoke <id>  # 移除设备
openclaw devices approve --all # 批准所有待处理请求
```

---

## 四、常见问题排查

### Q1：`nodes pending` 看不到请求

**可能原因：**

- 节点连接时的 setTimeout 未触发
- 网络不通或防火墙阻断

**解决方案：**

```bash
# 1. 确保 OpenClaw 是最新版本
openclaw update

# 2. 检查节点与网关之间的网络连通性
telnet <网关IP> 18789

# 3. 确认 Token 正确
cat ~/.openclaw/openclaw.json | grep -A2 "auth"
```

### Q2：Headless 服务器（如 EC2）节点离线

对于没有图形界面的服务器，需要启用 systemd user lingering：

```bash
sudo loginctl enable-linger $USER
```

这样即使没有登录会话，用户服务也能持续运行。

### Q3：Token 不匹配

确保节点运行时提供的 `--token` 与网关配置中的 token **完全一致**：

```bash
# 查看网关配置的 token
grep -A5 '"auth"' ~/.openclaw/openclaw.json
```

---

## 五、安全建议

1. **保护好 Token**：不要在公开场合泄露网关认证令牌
2. **使用防火墙**：只允许受信任的 IP 访问网关端口
3. **定期更新**：保持 OpenClaw 为最新版本以获得安全补丁
4. **配对验证**：来自未知设备的配对请求需仔细核实

---

*本文整理自网络资料，仅供学习参考。