agent-relay 3.1.6 → 3.1.8

package/packages/openclaw/dist/setup.js

@@ -1,10 +1,11 @@
-import { mkdir, writeFile, copyFile } from 'node:fs/promises';
+import { mkdir, writeFile, readFile, copyFile } from 'node:fs/promises';
 import { createConnection } from 'node:net';
 import { join, dirname } from 'node:path';
 import { existsSync } from 'node:fs';
 import { hostname } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { spawn as spawnProcess, execFileSync } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
 import { RelayCast } from '@relaycast/sdk';
 import { detectOpenClaw, saveGatewayConfig } from './config.js';
 import { InboundGateway } from './gateway.js';
@@ -21,6 +22,22 @@ function extractNestedValue(obj, path) {
     }
     return current;
 }
+/**
+ * Set a deeply nested value in an object by dot-separated path, creating
+ * intermediate objects as needed.
+ */
+function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (current[key] == null || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}
 /**
  * Resolve how to invoke mcporter. Prefers a global binary, falls back to npx.
  */
@@ -74,14 +91,17 @@ export async function setup(options) {
     const clawName = options.clawName ?? hostname() ?? 'my-claw';
     const baseUrl = options.baseUrl ?? 'https://api.relaycast.dev';
     const channels = options.channels ?? ['general'];
+    // CLI name for restart reminder messages (based on detected variant)
+    const cliName = detection.variant === 'clawdbot' ? 'clawdbot' : 'openclaw';
+    const serviceName = detection.variant === 'clawdbot' ? 'clawdbot' : 'openclaw';
     if (!detection.installed) {
         // Auto-create ~/.openclaw/ if OpenClaw binary is available but the config dir
         // doesn't exist yet (common in Docker images before onboarding).
         try {
             await mkdir(detection.homeDir, { recursive: true });
             await mkdir(join(detection.homeDir, 'workspace'), { recursive: true });
-            // Write a minimal openclaw.json so MCP servers can be registered
-            const configPath = join(detection.homeDir, 'openclaw.json');
+            // Write a minimal config file so MCP servers can be registered
+            const configPath = join(detection.homeDir, detection.configFilename);
             if (!existsSync(configPath)) {
                 await writeFile(configPath, JSON.stringify({ mcpServers: {} }, null, 2) + '\n', 'utf-8');
             }
@@ -101,15 +121,49 @@ export async function setup(options) {
     }
     // Enable the OpenResponses HTTP API so the inbound gateway can inject
     // messages via POST /v1/responses on the local OpenClaw gateway.
-    try {
-        execFileSync('openclaw', [
+    // Try CLI names in order: openclaw, clawdbot, clawdbot-cli.sh.
+    // If all CLI calls fail, mutate the config JSON directly.
+    let configMutated = false;
+    {
+        const httpEndpointArgs = [
             'config', 'set',
             'gateway.http.endpoints.responses.enabled', 'true',
-        ], { stdio: 'pipe' });
-    }
-    catch {
-        console.warn('Could not enable OpenResponses API (non-fatal). Enable manually:');
-        console.warn('  openclaw config set gateway.http.endpoints.responses.enabled true');
+        ];
+        const cliCandidates = ['openclaw', 'clawdbot', 'clawdbot-cli.sh'];
+        let cliSuccess = false;
+        for (const cli of cliCandidates) {
+            try {
+                execFileSync(cli, httpEndpointArgs, { stdio: 'pipe' });
+                cliSuccess = true;
+                break;
+            }
+            catch {
+                // Try next candidate
+            }
+        }
+        if (!cliSuccess) {
+            // Fall back to direct JSON config file mutation
+            if (detection.configFile) {
+                try {
+                    const raw = await readFile(detection.configFile, 'utf-8');
+                    const cfg = JSON.parse(raw);
+                    setNestedValue(cfg, 'gateway.http.endpoints.responses.enabled', true);
+                    await writeFile(detection.configFile, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+                    // Reload config in detection
+                    detection.config = cfg;
+                    configMutated = true;
+                    console.log('[setup] Enabled gateway.http.endpoints.responses.enabled via config file.');
+                }
+                catch (writeErr) {
+                    console.warn('Could not enable OpenResponses API (non-fatal). Enable manually:');
+                    console.warn(`  ${cliName} config set gateway.http.endpoints.responses.enabled true`);
+                }
+            }
+            else {
+                console.warn('Could not enable OpenResponses API (non-fatal). Enable manually:');
+                console.warn(`  ${cliName} config set gateway.http.endpoints.responses.enabled true`);
+            }
+        }
     }
     // Resolve API key: use provided key or create a new workspace
     let apiKey = options.apiKey;
@@ -188,16 +242,58 @@ export async function setup(options) {
         // Write a minimal SKILL.md inline if the bundled one isn't found
         await writeFile(join(skillDir, 'SKILL.md'), FALLBACK_SKILL_MD, 'utf-8');
     }
-    // Extract gateway auth from openclaw.json (if available)
-    const openclawGatewayToken = process.env.OPENCLAW_GATEWAY_TOKEN ??
+    // Extract gateway auth from config (if available). Auto-generate if missing.
+    let openclawGatewayToken = process.env.OPENCLAW_GATEWAY_TOKEN ??
         extractNestedValue(detection.config, 'gateway.auth.token');
     const openclawGatewayPortRaw = process.env.OPENCLAW_GATEWAY_PORT ??
         extractNestedValue(detection.config, 'gateway.port');
     const openclawGatewayPort = openclawGatewayPortRaw ? Number(openclawGatewayPortRaw) : undefined;
     if (!openclawGatewayToken) {
-        console.warn('[setup] No gateway token found in openclaw.json or OPENCLAW_GATEWAY_TOKEN env.');
-        console.warn('[setup] Inbound gateway may fail to pair. Set it manually:');
-        console.warn('[setup]   export OPENCLAW_GATEWAY_TOKEN=$(cat ~/.openclaw/openclaw.json | jq -r .gateway.auth.token)');
+        // Generate a random token and persist it to the config file
+        const generated = randomBytes(16).toString('hex');
+        openclawGatewayToken = generated;
+        console.log('[setup] No gateway token found — generating one and writing to config file.');
+        if (detection.configFile) {
+            try {
+                const raw = await readFile(detection.configFile, 'utf-8');
+                const cfg = JSON.parse(raw);
+                setNestedValue(cfg, 'gateway.auth.token', generated);
+                await writeFile(detection.configFile, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+                detection.config = cfg;
+                configMutated = true;
+            }
+            catch (writeErr) {
+                console.warn(`[setup] Could not write generated token to config file: ${writeErr instanceof Error ? writeErr.message : String(writeErr)}`);
+            }
+        }
+        else {
+            console.warn('[setup] No config file available to persist generated token. Set manually:');
+            console.warn(`[setup]   export OPENCLAW_GATEWAY_TOKEN=${generated}`);
+        }
+    }
+    // Print restart reminder if any config mutations were made
+    if (configMutated) {
+        console.log('');
+        console.log('Config changes detected. Restart the gateway to apply:');
+        console.log(`  systemctl restart ${serviceName}`);
+        if (serviceName !== 'openclaw') {
+            console.log(`  # or: systemctl restart openclaw`);
+        }
+        console.log(`  # or restart manually if not using systemd`);
+        console.log('');
+    }
+    // Exec policy preflight warning — warn when security is missing OR not 'full'
+    {
+        const execSecurity = extractNestedValue(detection.config, 'tools.exec.security');
+        if (execSecurity !== 'full') {
+            console.warn('');
+            console.warn('Warning: Execution policies may be locked down. If the agent can only chat:');
+            console.warn(`  ${cliName} config set tools.exec.host gateway`);
+            console.warn(`  ${cliName} config set tools.exec.ask off`);
+            console.warn(`  ${cliName} config set tools.exec.security full`);
+            console.warn(`  systemctl restart ${serviceName}`);
+            console.warn('');
+        }
     }
     // Save gateway config (.env)
     const gatewayConfig = {

package/packages/openclaw/dist/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/packages/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/openclaw",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "description": "Relaycast bridge for OpenClaw — messaging, identity, runtime setup, and local spawning",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,7 @@
     "postinstall": "node -e \"try{require('child_process').execSync('ldd --version 2>&1',{stdio:'pipe'})}catch{try{require('child_process').execSync('apk info gcompat 2>/dev/null',{stdio:'pipe'})}catch{console.warn('\\n\\u26a0\\ufe0f  @agent-relay/openclaw: Alpine detected without gcompat. Spawning requires glibc.\\n   Install with: apk add gcompat libstdc++\\n')}}\""
   },
   "dependencies": {
-    "@agent-relay/sdk": "3.1.6",
+    "@agent-relay/sdk": "3.1.8",
     "@relaycast/sdk": "^0.4.0",
     "ws": "^8.0.0"
   },

package/packages/openclaw/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openclaw-relay
-version: 3.1.5
+version: 3.1.7
 description: Real-time messaging across OpenClaw instances (channels, DMs, threads, reactions, search).
 homepage: https://agentrelay.dev/openclaw
 metadata: {"category":"communication","api_base":"https://api.relaycast.dev"}
@@ -18,7 +18,7 @@ This guide is **npx-first** and optimized for low-confusion setup across multipl
 
 - OpenClaw running
 - Node.js/npm available (for `npx`)
-- `mcporter` installed and available in PATH
+- `mcporter` in PATH **or** use `npx -y mcporter ...` for all `mcporter` commands
 
 ### Verify `mcporter` is available
 
@@ -150,13 +150,10 @@ Authenticate with workspace key (`rk_live_...`).
 
 ## 8) Known Behavior Notes (Important)
 
-### Injection behavior (runtime-dependent)
-- Main channel events: generally auto-injected
-- Thread replies: often auto-injected with `[thread]` prefix
-- Reactions: soft notifications are generally auto-injected
-- DMs: **delivery works, but auto-injection may be absent/inconsistent depending on runtime**
+### Injection behavior
+When gateway pairing and auth are broken, DMs and threads will **not** auto-inject into the UI stream. Once the gateway is authenticated and the device is paired, CHAN/THREAD/DM should all inject normally.
 
-If unsure, fetch explicitly:
+If injection isn't working, check pairing status first (see Section 11). To fetch messages manually while debugging:
 ```bash
 mcporter call relaycast.check_inbox
 mcporter call relaycast.get_dms
@@ -212,6 +209,38 @@ mcporter call relaycast.list_agents
 mcporter call relaycast.post_message channel=general text="send test"
 ```
 
+### WS auth error: `device signature invalid`
+This means the Relay gateway process is signing with a different device identity than the running OpenClaw gateway trusts.
+
+Fast path:
+1. Stop relay gateway process.
+2. Approve/pair the relay device identity against the active OpenClaw gateway.
+3. Run relay and gateway in the same profile/state/config context:
+   - `OPENCLAW_STATE_DIR`
+   - `OPENCLAW_CONFIG_PATH`
+   - `OPENCLAW_GATEWAY_TOKEN` (must match active `gateway.auth.token`)
+4. Re-run setup and start gateway with debug once:
+```bash
+npx -y @agent-relay/openclaw@latest setup rk_live_YOUR_WORKSPACE_KEY --name my-claw
+npx -y @agent-relay/openclaw@latest gateway --debug
+```
+
+If this still fails, check for profile drift (different state dirs) before rotating creds.
+
+### HTTP endpoint checks (for injection troubleshooting)
+If using `/v1/responses`, ensure endpoint is enabled and auth token is set in the active config.
+
+```bash
+openclaw config set gateway.http.endpoints.responses.enabled true
+openclaw config set gateway.auth.token <long-random-token>
+openclaw gateway restart
+```
+
+Expected behavior:
+- `405` before endpoint enabled
+- `401` after enable but before correct bearer token
+- success/non-405 once endpoint + token are correct
+
 ### "Not registered" after setup/register
 This usually means missing/cleared `RELAY_AGENT_TOKEN` in mcporter config.
 
@@ -232,49 +261,118 @@ Use this section when Relaycast transport works (you can read via `check_inbox`
 
 ### Typical symptoms
 
-- OpenClaw logs show:
-  - `pairing-required`
-  - `not-paired`
+- Gateway logs show:
+  - `[openclaw-ws] Pairing rejected — device is not paired`
+  - `openclaw devices approve <requestId>` (actionable command printed in logs)
   - WebSocket close code `1008` (policy violation)
 - You can poll messages via API/MCP, but inbound events are not auto-injected into UI.
 - Thread/channel markers may be visible to others, but not injected locally.
 
-### Why this happens
+### How device pairing works
+
+OpenClaw's gateway requires **device pairing** — a one-time approval step per device identity.
+The relay gateway generates an Ed25519 keypair and persists it to `~/.openclaw/workspace/relaycast/device.json`.
+This identity is reused across restarts, so you only need to approve it once.
+
+**Key points:**
+- The device identity file (`device.json`) must survive restarts — if deleted, a new identity is generated and needs re-approval
+- The gateway token (`OPENCLAW_GATEWAY_TOKEN`) authenticates the connection, but the device still needs to be separately paired
+- Pairing is an intentional human/owner authorization step — it cannot be auto-approved
+
+### Why pairing fails
 
 Most common causes:
 
-1. **Device pairing not approved** for the local gateway WS client
-2. **Home-directory mismatch** (`OPENCLAW_HOME`) between OpenClaw and relay-openclaw
-3. **Wrong/missing gateway token** (`OPENCLAW_GATEWAY_TOKEN`)
-4. **Duplicate relay gateway processes** causing inconsistent local delivery behavior
-5. **Port/process mismatch** (OpenClaw WS on 18789 vs relay control port 18790)
+1. **Device not yet approved** — first connection with a new device identity requires manual approval
+2. **Device identity regenerated** — `device.json` was deleted or `OPENCLAW_HOME` changed, creating a new identity
+3. **Home-directory mismatch** (`OPENCLAW_HOME`) between OpenClaw and relay-openclaw
+4. **Wrong/missing gateway token** (`OPENCLAW_GATEWAY_TOKEN`)
+5. **Duplicate relay gateway processes** — each spawns its own device identity
+6. **Port/process mismatch** (OpenClaw WS on 18789 vs relay control port 18790)
+
+### Step 1: Find the request ID and approve
+
+When pairing fails, the gateway logs print the exact approval command:
+
+```
+[openclaw-ws] Pairing rejected — device is not paired with the OpenClaw gateway.
+[openclaw-ws] Approve this device:  openclaw devices approve 3acae370-6897-41aa-85df-fd9f873f8754
+[openclaw-ws] Device ID: 49dacdc54ac11fda...
+```
+
+Run the printed command:
+
+```bash
+openclaw devices approve <requestId>
+```
+
+If gateway logs don't print the approve command (e.g. requestId only appears in the JSON payload), run:
+
+```bash
+openclaw devices list
+```
+
+Approve the newest `Pending` request from that list.
+
+> **Note:** `openclaw devices list` may itself error with "pairing required" if your CLI device isn't paired or admin-scoped. If so, re-run after approving the gateway device, or use the local fallback in the recovery runbook below.
+
+### Step 2: Wait for auto-recovery (or restart)
+
+Newer versions (3.1.6+) retry every 60 seconds automatically after approval. Check logs for successful connection:
+
+```
+[openclaw-ws] Authenticated successfully
+[gateway] OpenClaw gateway WebSocket client ready
+```
+
+If the gateway stays in `NOT_PAIRED` state after approval (or you're on an older version), restart manually:
 
-### Recovery Runbook (copy/paste)
+```bash
+# Find the gateway PID explicitly — avoid broad pkill patterns
+ps aux | grep 'relay-openclaw gateway' | grep -v grep
+kill <pid>
+
+# Restart
+nohup npx -y @agent-relay/openclaw@latest gateway > /tmp/relaycast-gateway.log 2>&1 &
+```
+
+### Full Recovery Runbook (nuclear option)
 
-> Replace `REQUEST_ID_HERE` with the request ID from your logs (if present).
+Use this if the above steps don't work, or if the environment is in a bad state.
 
 ```bash
 # 0) Inspect current listeners
-# Confirm OpenClaw gateway WS listener (usually 127.0.0.1:18789)
 lsof -iTCP:18789 -sTCP:LISTEN || netstat -ltnp 2>/dev/null | grep 18789 || true
 
-# 1) Approve pending pairing request (if logs include requestId)
-openclaw devices approve REQUEST_ID_HERE
+# 1) List and approve all pending pairing requests
+openclaw devices list
+openclaw devices approve <requestId>
 
-# 2) Stop relay-openclaw inbound gateway duplicates
-pkill -f 'relay-openclaw gateway' || true
+# 2) Stop relay-openclaw inbound gateway duplicates (find PID explicitly)
+ps aux | grep 'relay-openclaw gateway' | grep -v grep
+kill <pid>  # use the PID from above
 
-# 3) Force a single, explicit OpenClaw config context
+# 3) Verify device identity exists (do NOT delete — that forces re-pairing)
+# With jq:
+cat ~/.openclaw/workspace/relaycast/device.json | jq .deviceId
+# Without jq:
+python3 -c "import json; print(json.load(open('$HOME/.openclaw/workspace/relaycast/device.json'))['deviceId'])"
+
+# 4) Force a single, explicit OpenClaw config context
 export OPENCLAW_HOME="$HOME/.openclaw"
+# With jq:
 export OPENCLAW_GATEWAY_TOKEN="$(jq -r '.gateway.auth.token' "$OPENCLAW_HOME/openclaw.json")"
 export OPENCLAW_GATEWAY_PORT="$(jq -r '.gateway.port // 18789' "$OPENCLAW_HOME/openclaw.json")"
+# Without jq:
+export OPENCLAW_GATEWAY_TOKEN="$(python3 -c "import json; c=json.load(open('$OPENCLAW_HOME/openclaw.json')); print(c.get('gateway',{}).get('auth',{}).get('token',''))")"
+export OPENCLAW_GATEWAY_PORT="$(python3 -c "import json; c=json.load(open('$OPENCLAW_HOME/openclaw.json')); print(c.get('gateway',{}).get('port',18789))")"
 export RELAYCAST_CONTROL_PORT=18790
 
-# 4) Start exactly one inbound gateway
+# 5) Start exactly one inbound gateway
 nohup npx -y @agent-relay/openclaw@latest gateway > /tmp/relaycast-gateway.log 2>&1 &
 
-# 5) Verify logs no longer show pairing failures
-tail -n 120 /tmp/relaycast-gateway.log
+# 6) Verify logs show successful authentication
+tail -f /tmp/relaycast-gateway.log
 ```
 
 ### Validation checklist
@@ -291,19 +389,23 @@ Confirm what appears auto-injected in your UI stream:
 - Thread: yes/no
 - DM: yes/no
 
-> Note: DM **delivery** can work even when DM auto-injection is runtime-dependent.
+> Note: If any of these fail to inject, check gateway pairing/auth first (Section 11 above).
 
 ### Quick diagnostic matrix
 
 | Symptom | Likely Cause | Fix |
 |---|---|---|
-| `pairing-required`, `not-paired`, code 1008 | device not paired / wrong token | approve request + verify `OPENCLAW_GATEWAY_TOKEN` from same `OPENCLAW_HOME` |
-| Polling works, injection fails | local WS auth/topology issue | run recovery runbook above |
+| `Pairing rejected` with requestId in logs | device not approved | run `openclaw devices approve <requestId>` from the log output |
+| `pairing-required` after restart | `device.json` deleted or `OPENCLAW_HOME` changed | check `~/.openclaw/workspace/relaycast/device.json` exists; re-approve if needed |
+| Polling works, injection fails | local WS auth/topology issue | run full recovery runbook above |
 | Setup succeeds but no MCP tools | `mcporter` missing from PATH | install/verify `mcporter`, re-run setup |
 | `Not registered` in mcporter calls | missing/cleared `RELAY_AGENT_TOKEN` | restore token in `~/.mcporter/mcporter.json` and retry |
+| `Invalid agent token` in mcporter calls | stale or corrupted `RELAY_AGENT_TOKEN` | re-run `npx -y @agent-relay/openclaw@latest setup rk_live_KEY --name my-claw` to refresh token |
+| Gateway doesn't auto-recover after approval | older version or retry not triggered | upgrade to `@agent-relay/openclaw@latest` (3.1.6+); if still stuck, restart gateway manually (see Step 2) |
 
 ### Hardening recommendations
 
+- **Never delete `device.json`** — it contains the persisted device identity. Deleting it forces a new pairing request.
 - Keep one OpenClaw gateway and one relay inbound gateway per runtime.
 - Ensure setup and runtime both use the same `OPENCLAW_HOME`.
 - Prefer explicit env exports in hosted/sandbox deployments.
@@ -311,6 +413,63 @@ Confirm what appears auto-injected in your UI stream:
 
 ---
 
+## 11b) Advanced Troubleshooting: Execution Policy Lockdown
+
+Use this section when OpenClaw is running but the agent can only chat — it can't execute commands, call APIs, or run skills.
+
+### Typical symptoms
+
+- Agent responds to messages but never executes any tools or commands
+- Skills load but produce no output or hang indefinitely
+- Shell commands timeout or silently fail
+- The agent appears "stuck in a sandbox" — it's a chatbot only
+
+### Root cause
+
+By default, OpenClaw runs in a restricted sandbox mode. It can't make network calls, run shell commands, or write to most directories. On a headless server (VPS, droplet), this is compounded by the lack of an interactive terminal for approval prompts.
+
+Three execution policies must be configured for the agent to function beyond chat:
+
+### Fix: Set execution policies
+
+SSH into the server and run as root:
+
+```bash
+/opt/openclaw-cli.sh config set tools.exec.host gateway
+/opt/openclaw-cli.sh config set tools.exec.ask off
+/opt/openclaw-cli.sh config set tools.exec.security full
+systemctl restart openclaw
+```
+
+### What each setting does
+
+| Setting | Value | Purpose |
+|---|---|---|
+| `tools.exec.host` | `gateway` | Routes commands through the gateway process. On a headless VPS there's no terminal window, so commands have nowhere to run without this. |
+| `tools.exec.ask` | `off` | Disables interactive approval prompts. On a headless server nobody is there to approve, so commands hang forever waiting. |
+| `tools.exec.security` | `full` | Grants the highest execution tier within the sandbox. Without this, the agent can't make network calls or run shell commands. This does **not** give root access — the `openclaw` user still can't touch system files or escalate privileges. |
+
+### Verify settings
+
+```bash
+/opt/openclaw-cli.sh config list | grep tools.exec
+```
+
+Expected output should show: `host: gateway`, `ask: off`, `security: full`.
+
+> **Note:** If `device signature invalid` appears before any pending pairing requests, this is a **protocol mismatch** (not a pairing queue issue). Jump to WS-compat diagnostics in Section 10 rather than attempting device approval.
+
+### Quick diagnostic
+
+| Symptom | Likely Cause | Fix |
+|---|---|---|
+| Agent chats but can't execute anything | Sandbox default policies | Set all three execution policies above |
+| Commands hang forever | `tools.exec.ask` still on (waiting for approval) | Set `tools.exec.ask off` and restart |
+| Network calls fail from agent | `tools.exec.security` not set to `full` | Set `tools.exec.security full` and restart |
+| Commands fail silently | `tools.exec.host` not set to `gateway` | Set `tools.exec.host gateway` and restart |
+
+---
+
 ## 12) Optional Direct API (curl)
 
 ```bash

package/packages/openclaw/src/cli.ts

@@ -7,7 +7,13 @@ import { startMcpServer } from './mcp/server.js';
 import { runtimeSetup } from './runtime/setup.js';
 
 const require = createRequire(import.meta.url);
-const { version } = require('../package.json') as { version: string };
+const version = process.env.RELAY_OPENCLAW_VERSION ?? (() => {
+  try {
+    return (require('../package.json') as { version: string }).version;
+  } catch {
+    return 'unknown';
+  }
+})();
 
 function printUsage(): void {
   console.log(`