clawpilot-pair

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ClawPilot Pair

ClawPilot 配对

Use this skill for PocketClaw pairing and first-time host setup. ClawPilot is a multi-runtime host agent and may pair:

```
openclaw
```
```
hermes
```
```
ccconnect
```

当用户需要进行PocketClaw配对和首次主机设置时使用此技能。 ClawPilot是一个多运行时主机Agent，可配对以下对象：

```
openclaw
```
```
hermes
```
```
ccconnect
```

When To Use

使用场景

Use this skill when the user wants any of the following:

Pair PocketClaw with the current host
Install or upgrade
```
clawpilot
```
Check whether the host is ready for pairing
Generate a new pairing code

Do not use this skill for normal chat replies, file delivery, or general diagnostics unrelated to pairing.

当用户有以下需求时使用此技能：

将PocketClaw与当前主机配对
安装或升级
```
clawpilot
```
检查主机是否已准备好进行配对
生成新的配对码

请勿将此技能用于普通聊天回复、文件传输或与配对无关的常规诊断。

Required Workflow

必选流程

Follow this order exactly. Do not skip checks.

Install or upgrade ClawPilot:

bash

npm install -g @rethinkingstudio/clawpilot@latest

Determine the target runtime.

Use
```
openclaw
```
,
```
hermes
```
, or
```
ccconnect
```
.
If the user does not specify and the host only has one runtime, use that runtime.
If multiple runtimes are available and the user did not specify, ask which runtime to pair.

Run runtime-specific readiness checks before pairing.

For

openclaw

Verify OpenClaw config can be found.
Verify gateway auth is usable.
Verify the local gateway is reachable.
If auth or gateway reachability fails, stop and report the blocking step with the next command or config fix.

For

hermes

Verify the
```
hermes
```
CLI exists.
Verify
```
hermes gateway status
```
works.
If the gateway service is not installed, tell the user to run:

bash

hermes gateway install
hermes gateway start

If Hermes API readiness fails, report the exact blocking step and the next command to run.

For

ccconnect

Install or upgrade cc-connect before pairing:

bash

npm install -g cc-connect

Verify the
```
cc-connect
```
command is available:

bash

cc-connect --help

Do not pair as
```
ccconnect
```
until the command is installed and runnable.
Let
```
clawpilot pair --runtime ccconnect
```
prepare the local management API and bridge configuration.
If cc-connect cannot be installed or started, stop and report that as the blocking step.

Only after readiness checks pass, generate the pairing code:

bash

clawpilot pair --runtime openclaw

bash

clawpilot pair --runtime hermes

bash

clawpilot pair --runtime ccconnect

Notes:

```
clawpilot pair --runtime hermes
```
will prepare the local Hermes API automatically if possible.
```
clawpilot pair --runtime ccconnect
```
expects
```
cc-connect
```
to be installed first, then prepares the local cc-connect management API and bridge configuration.
Use
```
--code-only
```
only when the user explicitly wants the code without QR output.

请严格按照以下顺序执行，不得跳过检查步骤。

安装或升级ClawPilot：

bash

npm install -g @rethinkingstudio/clawpilot@latest

确定目标运行时。

使用
```
openclaw
```
、
```
hermes
```
或
```
ccconnect
```
。
如果用户未指定且主机仅存在一个运行时，则使用该运行时。
如果存在多个运行时且用户未指定，请询问用户要配对哪个运行时。

在配对前运行特定于运行时的就绪检查。

针对

openclaw

：

确认可找到OpenClaw配置文件。
确认网关认证可用。
确认本地网关可访问。
如果认证或网关访问失败，请停止操作并报告阻塞步骤，同时给出下一步命令或配置修复方案。

针对

hermes

：

确认
```
hermes
```
CLI已存在。
确认
```
hermes gateway status
```
命令可正常运行。
如果网关服务未安装，请告知用户运行以下命令：

bash

hermes gateway install
hermes gateway start

如果Hermes API就绪检查失败，请报告具体的阻塞步骤以及下一步要运行的命令。

针对

ccconnect

：

配对前先安装或升级cc-connect：

bash

npm install -g cc-connect

确认
```
cc-connect
```
命令可用：

bash

cc-connect --help

只有在命令已安装且可运行后，才能以
```
ccconnect
```
进行配对。
让
```
clawpilot pair --runtime ccconnect
```
准备本地管理API和桥接配置。
如果cc-connect无法安装或启动，请停止操作并将此作为阻塞步骤报告。

仅在就绪检查通过后，生成配对码：

bash

clawpilot pair --runtime openclaw

或

bash

clawpilot pair --runtime hermes

或

bash

clawpilot pair --runtime ccconnect

注意：

```
clawpilot pair --runtime hermes
```
会尽可能自动准备本地Hermes API。
```
clawpilot pair --runtime ccconnect
```
要求先安装
```
cc-connect
```
，然后准备本地cc-connect管理API和桥接配置。
仅当用户明确要求仅获取代码而不输出二维码时，才使用
```
--code-only
```
参数。

Output Rules

输出规则

If successful, put the final pairing code on its own line.
Keep explanations brief and action-oriented.
If blocked, say what failed, what was checked, and the next command or config change needed.

如果操作成功，请将最终配对码单独输出在一行。
解释内容应简洁且以行动为导向。
如果操作受阻，请说明失败内容、已检查项以及下一步所需的命令或配置更改。

Do Not

禁止操作

Do not invent ClawPilot flags or unsupported commands.
Do not skip runtime readiness checks and jump straight to pairing.
Do not return a vague failure such as "configuration error" without naming the missing item.
Do not force OpenClaw-specific checks when the user is pairing Hermes or ccconnect.
Do not modify unrelated host settings.

不得虚构ClawPilot的参数或不支持的命令。
不得跳过运行时就绪检查直接进行配对。
不得返回模糊的失败信息，如"配置错误"而不指出缺失项。
当用户配对Hermes或ccconnect时，不得强制进行OpenClaw专属检查。
不得修改无关的主机设置。