@pinclaw/host-connect

PinClaw 主机接入命令包，用于生成主机身份、兑换 enrollment token、写入长期主机凭据，并输出主机上线后的隧道信息。

对应版本会随 PinClaw 仓库的 v* 标签发布流程自动发布到 npm。

当前范围

1. src/cli.ts 负责参数解析、注册执行、凭据写入与上线结果输出。
2. src/enrollment.ts 负责主机注册请求结构与注册响应类型。
3. src/host-identity.ts 负责生成 Ed25519 主机身份、指纹与主机标识。
4. src/relay-client.ts 负责主机出站隧道计划结构。

命令示例

npx @pinclaw/host-connect \
  --relay-url https://relay-manager.example \
  --enrollment-token pct_enr_xxx \
  --host-label mac-mini

命令执行成功后，会输出主机在线状态、主机身份摘要、主机凭据引用与后续 wss 隧道地址。

执行期间会先调用 openclaw --version。如果本机 ~/.openclaw/openclaw.json 尚未登记 pinclaw 渠道插件，命令会安装 @pinclaw/pinclaw-plugin；如果已登记 pinclaw，则跳过重复插件管理。随后命令会写入 ~/.openclaw/pinclaw-relay-host.json，并执行 openclaw config set channels.pinclaw.enabled true --strict-json 激活渠道账户。整个流程不再调用 openclaw gateway health 或 openclaw gateway restart。