@matelink/cli 2026.4.20 → 2026.4.22

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";
@@ -1650,12 +1650,12 @@ async function readRelayGatewayBinding({
   gatewayToken,
 }) {
   const url = `${trimSlash(relayUrl)}/v1/gateways/${encodeURIComponent(gatewayId)}/binding`;
-  const response = await fetch(url, {
+  const response = await fetchWithTimeout(url, {
     method: "GET",
     headers: {
       ...relayGatewayHeaders(gatewayToken),
     },
-  });
+  }, 30000);
   const text = await response.text();
   const decoded = text ? safeJsonParse(text) : null;
   if (response.status === 404) {
@@ -1691,12 +1691,12 @@ async function resetRelayGatewayBinding({
   gatewayToken,
 }) {
   const url = `${trimSlash(relayUrl)}/v1/gateways/${encodeURIComponent(gatewayId)}/reset`;
-  const response = await fetch(url, {
+  const response = await fetchWithTimeout(url, {
     method: "POST",
     headers: {
       ...relayGatewayHeaders(gatewayToken),
     },
-  });
+  }, 30000);
   const text = await response.text();
   const decoded = text ? safeJsonParse(text) : null;
   if (response.status === 404) {
@@ -2375,11 +2375,11 @@ async function probeGatewayResponsesEndpoint({
   }
 
   try {
-    const response = await fetch(url, {
+    const response = await fetchWithTimeout(url, {
       method: "POST",
       headers,
       body: JSON.stringify({}),
-    });
+    }, 10000);
     return {
       ok: ![401, 403, 404].includes(response.status),
       status: response.status,
@@ -2483,7 +2483,7 @@ async function publishPairToRelay({
     "content-type": "application/json",
     ...relayAuthHeaders(),
   };
-  const response = await fetch(url, {
+  const response = await fetchWithTimeout(url, {
     method: "POST",
     headers,
     body: JSON.stringify({
@@ -2513,7 +2513,7 @@ async function publishPairToRelay({
 
 async function readPairSessionFromRelay({ relayUrl, code }) {
   const url = `${relayUrl}/v1/pair-sessions/${encodeURIComponent(code)}`;
-  const response = await fetch(url, { method: "GET" });
+  const response = await fetchWithTimeout(url, { method: "GET" }, 30000);
   const text = await response.text();
   const decoded = text ? safeJsonParse(text) : null;
   if (response.status === 404) {
@@ -2557,12 +2557,12 @@ async function readRelayNextBindRequest({ relayUrl, code, after, waitSeconds })
   }
   url.searchParams.set("waitSeconds", String(waitSeconds));
 
-  const response = await fetch(url, {
+  const response = await fetchWithTimeout(url, {
     method: "GET",
     headers: {
       ...relayAuthHeaders(),
     },
-  });
+  }, 95000);
 
   if (response.status === 204) {
     return null;
@@ -2601,14 +2601,14 @@ async function readRelayNextBindRequest({ relayUrl, code, after, waitSeconds })
 
 async function publishRelayBindResult({ relayUrl, code, payload }) {
   const url = `${relayUrl}/v1/pair-sessions/${encodeURIComponent(code)}/bind-results`;
-  const response = await fetch(url, {
+  const response = await fetchWithTimeout(url, {
     method: "POST",
     headers: {
       "content-type": "application/json",
       ...relayAuthHeaders(),
     },
     body: JSON.stringify(payload),
-  });
+  }, 30000);
 
   const text = await response.text();
   if (!response.ok) {
@@ -3543,11 +3543,11 @@ async function proxyGatewayRequestLocal({
 
   let response;
   try {
-    response = await fetch(localUrl, {
+    response = await fetchWithTimeout(localUrl, {
       method: "POST",
       headers,
       body: JSON.stringify(payload),
-    });
+    }, DEFAULT_NETWORK_TIMEOUT_MS);
   } catch (error) {
     await publishRelayGatewayEvent({
       relayUrl,

package/package.json

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