什么是 Clawket QR 配对？

Clawket 技能是一个专门的实用程序，旨在架起桌面 AI 环境与移动设备之间的桥梁。通过利用 Openclaw Skills，开发人员可以生成编码了主机 IP 地址、端口和身份验证令牌的唯一二维码，从而允许 Clawket 移动应用自动配置其连接设置。

该实用程序消除了手动输入复杂令牌或 IP 地址的需要，确保了快速且安全的配对过程。它为希望在不牺牲本地设置的安全性和配置复杂性的情况下，随时随地管理其 AI 智能体的用户提供了桥梁。

下载入口:https://github.com/openclaw/skills/tree/main/skills/p697/clawket

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Clawket QR 配对 应用场景

• 将 Clawket 移动应用与本地 OpenClaw 网关实例配对。
• 当本地局域网 IP 地址更改时更新移动连接设置。
• 简化移动端 AI 智能体监控和交互的登录过程。
• 为新的 Openclaw Skills 用户提供直观的扫码连接界面。

1. 脚本读取本地配置文件以检索活动的身份验证令牌。
2. 自动检测当前的局域网 IP 地址，以确保移动设备可以在网络上找到主机。
3. 二维码负载被构建为一个包含主机、端口和令牌的 JSON 对象。
4. qrencode 实用程序在终端中生成 PNG 图像和 ASCII 表示。
5. 生成的图像通过 AI 智能体的消息传递接口发送给用户，以便即时扫描。

Clawket QR 配对 配置指南

首先，确保您的系统中安装了 qrencode，以便在 Openclaw Skills 中启用二维码生成：

# macOS
brew install qrencode

# Linux
sudo apt install qrencode

# Windows
choco install qrencode

然后，执行生成脚本：

bash SKILL_DIR/scripts/gateway-qr.sh

Clawket QR 配对 数据架构与分类体系

该技能与本地 JSON 配置文件交互并生成媒体资产，如下所示：

name: clawket
description: >-
  Generate QR codes for Clawket mobile app to pair with the local OpenClaw Gateway.
  Use when user mentions: Clawket pairing, login Clawket, QR code, mobile app connection,
  connect phone to Gateway, or scan to login.

Clawket Gateway QR Code

Generate a QR code that the Clawket mobile app can scan to auto-configure Gateway connection (URL + auth token).

Generate QR Code

Run the script:

bash SKILL_DIR/scripts/gateway-qr.sh

The script will:

1. Read ~/.openclaw/openclaw.json for the auth token
2. Detect the local LAN IP address
3. Generate a QR code as a PNG image at ~/.openclaw/media/clawket-qr.png
4. Also print an ASCII QR code to the terminal

Send the PNG to the user via the message tool (filePath: ~/.openclaw/media/clawket-qr.png).

QR Payload Format

The QR code contains a JSON object:

{
  "host": "192.168.1.100",
  "port": 18789,
  "token": "...",
  "tls": false
}

The Clawket app scans this and auto-fills Gateway URL + auth token, then connects.

Troubleshooting

• If qrencode is not installed: brew install qrencode (macOS) / sudo apt install qrencode (Linux) / choco install qrencode (Windows)
• If the LAN IP detection fails, the script falls back to 127.0.0.1
• The token is read directly from the JSON config file (not via openclaw config get which redacts it)