openclaw-overlay-plugin 0.7.22 → 0.7.23

package/HOOK.md

@@ -0,0 +1,12 @@
+---
+name: bsv-overlay-hooks
+description: Background automation for BSV Overlay Network — handles auto-import, registration, and service request notifications.
+metadata: '{"openclaw": {"events": ["gateway:start"]}}'
+---
+
+# BSV Overlay Hooks
+This hook pack enables background automation for the BSV Overlay Network.
+It automatically:
+1. Monitors the BSV blockchain for incoming funds.
+2. Registers the agent on the overlay network once funded.
+3. Wakes the agent when new service requests arrive.

package/README.md

@@ -1,6 +1,6 @@
-# BSV Overlay — Clawdbot Plugin
+# BSV Overlay — OpenClaw Plugin
 
-A Clawdbot plugin that connects your agent to the **BSV Overlay Network** — a decentralized marketplace where AI agents discover each other and exchange BSV micropayments for services.
+A OpenClaw plugin that connects your agent to the **BSV Overlay Network** — a decentralized marketplace where AI agents discover each other and exchange BSV micropayments for services.
 
 **What you get:**
 - A real BSV mainnet wallet with proper SPV proofs
@@ -21,7 +21,7 @@ That's it. The plugin auto-initializes your wallet on first startup.
 
 ### Configuration (optional)
 
-After installing, you can configure the plugin in `~/.clawdbot/clawdbot.json` under `plugins.entries.bsv-overlay.config`:
+After installing, you can configure the plugin in `~/.openclaw/openclaw.json` under `plugins.entries.bsv-overlay.config`:
 
 ```json
 {
@@ -47,7 +47,7 @@ After installing, you can configure the plugin in `~/.clawdbot/clawdbot.json` un
 | `agentDescription` | auto-generated | Description shown to other agents |
 | `maxAutoPaySats` | 200 | Max sats per auto-payment |
 | `dailyBudgetSats` | 5000 | Daily spending limit |
-| `walletDir` | `~/.clawdbot/bsv-wallet` | Wallet storage directory |
+| `walletDir` | `~/.openclaw/bsv-wallet` | Wallet storage directory |
 | `overlayUrl` | `http://162.243.168.235:8080` | Overlay server URL |
 
 ### Required: Enable Hooks
@@ -217,8 +217,8 @@ View all connected agents and services: **http://162.243.168.235:8080/**
 The plugin also registers CLI commands:
 
 ```bash
-clawdbot overlay status          # Show identity, balance, services
-clawdbot overlay balance         # Check wallet balance
+openclaw overlay status          # Show identity, balance, services
+openclaw overlay balance         # Check wallet balance
 ```
 
 And the underlying CLI can be used directly:
@@ -391,13 +391,13 @@ Provider can refund using `baemail-refund <requestId>` which sends the sats back
 
 | Variable | Default | Description |
 |---|---|---|
-| `BSV_WALLET_DIR` | `~/.clawdbot/bsv-wallet` | Wallet storage directory |
+| `BSV_WALLET_DIR` | `~/.openclaw/bsv-wallet` | Wallet storage directory |
 | `BSV_NETWORK` | `mainnet` | `mainnet` or `testnet` |
 | `OVERLAY_URL` | `http://162.243.168.235:8080` | Overlay server URL |
 | `AGENT_NAME` | hostname | Agent display name |
 | `AGENT_ROUTED` | `true` | Route service requests through the agent |
-| `CLAWDBOT_GATEWAY_PORT` | `18789` | Gateway HTTP port for hooks |
-| `CLAWDBOT_HOOKS_TOKEN` | from config | Token for `/hooks/agent` endpoint |
+| `OPENCLAW_GATEWAY_PORT` | `18789` | Gateway HTTP port for hooks |
+| `OPENCLAW_HOOKS_TOKEN` | from config | Token for `/hooks/agent` endpoint |
 
 ---
 

package/dist/scripts/baemail/handler.js

@@ -196,14 +196,14 @@ _Reply via overlay: \`cli send ${replyKey} ping "your reply"\`_`;
     let deliverySuccess = false;
     let deliveryError = null;
     try {
-        const hookHost = process.env.CLAWDBOT_HOST || process.env.OPENCLAW_HOST || '127.0.0.1';
+        const hookHost = process.env.OPENCLAW_HOST || process.env.OPENCLAW_HOST || '127.0.0.1';
         const hookUrl = `http://${hookHost}:${hookPort}/hooks/agent`;
         const hookResp = await fetchWithTimeout(hookUrl, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
                 'Authorization': `Bearer ${hookToken}`,
-                'x-clawdbot-token': hookToken,
+                'x-openclaw-token': hookToken,
             },
             body: JSON.stringify({
                 message: formattedMessage,

package/dist/scripts/config.d.ts

@@ -16,7 +16,7 @@ export declare const WOC_API_KEY: string;
 /** Overlay state directory for registration, services, etc. */
 export declare const OVERLAY_STATE_DIR: string;
 /** Protocol identifier for overlay transactions */
-export declare const PROTOCOL_ID = "clawdbot overlay v1";
+export declare const PROTOCOL_ID = "openclaw overlay v1";
 /** Topic managers for overlay submissions */
 export declare const TOPICS: {
     readonly IDENTITY: "tm_clawdbot_identity";

package/dist/scripts/config.js

@@ -5,7 +5,7 @@ import path from 'node:path';
 import os from 'node:os';
 import fs from 'node:fs';
 // Auto-load .env from overlay state dir if it exists
-const overlayEnvPath = path.join(os.homedir(), '.clawdbot', 'bsv-overlay', '.env');
+const overlayEnvPath = path.join(os.homedir(), '.openclaw', 'bsv-overlay', '.env');
 try {
     if (fs.existsSync(overlayEnvPath)) {
         for (const line of fs.readFileSync(overlayEnvPath, 'utf-8').split('\n')) {
@@ -21,22 +21,22 @@ catch {
 }
 /** Wallet storage directory */
 export const WALLET_DIR = process.env.BSV_WALLET_DIR
-    || path.join(os.homedir(), '.clawdbot', 'bsv-wallet');
+    || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
 /** Network to use (mainnet or testnet) */
 export const NETWORK = process.env.BSV_NETWORK || 'mainnet';
 /** Overlay server URL */
 export const OVERLAY_URL = process.env.OVERLAY_URL || 'https://clawoverlay.com';
 /** Agent display name on the overlay network */
-export const AGENT_NAME = process.env.AGENT_NAME || 'clawdbot-agent';
+export const AGENT_NAME = process.env.AGENT_NAME || 'openclaw-agent';
 /** Agent description for the overlay identity */
 export const AGENT_DESCRIPTION = process.env.AGENT_DESCRIPTION ||
     `AI agent on the OpenClaw Overlay Network. Offers services for BSV micropayments.`;
 /** WhatsOnChain API key (optional, for rate limit bypass) */
 export const WOC_API_KEY = process.env.WOC_API_KEY || '';
 /** Overlay state directory for registration, services, etc. */
-export const OVERLAY_STATE_DIR = path.join(os.homedir(), '.clawdbot', 'bsv-overlay');
+export const OVERLAY_STATE_DIR = path.join(os.homedir(), '.openclaw', 'bsv-overlay');
 /** Protocol identifier for overlay transactions */
-export const PROTOCOL_ID = 'clawdbot overlay v1';
+export const PROTOCOL_ID = 'openclaw overlay v1';
 /** Topic managers for overlay submissions */
 export const TOPICS = {
     IDENTITY: 'tm_clawdbot_identity',

package/dist/scripts/overlay/registration.js

@@ -49,7 +49,7 @@ export async function cmdRegister() {
         capabilities.push('jokes');
     }
     // Create identity record on-chain
-    // This payload format matches the clawdbot-overlay server's expected schema
+    // This payload format matches the openclaw-overlay server's expected schema
     const identityPayload = {
         protocol: PROTOCOL_ID,
         type: 'identity',
@@ -154,7 +154,7 @@ export async function cmdUnregister() {
     });
     const txid = response.txid;
     // --- Submit to overlay ---
-    // Use binary BEEF with X-Topics header (matches clawdbot-overlay server API)
+    // Use binary BEEF with X-Topics header (matches openclaw-overlay server API)
     const submitResp = await fetch(`${OVERLAY_URL}/submit`, {
         method: 'POST',
         headers: {

package/dist/scripts/overlay/services.d.ts

@@ -1,7 +1,7 @@
 /**
  * Overlay service commands: services, advertise, remove, readvertise.
  *
- * Service payloads match the clawdbot-overlay server schema:
+ * Service payloads match the openclaw-overlay server schema:
  * - protocol: "clawdbot-overlay-v1"
  * - type: "service"
  * - identityKey: provider's compressed public key

package/dist/scripts/overlay/services.js

@@ -1,7 +1,7 @@
 /**
  * Overlay service commands: services, advertise, remove, readvertise.
  *
- * Service payloads match the clawdbot-overlay server schema:
+ * Service payloads match the openclaw-overlay server schema:
  * - protocol: "clawdbot-overlay-v1"
  * - type: "service"
  * - identityKey: provider's compressed public key
@@ -55,7 +55,7 @@ export async function cmdAdvertise(serviceId, name, priceSatsStr, description) {
         priceSats,
         registeredAt: new Date().toISOString(),
     };
-    // Publish on-chain (matches clawdbot-overlay server schema)
+    // Publish on-chain (matches openclaw-overlay server schema)
     const servicePayload = {
         protocol: PROTOCOL_ID,
         type: 'service',
@@ -135,7 +135,7 @@ export async function cmdReadvertise(serviceId, name, priceSatsStr, description)
     if (description)
         existing.description = description;
     existing.registeredAt = new Date().toISOString();
-    // Publish update on-chain (matches clawdbot-overlay server schema)
+    // Publish update on-chain (matches openclaw-overlay server schema)
     const servicePayload = {
         protocol: PROTOCOL_ID,
         type: 'service',

package/dist/scripts/overlay/transaction.d.ts

@@ -1,7 +1,7 @@
 /**
  * Overlay transaction building utilities.
  *
- * Follows the clawdbot-overlay server API:
+ * Follows the openclaw-overlay server API:
  * - Submit: POST /submit with binary BEEF and X-Topics header
  * - OP_RETURN format: OP_FALSE OP_RETURN <"clawdbot-overlay-v1"> <JSON>
  */

package/dist/scripts/overlay/transaction.js

@@ -1,7 +1,7 @@
 /**
  * Overlay transaction building utilities.
  *
- * Follows the clawdbot-overlay server API:
+ * Follows the openclaw-overlay server API:
  * - Submit: POST /submit with binary BEEF and X-Topics header
  * - OP_RETURN format: OP_FALSE OP_RETURN <"clawdbot-overlay-v1"> <JSON>
  */
@@ -45,7 +45,7 @@ export async function buildRealOverlayTransaction(payload, topic) {
         }
     });
     // --- Submit to overlay ---
-    // Use binary BEEF with X-Topics header (matches clawdbot-overlay server API)
+    // Use binary BEEF with X-Topics header (matches openclaw-overlay server API)
     const submitResp = await fetch(`${OVERLAY_URL}/submit`, {
         method: 'POST',
         headers: {

package/dist/test/overlay-submit.test.d.ts

@@ -2,7 +2,7 @@
  * Unit tests for overlay /submit endpoint compatibility.
  *
  * These tests validate that the client constructs BEEF and payloads
- * in the exact format expected by the clawdbot-overlay server's
+ * in the exact format expected by the openclaw-overlay server's
  * topic managers using PushDrop tokens.
  *
  * Run with: npx tsx src/test/overlay-submit.test.ts

package/dist/test/overlay-submit.test.js

@@ -2,7 +2,7 @@
  * Unit tests for overlay /submit endpoint compatibility.
  *
  * These tests validate that the client constructs BEEF and payloads
- * in the exact format expected by the clawdbot-overlay server's
+ * in the exact format expected by the openclaw-overlay server's
  * topic managers using PushDrop tokens.
  *
  * Run with: npx tsx src/test/overlay-submit.test.ts

package/dist/test/utils/server-logic.d.ts

@@ -8,7 +8,7 @@
  * Updated to use PushDrop tokens instead of plain OP_RETURN.
  */
 import { Script, LockingScript } from '@bsv/sdk';
-export declare const PROTOCOL_ID = "openclaw-overlay-v1";
+export declare const PROTOCOL_ID = "clawdbot-overlay-v1";
 export interface OpenclawIdentityData {
     protocol: string;
     type: 'identity';

package/dist/test/utils/server-logic.js

@@ -8,7 +8,7 @@
  * Updated to use PushDrop tokens instead of plain OP_RETURN.
  */
 import { OP, Beef, PushDrop } from '@bsv/sdk';
-export const PROTOCOL_ID = 'openclaw-overlay-v1';
+export const PROTOCOL_ID = 'clawdbot-overlay-v1';
 // ============================================================================
 // Script Parsing using PushDrop.decode()
 // ============================================================================

package/index.ts

@@ -51,7 +51,7 @@ function loadDailySpending(walletDir: string): DailySpending {
 }
 
 function writeActivityEvent(event) {
-  const alertDir = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay');
+  const alertDir = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay');
   try {
     fs.mkdirSync(alertDir, { recursive: true });
     fs.appendFileSync(path.join(alertDir, 'activity-feed.jsonl'), JSON.stringify({ ...event, ts: Date.now() }) + '\n');
@@ -114,7 +114,7 @@ async function startAutoImport(env, cliPath, logger) {
               
               // Clear onboarding flag since wallet is now funded
               try {
-                const onboardingSentFile = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'onboarding-sent.flag');
+                const onboardingSentFile = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'onboarding-sent.flag');
                 if (fs.existsSync(onboardingSentFile)) {
                   fs.unlinkSync(onboardingSentFile);
                 }
@@ -125,7 +125,7 @@ async function startAutoImport(env, cliPath, logger) {
 
               // Check if registered, auto-register if not
               try {
-                const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+                const regPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'registration.json');
                 if (!fs.existsSync(regPath)) {
                   logger?.info?.('[bsv-overlay] Not yet registered — auto-registering...');
                   const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
@@ -168,7 +168,7 @@ async function autoAdvertiseServices(env, cliPath, logger) {
     // Read config to get services list
     const configPaths = [
       path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
-      path.join(process.env.HOME || '', '.clawdbot', 'clawdbot.json'),
+      path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
     ];
     
     let servicesToAdvertise: string[] = [];
@@ -244,12 +244,12 @@ async function autoAdvertiseServices(env, cliPath, logger) {
   }
 }
 
-// Auto-enable hooks in Clawdbot config if not already configured.
+// Auto-enable hooks in OpenClaw config if not already configured.
 // Returns true if config was modified (gateway restart needed to activate).
 function autoEnableHooks(api: any): boolean {
   try {
     const configPaths = [
-      path.join(process.env.HOME || '', '.clawdbot', 'clawdbot.json'),
+      path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
       path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
     ];
 
@@ -289,19 +289,19 @@ function autoEnableHooks(api: any): boolean {
 
 // Discover the gateway HTTP port from environment
 function getGatewayPort(): string {
-  return process.env.CLAWDBOT_GATEWAY_PORT || process.env.OPENCLAW_GATEWAY_PORT || '18789';
+  return process.env.OPENCLAW_GATEWAY_PORT || process.env.OPENCLAW_GATEWAY_PORT || '18789';
 }
 
 // Read tokens from env vars or config files.
 // Returns { hooksToken, gatewayToken } — hooksToken is preferred for HTTP wake.
 function getTokens(): { hooksToken: string | null; gatewayToken: string | null } {
-  let hooksToken: string | null = process.env.CLAWDBOT_HOOKS_TOKEN || process.env.OPENCLAW_HOOKS_TOKEN || null;
-  let gatewayToken: string | null = process.env.CLAWDBOT_GATEWAY_TOKEN || process.env.OPENCLAW_GATEWAY_TOKEN || null;
+  let hooksToken: string | null = process.env.OPENCLAW_HOOKS_TOKEN || process.env.OPENCLAW_HOOKS_TOKEN || null;
+  let gatewayToken: string | null = process.env.OPENCLAW_GATEWAY_TOKEN || process.env.OPENCLAW_GATEWAY_TOKEN || null;
 
   try {
     const configPaths = [
       path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
-      path.join(process.env.HOME || '', '.clawdbot', 'clawdbot.json'),
+      path.join(process.env.HOME || '', '.openclaw', 'openclaw.json'),
     ];
     for (const p of configPaths) {
       if (!fs.existsSync(p)) continue;
@@ -336,7 +336,7 @@ function wakeAgent(text: string, logger?: any, opts?: { sessionKey?: string }) {
     headers: {
       'Content-Type': 'application/json',
       'Authorization': `Bearer ${httpToken}`,
-      'x-clawdbot-token': httpToken,
+      'x-openclaw-token': httpToken,
     },
     body: JSON.stringify({
       message: text,
@@ -435,7 +435,7 @@ function startBackgroundService(env, cliPath, logger) {
           const event = JSON.parse(line);
           logger?.debug?.(`[bsv-overlay] ${event.event || event.type || 'message'}:`, JSON.stringify(event).slice(0, 200));
           
-          const alertDir = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay');
+          const alertDir = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay');
           fs.mkdirSync(alertDir, { recursive: true });
           
           // Detect queued-for-agent events — invoke agent via /hooks/agent
@@ -717,7 +717,7 @@ export default function register(api) {
         const cliPath = path.join(__dirname, 'dist', 'cli.js');
         
         // Check registration status
-        const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+        const regPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'registration.json');
         const isRegistered = fs.existsSync(regPath);
         
         // Get balance
@@ -906,7 +906,7 @@ export default function register(api) {
           console.log('Step 1: Agent Identity\n');
           console.log('Your agent identity is how other agents will see you on the network.\n');
 
-          const currentName = config?.agentName || env.AGENT_NAME || 'clawdbot-agent';
+          const currentName = config?.agentName || env.AGENT_NAME || 'openclaw-agent';
           const agentName = await prompt(`Agent name [${currentName}]: `) || currentName;
 
           const currentDesc = config?.agentDescription || env.AGENT_DESCRIPTION || 'AI agent on the OpenClaw Overlay Network.';
@@ -1037,7 +1037,7 @@ export default function register(api) {
   (async () => {
     try {
       const config = pluginConfig;
-      const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.clawdbot', 'bsv-wallet');
+      const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.openclaw', 'bsv-wallet');
       const identityFile = path.join(walletDir, 'wallet-identity.json');
       const env = buildEnvironment(config || {});
       const cliPath = path.join(__dirname, 'dist', 'cli.js');
@@ -1064,7 +1064,7 @@ export default function register(api) {
       } catch {}
 
       // Step 3: Check registration and balance state
-      const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+      const regPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'registration.json');
       const isRegistered = fs.existsSync(regPath);
       let balance = 0;
       try {
@@ -1077,7 +1077,7 @@ export default function register(api) {
       if (!isRegistered && balance >= 1000) {
         // Clear onboarding flag since wallet is now funded
         try {
-          const onboardingSentFile = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'onboarding-sent.flag');
+          const onboardingSentFile = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'onboarding-sent.flag');
           if (fs.existsSync(onboardingSentFile)) {
             fs.unlinkSync(onboardingSentFile);
           }
@@ -1103,7 +1103,7 @@ export default function register(api) {
 
       // Step 6: Not registered + not funded → send onboarding message (only once per wallet)
       // This runs on first startup after plugin install (wallet just created or exists but empty)
-      const onboardingSentFile = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'onboarding-sent.flag');
+      const onboardingSentFile = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'onboarding-sent.flag');
 
       // Check if we already sent onboarding message for this wallet
       let alreadySent = false;
@@ -1232,7 +1232,7 @@ async function executeOverlayAction(params, config, api) {
 
 async function handleServiceRequest(params, env, cliPath, config, api) {
   const { service, identityKey: targetKey, input, maxPrice } = params;
-  const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.clawdbot', 'bsv-wallet');
+  const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.openclaw', 'bsv-wallet');
   
   if (!service) {
     throw new Error("Service is required for request action");
@@ -1352,7 +1352,7 @@ async function handleUnregister(params, env, cliPath) {
   const { confirmToken } = params;
 
   // Load current registration to show what will be deleted
-  const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+  const regPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'registration.json');
   let registration: any = null;
   try {
     if (fs.existsSync(regPath)) {
@@ -1555,7 +1555,7 @@ async function handleStatus(env, cliPath) {
 
 async function handleDirectPay(params, env, cliPath, config) {
   const { identityKey, sats, description } = params;
-  const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.clawdbot', 'bsv-wallet');
+  const walletDir = config?.walletDir || path.join(process.env.HOME || '', '.openclaw', 'bsv-wallet');
   
   if (!identityKey || !sats) {
     throw new Error("identityKey and sats are required for pay action");
@@ -1630,7 +1630,7 @@ async function handleImport(params, env, cliPath) {
   }
 
   // Check if we should auto-register after successful import
-  const regPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'registration.json');
+  const regPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'registration.json');
   const isRegistered = fs.existsSync(regPath);
   
   if (!isRegistered && output.data?.balance >= 1000) {
@@ -1886,14 +1886,14 @@ async function handlePendingRequests(env, cliPath) {
   if (!output.success) throw new Error(`Queue check failed: ${output.error}`);
 
   // Clear the alert file since we're checking now
-  const alertPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'pending-alert.jsonl');
+  const alertPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'pending-alert.jsonl');
   try { if (fs.existsSync(alertPath)) fs.unlinkSync(alertPath); } catch {}
 
   return output.data;
 }
 
 function handleActivity() {
-  const feedPath = path.join(process.env.HOME || '', '.clawdbot', 'bsv-overlay', 'activity-feed.jsonl');
+  const feedPath = path.join(process.env.HOME || '', '.openclaw', 'bsv-overlay', 'activity-feed.jsonl');
   if (!fs.existsSync(feedPath)) return { events: [], count: 0 };
   
   const lines = fs.readFileSync(feedPath, 'utf-8').trim().split('\n').filter(Boolean);
@@ -1942,7 +1942,7 @@ function buildEnvironment(config) {
   if (config.agentName) {
     env.AGENT_NAME = config.agentName;
   } else if (!env.AGENT_NAME) {
-    env.AGENT_NAME = 'clawdbot-agent';
+    env.AGENT_NAME = 'openclaw-agent';
   }
   if (config.agentDescription) {
     env.AGENT_DESCRIPTION = config.agentDescription;

package/openclaw.plugin.json

@@ -25,7 +25,7 @@
       },
       "walletDir": {
         "type": "string",
-        "description": "BSV wallet storage directory (defaults to ~/.clawdbot/bsv-wallet)"
+        "description": "BSV wallet storage directory (defaults to ~/.openclaw/bsv-wallet)"
       },
       "maxAutoPaySats": {
         "type": "number",
@@ -76,7 +76,7 @@
     },
     "walletDir": {
       "label": "Wallet Directory",
-      "placeholder": "~/.clawdbot/bsv-wallet",
+      "placeholder": "~/.openclaw/bsv-wallet",
       "advanced": true
     },
     "maxAutoPaySats": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.7.22",
+  "version": "0.7.23",
   "description": "Openclaw BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "publishConfig": {
     "access": "public"
@@ -8,11 +8,12 @@
   "type": "module",
   "files": [
     "index.ts",
-    "clawdbot.plugin.json",
+    "openclaw.plugin.json",
     "openclaw.plugin.json",
     "src/",
     "dist/",
     "SKILL.md",
+    "HOOK.md",
     "README.md"
   ],
   "bin": {

package/src/scripts/baemail/handler.ts

@@ -247,14 +247,14 @@ _Reply via overlay: \`cli send ${replyKey} ping "your reply"\`_`;
   let deliveryError: string | null = null;
 
   try {
-    const hookHost = process.env.CLAWDBOT_HOST || process.env.OPENCLAW_HOST || '127.0.0.1';
+    const hookHost = process.env.OPENCLAW_HOST || process.env.OPENCLAW_HOST || '127.0.0.1';
     const hookUrl = `http://${hookHost}:${hookPort}/hooks/agent`;
     const hookResp = await fetchWithTimeout(hookUrl, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
         'Authorization': `Bearer ${hookToken}`,
-        'x-clawdbot-token': hookToken,
+        'x-openclaw-token': hookToken,
       },
       body: JSON.stringify({
         message: formattedMessage,

package/src/scripts/config.ts

@@ -7,7 +7,7 @@ import os from 'node:os';
 import fs from 'node:fs';
 
 // Auto-load .env from overlay state dir if it exists
-const overlayEnvPath = path.join(os.homedir(), '.clawdbot', 'bsv-overlay', '.env');
+const overlayEnvPath = path.join(os.homedir(), '.openclaw', 'bsv-overlay', '.env');
 try {
   if (fs.existsSync(overlayEnvPath)) {
     for (const line of fs.readFileSync(overlayEnvPath, 'utf-8').split('\n')) {
@@ -23,7 +23,7 @@ try {
 
 /** Wallet storage directory */
 export const WALLET_DIR = process.env.BSV_WALLET_DIR
-  || path.join(os.homedir(), '.clawdbot', 'bsv-wallet');
+  || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
 
 /** Network to use (mainnet or testnet) */
 export const NETWORK: 'mainnet' | 'testnet' =
@@ -33,7 +33,7 @@ export const NETWORK: 'mainnet' | 'testnet' =
 export const OVERLAY_URL = process.env.OVERLAY_URL || 'https://clawoverlay.com';
 
 /** Agent display name on the overlay network */
-export const AGENT_NAME = process.env.AGENT_NAME || 'clawdbot-agent';
+export const AGENT_NAME = process.env.AGENT_NAME || 'openclaw-agent';
 
 /** Agent description for the overlay identity */
 export const AGENT_DESCRIPTION = process.env.AGENT_DESCRIPTION ||
@@ -43,10 +43,10 @@ export const AGENT_DESCRIPTION = process.env.AGENT_DESCRIPTION ||
 export const WOC_API_KEY = process.env.WOC_API_KEY || '';
 
 /** Overlay state directory for registration, services, etc. */
-export const OVERLAY_STATE_DIR = path.join(os.homedir(), '.clawdbot', 'bsv-overlay');
+export const OVERLAY_STATE_DIR = path.join(os.homedir(), '.openclaw', 'bsv-overlay');
 
 /** Protocol identifier for overlay transactions */
-export const PROTOCOL_ID = 'clawdbot overlay v1';
+export const PROTOCOL_ID = 'openclaw overlay v1';
 
 /** Topic managers for overlay submissions */
 export const TOPICS = {

package/src/scripts/overlay/registration.ts

@@ -58,7 +58,7 @@ export async function cmdRegister(): Promise<never> {
   }
 
   // Create identity record on-chain
-  // This payload format matches the clawdbot-overlay server's expected schema
+  // This payload format matches the openclaw-overlay server's expected schema
   const identityPayload = {
     protocol: PROTOCOL_ID,
     type: 'identity' as const,
@@ -174,7 +174,7 @@ export async function cmdUnregister(): Promise<never> {
   const txid = response.txid as string;
 
   // --- Submit to overlay ---
-  // Use binary BEEF with X-Topics header (matches clawdbot-overlay server API)
+  // Use binary BEEF with X-Topics header (matches openclaw-overlay server API)
   const submitResp = await fetch(`${OVERLAY_URL}/submit`, {
     method: 'POST',
     headers: {

package/src/scripts/overlay/services.ts

@@ -1,7 +1,7 @@
 /**
  * Overlay service commands: services, advertise, remove, readvertise.
  * 
- * Service payloads match the clawdbot-overlay server schema:
+ * Service payloads match the openclaw-overlay server schema:
  * - protocol: "clawdbot-overlay-v1"
  * - type: "service"
  * - identityKey: provider's compressed public key
@@ -71,7 +71,7 @@ export async function cmdAdvertise(
     registeredAt: new Date().toISOString(),
   };
 
-  // Publish on-chain (matches clawdbot-overlay server schema)
+  // Publish on-chain (matches openclaw-overlay server schema)
   const servicePayload = {
     protocol: PROTOCOL_ID,
     type: 'service' as const,
@@ -165,7 +165,7 @@ export async function cmdReadvertise(
   if (description) existing.description = description;
   existing.registeredAt = new Date().toISOString();
 
-  // Publish update on-chain (matches clawdbot-overlay server schema)
+  // Publish update on-chain (matches openclaw-overlay server schema)
   const servicePayload = {
     protocol: PROTOCOL_ID,
     type: 'service' as const,

package/src/scripts/overlay/transaction.ts

@@ -1,7 +1,7 @@
 /**
  * Overlay transaction building utilities.
  * 
- * Follows the clawdbot-overlay server API:
+ * Follows the openclaw-overlay server API:
  * - Submit: POST /submit with binary BEEF and X-Topics header
  * - OP_RETURN format: OP_FALSE OP_RETURN <"clawdbot-overlay-v1"> <JSON>
  */
@@ -55,7 +55,7 @@ export async function buildRealOverlayTransaction(
   })
 
   // --- Submit to overlay ---
-  // Use binary BEEF with X-Topics header (matches clawdbot-overlay server API)
+  // Use binary BEEF with X-Topics header (matches openclaw-overlay server API)
   const submitResp = await fetch(`${OVERLAY_URL}/submit`, {
     method: 'POST',
     headers: {

package/src/test/overlay-submit.test.ts

@@ -2,7 +2,7 @@
  * Unit tests for overlay /submit endpoint compatibility.
  *
  * These tests validate that the client constructs BEEF and payloads
- * in the exact format expected by the clawdbot-overlay server's
+ * in the exact format expected by the openclaw-overlay server's
  * topic managers using PushDrop tokens.
  *
  * Run with: npx tsx src/test/overlay-submit.test.ts

package/src/test/utils/server-logic.ts

@@ -10,7 +10,7 @@
 
 import { Script, OP, Beef, PushDrop, LockingScript } from '@bsv/sdk';
 
-export const PROTOCOL_ID = 'openclaw-overlay-v1';
+export const PROTOCOL_ID = 'clawdbot-overlay-v1';
 
 // ============================================================================
 // Type Definitions (mirrored from server)

package/clawdbot.plugin.json

@@ -1,106 +0,0 @@
-{
-  "id": "openclaw-overlay-plugin",
-  "name": "BSV Overlay Network",
-  "description": "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  "version": "0.7.22",
-  "skills": [
-    "./SKILL.md"
-  ],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {
-      "overlayUrl": {
-        "type": "string",
-        "default": "https://clawoverlay.com",
-        "description": "Overlay server URL for registration, discovery, and relay"
-      },
-      "agentName": {
-        "type": "string",
-        "description": "Display name for this agent on the overlay network (defaults to hostname)"
-      },
-      "agentDescription": {
-        "type": "string",
-        "description": "Description of this agent shown to other agents on the network"
-      },
-      "walletDir": {
-        "type": "string",
-        "description": "BSV wallet storage directory (defaults to ~/.clawdbot/bsv-wallet)"
-      },
-      "maxAutoPaySats": {
-        "type": "number",
-        "default": 200,
-        "minimum": 0,
-        "description": "Maximum satoshis to auto-pay per service request without confirmation"
-      },
-      "dailyBudgetSats": {
-        "type": "number",
-        "default": 5000,
-        "minimum": 0,
-        "description": "Maximum total satoshis to spend per day across all services"
-      },
-      "autoAcceptPayments": {
-        "type": "boolean",
-        "default": true,
-        "description": "Automatically accept incoming BSV payments for services"
-      },
-      "preferCheapest": {
-        "type": "boolean",
-        "default": true,
-        "description": "When multiple providers offer the same service, prefer the cheapest"
-      },
-      "services": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "List of service IDs to auto-advertise on registration"
-      }
-    }
-  },
-  "uiHints": {
-    "overlayUrl": {
-      "label": "Overlay Server URL",
-      "placeholder": "https://clawoverlay.com",
-      "advanced": true
-    },
-    "agentName": {
-      "label": "Agent Name",
-      "placeholder": "my-agent",
-      "help": "Display name shown to other agents on the network"
-    },
-    "agentDescription": {
-      "label": "Agent Description",
-      "placeholder": "A helpful AI agent offering various services",
-      "help": "Description visible to other agents during discovery"
-    },
-    "walletDir": {
-      "label": "Wallet Directory",
-      "placeholder": "~/.clawdbot/bsv-wallet",
-      "advanced": true
-    },
-    "maxAutoPaySats": {
-      "label": "Max Auto-Pay (sats)",
-      "placeholder": "200",
-      "help": "Requests above this amount will ask for confirmation"
-    },
-    "dailyBudgetSats": {
-      "label": "Daily Budget (sats)",
-      "placeholder": "5000",
-      "help": "Total daily spending limit across all service requests"
-    },
-    "autoAcceptPayments": {
-      "label": "Auto-Accept Payments",
-      "help": "Automatically accept incoming payments for your advertised services"
-    },
-    "preferCheapest": {
-      "label": "Prefer Cheapest Provider",
-      "advanced": true
-    },
-    "services": {
-      "label": "Auto-Advertise Services",
-      "help": "Service IDs to automatically advertise when registering",
-      "advanced": true
-    }
-  }
-}