openclaw-overlay-plugin 0.7.65 → 0.7.67

package/dist/src/scripts/baemail/commands.js

@@ -1,126 +1,83 @@
-/**
- * Baemail commands - paid message forwarding service.
- */
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import os from 'node:os';
 import fs from 'node:fs';
-import { PATHS } from '../config.js';
+import process from 'node:process';
 import { ok, fail } from '../output.js';
 import { loadIdentity } from '../wallet/identity.js';
-import { ensureStateDir } from '../utils/storage.js';
-import { fetchWithTimeout } from '../utils/woc.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Define paths relative to home directory
+const PATHS = {
+    walletIdentity: path.join(os.homedir(), '.openclaw', 'bsv-wallet', 'wallet-identity.json'),
+    baemailLog: path.join(os.homedir(), '.openclaw', 'openclaw-overlay', 'baemail-deliveries.jsonl'),
+    baemailConfig: path.join(os.homedir(), '.openclaw', 'openclaw-overlay', 'baemail-config.json'),
+    baemailBlocklist: path.join(os.homedir(), '.openclaw', 'openclaw-overlay', 'baemail-blocklist.json'),
+};
 /**
- * Load baemail configuration.
+ * Log a baemail delivery event.
  */
-export function loadBaemailConfig() {
+export function logBaemailDelivery(entry) {
     try {
-        if (fs.existsSync(PATHS.baemailConfig)) {
-            return JSON.parse(fs.readFileSync(PATHS.baemailConfig, 'utf-8'));
-        }
+        const dir = path.dirname(PATHS.baemailLog);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.appendFileSync(PATHS.baemailLog, JSON.stringify({ ...entry, ts: Date.now() }) + '\n');
     }
-    catch (err) {
-        console.warn(`[baemail] Warning: Could not read config: ${err.message}`);
-    }
-    return null;
-}
-/**
- * Save baemail configuration.
- */
-export function saveBaemailConfig(config) {
-    ensureStateDir();
-    fs.writeFileSync(PATHS.baemailConfig, JSON.stringify(config, null, 2));
+    catch { }
 }
-/**
- * Setup baemail service with delivery channel and tier pricing.
- */
-export async function cmdBaemailSetup(channel, standardStr, priorityStr, urgentStr) {
-    if (!channel || !standardStr) {
-        return fail('Usage: baemail-setup <channel> <standardSats> [prioritySats] [urgentSats]');
-    }
-    const standard = parseInt(standardStr, 10);
-    const priority = priorityStr ? parseInt(priorityStr, 10) : standard * 2;
-    const urgent = urgentStr ? parseInt(urgentStr, 10) : standard * 5;
-    if (isNaN(standard) || standard < 1) {
-        return fail('Standard rate must be a positive integer (sats)');
-    }
-    if (priority < standard) {
-        return fail('Priority rate must be >= standard rate');
-    }
-    if (urgent < priority) {
-        return fail('Urgent rate must be >= priority rate');
-    }
-    const config = {
-        deliveryChannel: channel,
-        tiers: { standard, priority, urgent },
-        maxMessageLength: 4000,
+export async function loadBaemailConfig() {
+    const defaults = {
+        enabled: true,
+        priceSats: 100,
+        autoRefund: true,
         blocklist: [],
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
+        maxMessageLength: 4000,
+        deliveryChannel: 'agent-hook',
+        tiers: {
+            standard: 100,
+            priority: 500,
+            urgent: 1000
+        }
     };
-    saveBaemailConfig(config);
-    return ok({
-        configured: true,
-        deliveryChannel: channel,
-        tiers: config.tiers,
-        note: `Advertise with: cli advertise baemail "Baemail" "Paid message forwarding. Pay ${standard}+ sats to reach me." ${standard}`,
-    });
-}
-/**
- * View current baemail configuration.
- */
-export async function cmdBaemailConfig() {
-    const config = loadBaemailConfig();
-    if (!config) {
-        return fail('Baemail not configured. Run: baemail-setup <channel> <standardSats> [prioritySats] [urgentSats]');
+    if (!fs.existsSync(PATHS.baemailConfig)) {
+        return defaults;
     }
-    return ok(config);
-}
-/**
- * Block a sender from using baemail.
- */
-export async function cmdBaemailBlock(identityKey) {
-    if (!identityKey)
-        return fail('Usage: baemail-block <identityKey>');
-    const config = loadBaemailConfig();
-    if (!config) {
-        return fail('Baemail not configured. Run baemail-setup first.');
+    try {
+        const config = JSON.parse(fs.readFileSync(PATHS.baemailConfig, 'utf-8'));
+        return { ...defaults, ...config };
     }
-    if (!config.blocklist)
-        config.blocklist = [];
-    if (config.blocklist.includes(identityKey)) {
-        return fail('Identity already blocked');
+    catch {
+        return defaults;
     }
-    config.blocklist.push(identityKey);
-    config.updatedAt = new Date().toISOString();
-    saveBaemailConfig(config);
-    return ok({ blocked: identityKey, totalBlocked: config.blocklist.length });
 }
-/**
- * Unblock a sender.
- */
-export async function cmdBaemailUnblock(identityKey) {
-    if (!identityKey)
-        return fail('Usage: baemail-unblock <identityKey>');
-    const config = loadBaemailConfig();
-    if (!config) {
-        return fail('Baemail not configured. Run baemail-setup first.');
+async function fetchWithTimeout(url, options = {}) {
+    const { timeout = 15000 } = options;
+    const controller = new AbortController();
+    const id = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal
+        });
+        clearTimeout(id);
+        return response;
     }
-    if (!config.blocklist || !config.blocklist.includes(identityKey)) {
-        return fail('Identity not in blocklist');
+    catch (err) {
+        clearTimeout(id);
+        throw err;
     }
-    config.blocklist = config.blocklist.filter(k => k !== identityKey);
-    config.updatedAt = new Date().toISOString();
-    saveBaemailConfig(config);
-    return ok({ unblocked: identityKey, totalBlocked: config.blocklist.length });
 }
 /**
- * View baemail delivery log.
+ * List recent baemail deliveries.
  */
 export async function cmdBaemailLog(limitStr) {
     const limit = parseInt(limitStr || '20', 10) || 20;
     if (!fs.existsSync(PATHS.baemailLog)) {
         return ok({ log: [], count: 0 });
     }
-    const lines = fs.readFileSync(PATHS.baemailLog, 'utf-8').split('\n').filter(l => l.trim());
-    const entries = lines.map(l => {
+    const lines = fs.readFileSync(PATHS.baemailLog, 'utf-8').split('\n').filter((l) => l.trim());
+    const entries = lines.map((l) => {
         try {
             return JSON.parse(l);
         }
@@ -131,6 +88,60 @@ export async function cmdBaemailLog(limitStr) {
     const recent = entries.slice(-limit).reverse();
     return ok({ log: recent, count: entries.length, showing: recent.length });
 }
+export async function cmdBaemailSetup(priceSatsStr, prioritySats, urgentSats, channel) {
+    const standard = parseInt(priceSatsStr, 10) || 100;
+    const priority = parseInt(prioritySats || '', 10) || (standard * 5);
+    const urgent = parseInt(urgentSats || '', 10) || (standard * 10);
+    const config = {
+        enabled: true,
+        priceSats: standard,
+        autoRefund: true,
+        deliveryChannel: channel || 'agent-hook',
+        tiers: { standard, priority, urgent }
+    };
+    const dir = path.dirname(PATHS.baemailConfig);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(PATHS.baemailConfig, JSON.stringify(config, null, 2));
+    return ok({ message: `Baemail setup complete.`, config });
+}
+export async function cmdBaemailConfig() {
+    const config = await loadBaemailConfig();
+    return ok(config);
+}
+export async function cmdBaemailBlock(pubkey) {
+    if (!pubkey)
+        return fail('Usage: baemail-block <pubkey>');
+    let blocklist = [];
+    if (fs.existsSync(PATHS.baemailBlocklist)) {
+        try {
+            blocklist = JSON.parse(fs.readFileSync(PATHS.baemailBlocklist, 'utf-8'));
+        }
+        catch {
+            blocklist = [];
+        }
+    }
+    if (!blocklist.includes(pubkey))
+        blocklist.push(pubkey);
+    fs.writeFileSync(PATHS.baemailBlocklist, JSON.stringify(blocklist, null, 2));
+    return ok({ blocked: true, pubkey, count: blocklist.length });
+}
+export async function cmdBaemailUnblock(pubkey) {
+    if (!pubkey)
+        return fail('Usage: baemail-unblock <pubkey>');
+    let blocklist = [];
+    if (fs.existsSync(PATHS.baemailBlocklist)) {
+        try {
+            blocklist = JSON.parse(fs.readFileSync(PATHS.baemailBlocklist, 'utf-8'));
+        }
+        catch {
+            blocklist = [];
+        }
+    }
+    blocklist = blocklist.filter(p => p !== pubkey);
+    fs.writeFileSync(PATHS.baemailBlocklist, JSON.stringify(blocklist, null, 2));
+    return ok({ unblocked: true, pubkey, count: blocklist.length });
+}
 /**
  * Refund a failed baemail delivery.
  */
@@ -141,7 +152,7 @@ export async function cmdBaemailRefund(requestId) {
         return fail('No baemail log found');
     }
     // Find the entry
-    const lines = fs.readFileSync(PATHS.baemailLog, 'utf-8').split('\n').filter(l => l.trim());
+    const lines = fs.readFileSync(PATHS.baemailLog, 'utf-8').split('\n').filter((l) => l.trim());
     const entries = lines.map((l, idx) => {
         try {
             return { ...JSON.parse(l), _lineIdx: idx };
@@ -225,7 +236,7 @@ export async function cmdBaemailRefund(requestId) {
         }
         await tx.sign();
         // Broadcast using configured ARC/Arcade URL or fallback to WhatsOnChain
-        const arcUrl = process['en' + 'v'].BSV_ARC_URL;
+        const arcUrl = process['env'].BSV_ARC_URL;
         let broadcastResp;
         if (arcUrl) {
             broadcastResp = await fetchWithTimeout(`${arcUrl.replace(/\/$/, '')}/v1/tx`, {

package/dist/src/scripts/baemail/handler.js

@@ -30,7 +30,7 @@ export async function processBaemail(msg, identityKey, privKey) {
     const input = (msg.payload?.input || msg.payload);
     const payment = msg.payload?.payment;
     // Load config
-    const config = loadBaemailConfig();
+    const config = await loadBaemailConfig();
     if (!config) {
         const rejectPayload = {
             requestId: msg.id,
@@ -238,7 +238,7 @@ _Reply via overlay: \`cli send ${replyKey} ping "your reply"\`_`;
         deliverySuccess,
         deliveryError: deliveryError ?? null,
         paymentTxid: payResult.txid || '',
-        refundStatus: deliverySuccess ? null : 'pending',
+        refundStatus: deliverySuccess ? undefined : 'pending',
         timestamp: new Date().toISOString(),
     };
     fs.appendFileSync(PATHS.baemailLog, JSON.stringify(logEntry) + '\n');

package/dist/src/scripts/services/respond.js

@@ -118,7 +118,7 @@ export async function cmdResearchRespond(resultJsonPath) {
     // Remove from queue
     if (fs.existsSync(PATHS.researchQueue)) {
         const lines = fs.readFileSync(PATHS.researchQueue, 'utf-8').trim().split('\n').filter(Boolean);
-        const remaining = lines.filter(l => {
+        const remaining = lines.filter((l) => {
             try {
                 return JSON.parse(l).requestId !== requestId;
             }

package/dist/src/scripts/utils/storage.js

@@ -97,7 +97,7 @@ export function readJsonl(filePath) {
     if (!fs.existsSync(filePath))
         return [];
     const lines = fs.readFileSync(filePath, 'utf-8').trim().split('\n').filter(Boolean);
-    return lines.map(line => {
+    return lines.map((line) => {
         try {
             return JSON.parse(line);
         }

package/dist/src/test/request-response-flow.test.js

@@ -3,6 +3,7 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import process from 'node:process';
 // Simple test runner (matching existing pattern)
 let passed = 0;
 let failed = 0;
@@ -106,12 +107,12 @@ async function run() {
         mockCleanupServiceQueue(24 * 60 * 60 * 1000, 2 * 60 * 60 * 1000);
         // Check remaining entries
         const lines = fs.readFileSync(TEST_PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
-        const remaining = lines.map(line => JSON.parse(line));
+        const remaining = lines.map((line) => JSON.parse(line));
         assert(remaining.length === 2, `Expected 2 remaining entries, got ${remaining.length}`);
-        assert(remaining.find(e => e.requestId === 'pending-1') !== undefined, 'Should keep recent pending');
-        assert(remaining.find(e => e.requestId === 'recent-fulfilled') !== undefined, 'Should keep recent fulfilled');
-        assert(remaining.find(e => e.requestId === 'old-fulfilled') === undefined, 'Should remove old fulfilled');
-        assert(remaining.find(e => e.requestId === 'old-rejected') === undefined, 'Should remove old rejected');
+        assert(remaining.find((e) => e.requestId === 'pending-1') !== undefined, 'Should keep recent pending');
+        assert(remaining.find((e) => e.requestId === 'recent-fulfilled') !== undefined, 'Should keep recent fulfilled');
+        assert(remaining.find((e) => e.requestId === 'old-fulfilled') === undefined, 'Should remove old fulfilled');
+        assert(remaining.find((e) => e.requestId === 'old-rejected') === undefined, 'Should remove old rejected');
         cleanupTestEnv();
     });
     await test('updateServiceQueueStatus updates request status atomically', async () => {
@@ -131,7 +132,7 @@ async function run() {
                 return false;
             const lines = fs.readFileSync(TEST_PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
             let updated = false;
-            const updatedLines = lines.map(line => {
+            const updatedLines = lines.map((line) => {
                 try {
                     const entryData = JSON.parse(line);
                     if (entryData.requestId === requestId) {
@@ -178,7 +179,7 @@ async function run() {
                 return false;
             const lines = fs.readFileSync(TEST_PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
             let updated = false;
-            lines.map(line => {
+            lines.map((line) => {
                 try {
                     const entry = JSON.parse(line);
                     if (entry.requestId === requestId) {

package/index.ts

@@ -9,10 +9,15 @@ import path from 'node:path';
 import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
+import process from 'node:process';
+import { Buffer } from 'node:buffer';
 import { initializeServiceSystem, serviceManager } from './src/services/index.js';
+
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+let isInitialized = false;
+
 async function ensureCp() {
   if (execFileAsync) return;
   // @ts-ignore
@@ -71,7 +76,7 @@ function loadDailySpending(walletDir: string): DailySpending {
 }
 
 function writeActivityEvent(event: any) {
-  const alertDir = path.join((process as any)['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay');
+  const alertDir = path.join((process as any)['env'].HOME || '', '.openclaw', 'openclaw-overlay');
   try {
     fs.mkdirSync(alertDir, { recursive: true });
     fs.appendFileSync(path.join(alertDir, 'activity-feed.jsonl'), JSON.stringify({ ...event, ts: Date.now() }) + '\n');
@@ -130,7 +135,7 @@ async function startAutoImport(env: any, cliPath: string, logger: any) {
               
               // Clear onboarding flag since wallet is now funded
               try {
-                const onboardingSentFile = path.join((process as any)['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
+                const onboardingSentFile = path.join((process as any)['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
                 if (fs.existsSync(onboardingSentFile)) {
                   fs.unlinkSync(onboardingSentFile);
                 }
@@ -141,7 +146,7 @@ async function startAutoImport(env: any, cliPath: string, logger: any) {
 
               // Check if registered, auto-register if not
               try {
-                const regPath = path.join((process as any)['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
+                const regPath = path.join((process as any)['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
                 if (!fs.existsSync(regPath)) {
                   logger?.info?.('[openclaw-overlay] Not yet registered — auto-registering...');
                   const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
@@ -208,7 +213,7 @@ async function autoAdvertiseServices(env: any, cliPath: string, logger: any) {
 
 function wakeAgent(text: string, logger: any, options: { sessionKey?: string } = {}) {
   const sessionKey = options.sessionKey || `hook:openclaw-overlay:${Date.now()}`;
-  const gatewayPort = (process as any)['en' + 'v'].OPENCLAW_GATEWAY_PORT || '18789';
+  const gatewayPort = (process as any)['env'].OPENCLAW_GATEWAY_PORT || '18789';
   const httpToken = getHooksToken();
   if (!httpToken) return;
 
@@ -220,7 +225,7 @@ function wakeAgent(text: string, logger: any, options: { sessionKey?: string } =
 }
 
 function getHooksToken(): string | null {
-  let token = (process as any)['en' + 'v'].OPENCLAW_HOOKS_TOKEN || null;
+  let token = (process as any)['env'].OPENCLAW_HOOKS_TOKEN || null;
   if (!token) {
     try {
       const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
@@ -275,7 +280,7 @@ function startBackgroundService(env: any, cliPath: string, logger: any) {
           }
           const notif = categorizeEvent(event);
           if (notif) {
-            const dir = path.join((process as any)['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay');
+            const dir = path.join((process as any)['env'].HOME || '', '.openclaw', 'openclaw-overlay');
             fs.mkdirSync(dir, { recursive: true });
             fs.appendFileSync(path.join(dir, 'activity-feed.jsonl'), JSON.stringify(notif) + '\n');
           }
@@ -299,101 +304,112 @@ function stopBackgroundService() {
   stopAutoImport();
 }
 
-export async function activate(api: any) {
-  return register(api);
-}
-
-let isInitialized = false;
-
 function getCliPath() {
   const base = __dirname.endsWith('dist') ? __dirname : path.join(__dirname, 'dist');
   return path.join(base, 'src', 'cli.js');
 }
 
-export default function register(api: any) {
-  if (isInitialized) return;
-  isInitialized = true;
-
-  const entries = api.getConfig?.()?.plugins?.entries || {};
-  const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
-  const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
-
-  // 1. Tool
-  api.registerTool({
-    name: "overlay",
-    description: "Access the BSV agent marketplace",
-    parameters: {
-      type: "object",
-      properties: {
-        action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
-        service: { type: "string" },
-        input: { type: "object" },
-        identityKey: { type: "string" },
-        sats: { type: "number" },
-        requestId: { type: "string" },
-        recipientKey: { type: "string" },
-        serviceId: { type: "string" },
-        result: { type: "object" }
+/**
+ * OpenClaw Overlay Plugin
+ * Decentralized agent marketplace with BSV micropayments.
+ */
+export const plugin = {
+  id: "openclaw-overlay-plugin",
+  name: "BSV Overlay Network",
+  description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
+  
+  async activate(api: any) {
+    return this.register(api);
+  },
+
+  register(api: any) {
+    if (isInitialized) return;
+    isInitialized = true;
+
+    const entries = api.getConfig?.()?.plugins?.entries || {};
+    const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
+    const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
+
+    // 1. Tool
+    api.registerTool({
+      name: "overlay",
+      description: "Access the BSV agent marketplace",
+      parameters: {
+        type: "object",
+        properties: {
+          action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
+          service: { type: "string" },
+          input: { type: "object" },
+          identityKey: { type: "string" },
+          sats: { type: "number" },
+          requestId: { type: "string" },
+          recipientKey: { type: "string" },
+          serviceId: { type: "string" },
+          result: { type: "object" }
+        },
+        required: ["action"]
       },
-      required: ["action"]
-    },
-    async execute(_id: string, params: any) {
-      try {
-        return await executeOverlayAction(params, pluginConfig, api);
-      } catch (error: any) {
-        return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+      async execute(_id: string, params: any) {
+        try {
+          return await executeOverlayAction(params, pluginConfig, api);
+        } catch (error: any) {
+          return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+        }
       }
-    }
-  });
-
-  // 2. Command
-  api.registerCommand({
-    name: "overlay",
-    description: "BSV Overlay Marketplace commands",
-    acceptsArgs: true,
-    handler: async (ctx: any) => {
-      try {
-        const action = ctx.args?.[0] || 'status';
+    });
 
-        if (action === 'help') {
-          return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
-        }
+    // 2. Command
+    api.registerCommand({
+      name: "overlay",
+      description: "BSV Overlay Marketplace commands",
+      acceptsArgs: true,
+      requireAuth: true,
+      handler: async (ctx: any) => {
+        try {
+          const action = ctx.args?.[0] || 'status';
 
-        const result = await executeOverlayAction({ action }, pluginConfig, api);
-        return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
-      } catch (error: any) {
-        return { text: `❌ Error: ${error.message}` };
+          if (action === 'help') {
+            return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
+          }
+
+          const result = await executeOverlayAction({ action }, pluginConfig, api);
+          return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
+        } catch (error: any) {
+          return { text: `❌ Error: ${error.message}` };
+        }
       }
-    }
-  });
-
-  // 3. Service
-  api.registerService({
-    id: "openclaw-overlay-relay",
-    start: async () => {
-      const env = buildEnvironment(pluginConfig);
-      const cliPath = getCliPath();
-      startBackgroundService(env, cliPath, api.logger);
-      startAutoImport(env, cliPath, api.logger);
-    },
-    stop: () => stopBackgroundService()
-  });
-
-  // 4. CLI
-  api.registerCli(({ program }: any) => {
-    const overlay = program.command("overlay").description("BSV Overlay Network management");
-    overlay.command("status").action(async () => {
-      await ensureCp();
-      const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
-      console.log(JSON.stringify(result, null, 2));
     });
-    overlay.command("balance").action(async () => {
-      await ensureCp();
-      const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
-      console.log(JSON.stringify(result, null, 2));
+
+    // 3. Service
+    api.registerService({
+      id: "openclaw-overlay-relay",
+      start: async () => {
+        const env = buildEnvironment(pluginConfig);
+        const cliPath = getCliPath();
+        startBackgroundService(env, cliPath, api.logger);
+        startAutoImport(env, cliPath, api.logger);
+      },
+      stop: () => stopBackgroundService()
     });
-  }, { commands: ["overlay"] });
-}
+
+    // 4. CLI
+    api.registerCli(({ program }: any) => {
+      const overlay = program.command("overlay").description("BSV Overlay Network management");
+      overlay.command("status").action(async () => {
+        await ensureCp();
+        const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
+        console.log(JSON.stringify(result, null, 2));
+      });
+      overlay.command("balance").action(async () => {
+        await ensureCp();
+        const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
+        console.log(JSON.stringify(result, null, 2));
+      });
+    }, { descriptors: [{ name: "overlay", description: "BSV Overlay Network management" }] });
+  }
+};
+
+export default plugin;
 
 async function executeOverlayAction(params: any, config: any, api: any) {
   await ensureCp();
@@ -472,7 +488,7 @@ async function handleFulfill(params: any, env: any, cliPath: string) {
 }
 
 function buildEnvironment(config: any) {
-  const env = { ...(process as any)['en' + 'v'] };
+  const env = { ...(process as any)['env'] };
   env.BSV_WALLET_DIR = config.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
   env.OVERLAY_URL = config.overlayUrl || 'https://clawoverlay.com';
   env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';