@reefclaw/connect 0.1.15 → 0.1.16

package/assets/bridge/gateway/gateway-ws-client.js

@@ -280,7 +280,15 @@ export class GatewayWsClient {
                     mode: 'backend',
                 },
                 role: 'operator',
-                scopes: ['operator.read', 'operator.write'],
+                // operator.admin: cron management (the boot-time heartbeat-cron ensure
+                // calls cron.list/cron.add) moved behind the admin scope on OpenClaw
+                // 2026.7.x — observed live on the first real npx onboarding
+                // ("Heartbeat cron: skipped (missing scope: operator.admin)",
+                // 2026-07-22, openclaw 2026.7.1-2). The gateway is localhost-bound and
+                // this connection already holds operator.write (orders, chat), so the
+                // marginal grant is small; without it fresh 2026.7.x installs never
+                // get a heartbeat cron.
+                scopes: ['operator.read', 'operator.write', 'operator.admin'],
                 auth: {
                     token: this.gatewayToken,
                     ...(this.deviceToken && { deviceToken: this.deviceToken }),

package/assets/bridge/gateway/heartbeat-cron.js

@@ -58,20 +58,35 @@ export async function ensureHeartbeatCron(opts) {
             log(`Heartbeat cron: already exists (${String(existing.name)})`);
             return 'found_existing';
         }
-        // Parity with the params the CLI built for the old setup command
+        // First attempt mirrors the params the CLI built for the old setup command
         // (`openclaw cron add --name reefclaw-heartbeat --every 15m --session isolated --message ...`):
-        // isolated agentTurn defaults to delivery announce on the 'last' channel.
-        await rpc.sendRpc('cron.add', {
+        // isolated agentTurn defaults to delivery announce on the 'last' channel —
+        // right for boxes with a chat channel (the heartbeat's summary reaches the
+        // operator). On a FRESH box with no channels configured, cron.add REJECTS
+        // announce/'last' (no resolvable recipient — observed live on a first
+        // real npx onboarding, 2026-07-22; the old setup-time CLI path failed the
+        // same way, silently). Fall back to delivery mode 'none': a heartbeat that
+        // runs without announcing beats no heartbeat at all, and the operator sees
+        // the results on the dashboard anyway.
+        const baseJob = {
             name: HEARTBEAT_CRON_NAME,
             enabled: true,
             schedule: { kind: 'every', everyMs: HEARTBEAT_EVERY_MS },
             sessionTarget: 'isolated',
             wakeMode: 'now',
             payload: { kind: 'agentTurn', message: HEARTBEAT_MESSAGE },
-            delivery: { mode: 'announce', channel: 'last' },
-        });
-        writeMarker(markerPath, { ensuredAt: new Date().toISOString(), created: HEARTBEAT_CRON_NAME });
-        log(`Heartbeat cron: created (${HEARTBEAT_CRON_NAME}, every 15m)`);
+        };
+        let delivery = 'announce';
+        try {
+            await rpc.sendRpc('cron.add', { ...baseJob, delivery: { mode: 'announce', channel: 'last' } });
+        }
+        catch (addErr) {
+            log(`Heartbeat cron: announce delivery rejected (${addErr instanceof Error ? addErr.message.split('\n')[0] : String(addErr)}) — retrying without delivery`);
+            await rpc.sendRpc('cron.add', { ...baseJob, delivery: { mode: 'none' } });
+            delivery = 'none';
+        }
+        writeMarker(markerPath, { ensuredAt: new Date().toISOString(), created: HEARTBEAT_CRON_NAME, delivery });
+        log(`Heartbeat cron: created (${HEARTBEAT_CRON_NAME}, every 15m, delivery=${delivery})`);
         return 'created';
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reefclaw/connect",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "One-command installer that connects your OpenClaw agent to ReefClaw (paper trading, no exchange keys).",
   "type": "module",
   "bin": {