@clawpilot-app/link 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# ClawPilot Link
+
+`ClawPilot Link` is the local daemon and CLI that connects a local OpenClaw instance to ClawPilot Relay.
+
+## Requirements
+
+- Node.js 22.14.0 or newer
+- An OpenClaw setup that already works on the same machine
+
+## Install
+
+```bash
+npm install -g @clawpilot-app/link
+```
+
+ClawPilot Link follows OpenClaw's runtime baseline. If your Node.js version is older than 22.14.0, the install step will stop early and ask you to upgrade first.
+
+## Common commands
+
+```bash
+clawlink pair
+clawlink connect --background
+clawlink status
+clawlink doctor
+clawlink qr
+clawlink restart
+```
+
+## Update
+
+```bash
+npm install -g @clawpilot-app/link@latest
+clawlink restart
+```
+
+## Publish from this repo
+
+```bash
+npm run release -- --version 0.1.1
+```
+
+Or publish in one step:
+
+```bash
+npm run release -- --version 0.1.1 --publish
+```
+
+The npm package name is `@clawpilot-app/link`.

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@clawpilot-app/link",
+  "version": "0.1.0",
+  "private": false,
+  "description": "ClawPilot Link daemon and CLI for connecting local OpenClaw through ClawPilot Relay",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "clawlink": "./src/cli.js"
+  },
+  "files": [
+    "src",
+    "scripts/check-node-version.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "clawpilot",
+    "openclaw",
+    "relay",
+    "link",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "scripts": {
+    "check": "find src scripts -type f \\( -name '*.js' -o -name '*.mjs' \\) -print0 | xargs -0 -n1 node --check",
+    "preinstall": "node ./scripts/check-node-version.mjs",
+    "start": "node ./src/cli.js",
+    "daemon": "node ./src/cli.js daemon",
+    "pack:dry-run": "npm pack --dry-run",
+    "release": "node ./scripts/release.mjs",
+    "publish:npm": "npm publish --access public"
+  },
+  "dependencies": {
+    "json5": "^2.2.3",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.18.3"
+  }
+}

package/scripts/check-node-version.mjs

@@ -0,0 +1,44 @@
+import process from "node:process";
+
+const MINIMUM_NODE_VERSION = "22.14.0";
+
+function parseVersion(input) {
+  const normalized = String(input ?? "")
+    .trim()
+    .replace(/^v/i, "");
+  const [major = "0", minor = "0", patch = "0"] = normalized.split(".");
+  return [
+    Number.parseInt(major, 10) || 0,
+    Number.parseInt(minor, 10) || 0,
+    Number.parseInt(patch, 10) || 0,
+  ];
+}
+
+function compareVersions(left, right) {
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] > right[index]) {
+      return 1;
+    }
+    if (left[index] < right[index]) {
+      return -1;
+    }
+  }
+  return 0;
+}
+
+const current = parseVersion(process.versions.node);
+const minimum = parseVersion(MINIMUM_NODE_VERSION);
+
+if (compareVersions(current, minimum) < 0) {
+  console.error("");
+  console.error("ClawPilot Link needs Node.js 22.14.0 or newer.");
+  console.error(`You are using Node.js ${process.versions.node}.`);
+  console.error("");
+  console.error("Why this is required:");
+  console.error("- OpenClaw itself already requires Node.js 22.14.0 or newer.");
+  console.error("- If Link allowed an older Node.js, installation might succeed but pairing or background service could fail later.");
+  console.error("");
+  console.error("Please update Node.js first, then run the install command again.");
+  console.error("");
+  process.exit(1);
+}