@matelink/cli 2026.4.21 → 2026.4.23

package/README.md

@@ -178,3 +178,31 @@ API:
 - `GET /v1/gateways/{gatewayId}/requests/next` gateway bridge polls pending chat requests
 - `POST /v1/gateways/{gatewayId}/requests/{requestId}/events` gateway bridge streams relay events
 - `POST /v1/openclaw/responses` app chat endpoint (supports `gatewayId + clientToken`)
+
+## 9) CLI Bridge Logging
+
+Bridge runs as a systemd user service on server 80, logs are written to files.
+
+### Viewing logs (server 80)
+
+```bash
+tail -f /root/.openclaw/matecli/logs/bridge.stdout.log   # normal logs (requests, relay status)
+tail -f /root/.openclaw/matecli/logs/bridge.stderr.log   # error logs (poll failures, retries)
+
+# last 100 lines
+tail -100 /root/.openclaw/matecli/logs/bridge.stderr.log
+
+# search for specific request
+grep "Bridge request" /root/.openclaw/matecli/logs/bridge.stdout.log | tail -20
+```
+
+### Service management
+
+```bash
+systemctl --user status matelink-matecli-bridge     # check status
+systemctl --user restart matelink-matecli-bridge    # restart
+systemctl --user stop matelink-matecli-bridge       # stop
+journalctl --user -u matelink-matecli-bridge -f     # systemd journal (if enabled)
+```
+
+Service config: `~/.config/systemd/user/matelink-matecli-bridge.service`

package/bin/matecli.mjs

@@ -18,7 +18,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 const NUMERIC_CODE_LENGTH = 4;
 const GROUP_SIZE = 4;
-const DEFAULT_RELAY_WORKER_WAIT_SECONDS = 600;
+const DEFAULT_RELAY_WORKER_WAIT_SECONDS = 90;
 const DEFAULT_NETWORK_TIMEOUT_MS = 600000;
 const BRIDGE_RETRY_DELAY_MS = 2000;
 const DEFAULT_RELAY_URL = "https://test-mate.clipzap.ai";
@@ -54,6 +54,15 @@ const DEFAULT_GATEWAY_SCOPES = [
 const SESSION_CONTEXT_MIN_TOKENS = 1024;
 const CLI_ENTRY = fileURLToPath(import.meta.url);
 
+function readCliVersion() {
+  try {
+    const pkgPath = path.resolve(path.dirname(CLI_ENTRY), "..", "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 
 function buildPathString(values) {
   const entries = [];
@@ -2744,6 +2753,13 @@ async function readRelayNextGatewayRequest({
       method: "GET",
       headers: {
         ...relayGatewayHeaders(gatewayToken),
+        "x-bridge-version": CLI_PACKAGE_NAME + "/" + readCliVersion(),
+        "x-bridge-os": os.platform() + "/" + os.release(),
+        "x-bridge-arch": os.arch(),
+        "x-bridge-hostname": os.hostname(),
+        "x-bridge-node": process.version,
+        "x-bridge-pid": String(process.pid),
+        "x-bridge-gateway-id": gatewayId ?? "",
       },
     }, (Math.max(waitSeconds, 1) + 15) * 1000);
   } catch (error) {
@@ -3673,6 +3689,22 @@ async function proxyGatewayRequestLocal({
   }
 }
 
+async function reportBridgeMetaToRelay({ relayUrl, gatewayId, gatewayToken, meta }) {
+  const url = `${relayUrl}/v1/gateways/${encodeURIComponent(gatewayId)}/meta`;
+  try {
+    await fetchWithTimeout(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...relayGatewayHeaders(gatewayToken),
+      },
+      body: JSON.stringify(meta),
+    }, 15000);
+  } catch {
+    // best-effort, don't fail bridge startup
+  }
+}
+
 async function runRelayBridge({
   relayUrl,
   gatewayId,
@@ -3680,6 +3712,7 @@ async function runRelayBridge({
   gatewayBaseUrl,
   gatewayAuthToken,
   json,
+  bridgeMeta,
 }) {
   if (!relayUrl) {
     fail("relay URL is required for bridge mode");
@@ -3692,6 +3725,18 @@ async function runRelayBridge({
     console.log(`Relay bridge online. gatewayId=${gatewayId}`);
     console.log(`Relay URL: ${relayUrl}`);
     console.log(`Local Gateway: ${gatewayBaseUrl}`);
+    console.log(`Bridge version: ${bridgeMeta.bridgeVersion}`);
+    console.log(`OS: ${bridgeMeta.osType} ${bridgeMeta.osRelease} (${bridgeMeta.arch})`);
+    console.log(`Hostname: ${bridgeMeta.hostname} | User: ${bridgeMeta.username}`);
+    console.log(`Node: ${bridgeMeta.nodeVersion} | PID: ${bridgeMeta.pid}`);
+    console.log(`CPU: ${bridgeMeta.cpus}x ${bridgeMeta.cpuModel ?? "unknown"}`);
+    console.log(`Memory: ${Math.round(bridgeMeta.freeMemory / 1024 / 1024)}MB free / ${Math.round(bridgeMeta.totalMemory / 1024 / 1024)}MB total`);
+    if (bridgeMeta.linkedUserId) console.log(`Linked user: ${bridgeMeta.linkedUserId}`);
+    if (bridgeMeta.accountId) console.log(`Account: ${bridgeMeta.accountId}`);
+    if (bridgeMeta.deviceId) console.log(`Device: ${bridgeMeta.deviceId}`);
+    if (bridgeMeta.pairCode) console.log(`Last pair code: ${bridgeMeta.pairCode}`);
+    console.log(`Workspace: ${bridgeMeta.workspacePath ?? "default"}`);
+    console.log(`Transport: ${bridgeMeta.transportMode}`);
   }
 
   setGatewayWsBridgePublisher(async (event, payload) => {
@@ -3708,6 +3753,8 @@ async function runRelayBridge({
     });
   });
 
+  await reportBridgeMetaToRelay({ relayUrl, gatewayId, gatewayToken, meta: bridgeMeta });
+
   const activeRequests = new Set();
 
   while (true) {
@@ -4506,6 +4553,88 @@ async function runBridge({ json, relay, noRelay, gateway }) {
     process.exit(0);
   });
 
+  const linkedUserId = typeof section?.linkedUserId === "string" && section.linkedUserId.trim()
+    ? section.linkedUserId.trim()
+    : null;
+  const pairCode = typeof section?.lastPairCode === "string" ? section.lastPairCode.trim() : null;
+
+  // Collect OpenClaw config (sanitized — strip sensitive tokens).
+  const openclawConfig = (() => {
+    try {
+      const raw = readOptionalJsonFile(configPath);
+      // Redact secrets but keep structure.
+      const sanitized = JSON.parse(JSON.stringify(raw));
+      if (sanitized?.gateway?.auth?.token) sanitized.gateway.auth.token = "***";
+      if (sanitized?.channels?.testnextim?.appSecret) sanitized.channels.testnextim.appSecret = "***";
+      if (sanitized?.channels?.["custom-im"]?.appSecret) sanitized.channels["custom-im"].appSecret = "***";
+      return sanitized;
+    } catch {
+      return null;
+    }
+  })();
+
+  // Resolve workspace path.
+  const workspacePath = (() => {
+    try { return resolveConfiguredWorkspaceRoot(); } catch { return null; }
+  })();
+
+  // Read device identity id (if available).
+  const deviceId = (() => {
+    try {
+      const identity = readJsonFileIfExists(GATEWAY_CLIENT_IDENTITY_PATH);
+      return identity?.deviceId ?? null;
+    } catch { return null; }
+  })();
+
+
+  const bridgeMeta = {
+    gatewayId: creds.gatewayId,
+    relayUrl,
+    gatewayBaseUrl,
+    bridgeVersion: readCliVersion(),
+    // System info
+    os: os.platform() + "/" + os.release(),
+    osPlatform: os.platform(),
+    osRelease: os.release(),
+    osType: os.type(),
+    arch: os.arch(),
+    hostname: os.hostname(),
+    nodeVersion: process.version,
+    pid: process.pid,
+    uptime: os.uptime(),
+    totalMemory: os.totalmem(),
+    freeMemory: os.freemem(),
+    cpus: os.cpus().length,
+    cpuModel: os.cpus()[0]?.model ?? null,
+    username: os.userInfo().username,
+    homeDir: os.homedir(),
+    shell: os.userInfo().shell ?? null,
+    // Pairing & user info
+    linkedUserId: linkedUserId,
+    pairCode: pairCode,
+    accountId: section?.accountId ?? null,
+    clientUserId: section?.clientUserId ?? null,
+    deviceId: deviceId,
+    // Config paths
+    configPath,
+    statePath: resolveTestNextIMStatePath(),
+    openclawHome: resolveOpenClawHome(),
+    workspacePath: workspacePath,
+    // OpenClaw config (sanitized)
+    openclawConfig: openclawConfig,
+    // Gateway details
+    gatewayPort: resolveGatewayPort(config) ?? null,
+    gatewayHost: resolveGatewayHost(config),
+    hasGatewayAuthToken: Boolean(gatewayAuthToken),
+    // Channel/transport
+    transportMode: normalizeChatTransportMode(section?.chatTransportMode, "relay"),
+    channelEnabled: section?.enabled !== false,
+    channelName: section?.name ?? "TestNextIM",
+    bindPublicBaseUrl: typeof section?.bindPublicBaseUrl === "string" ? section.bindPublicBaseUrl : null,
+    // Timestamps
+    startedAt: new Date().toISOString(),
+  };
+
   try {
     if (json) {
       console.log(
@@ -4513,9 +4642,7 @@ async function runBridge({ json, relay, noRelay, gateway }) {
           {
             command: "bridge",
             status: "running",
-            relayUrl,
-            gatewayId: creds.gatewayId,
-            gatewayBaseUrl,
+            ...bridgeMeta,
             lockPath: bridgeLock.lockPath,
           },
           null,
@@ -4531,6 +4658,7 @@ async function runBridge({ json, relay, noRelay, gateway }) {
       gatewayBaseUrl,
       gatewayAuthToken,
       json,
+      bridgeMeta,
     });
   } finally {
     cleanupBridgeLock();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matelink/cli",
-  "version": "2026.4.21",
+  "version": "2026.4.23",
   "private": false,
   "description": "Relay-first CLI for pairing and bridging OpenClaw gateway traffic",
   "type": "module",