openclaw-navigator 4.3.7 → 4.3.9

package/cli.mjs

@@ -58,6 +58,9 @@ const validTokens = new Set();
 // OC Web UI reverse proxy target (configurable via --ui-port or env)
 let ocUIPort = parseInt(process.env.OPENCLAW_UI_PORT ?? "4000", 10);
 
+// Tunnel URL — set once the tunnel is active, exposed via /navigator/status
+let activeTunnelURL = null;
+
 // Pairing code state
 let pairingCode = null;
 let pairingData = null;
@@ -217,6 +220,12 @@ function handleRequest(req, res) {
         pendingCommandCount: pendingCommands.length,
         recentEventCount: recentEvents.length,
       },
+      tunnel: activeTunnelURL
+        ? {
+            url: activeTunnelURL,
+            uiURL: `${activeTunnelURL}/ui/`,
+          }
+        : null,
     });
     return;
   }
@@ -670,6 +679,7 @@ ${BOLD}How it works:${RESET}
 
       if (result) {
         tunnelURL = result.url;
+        activeTunnelURL = tunnelURL; // Expose via /navigator/status
         tunnelProcess = result.process;
         gatewayURL = tunnelURL; // Use tunnel URL as the gateway URL
 
@@ -844,8 +854,106 @@ ${BOLD}How it works:${RESET}
 
       mkdirSync(mcporterDir, { recursive: true });
       writeFileSync(mcporterConfigPath, JSON.stringify(mcporterConfig, null, 2) + "\n", "utf8");
-      ok("Registered MCP server with mcporter (15 browser tools available)");
+      ok("Registered MCP server with mcporter (16 browser tools available)");
       info(`  Config: ${mcporterConfigPath}`);
+
+      // Step 3: Install the navigator-bridge skill so the OC agent knows about all tools
+      // Try multiple known skill locations
+      const skillLocations = [
+        "/opt/homebrew/lib/node_modules/openclaw/skills/navigator-bridge",
+        join(homedir(), ".openclaw/skills/navigator-bridge"),
+      ];
+      // Find the first parent that exists, or use the homebrew path
+      let skillDir = skillLocations[0]; // default
+      for (const loc of skillLocations) {
+        const parent = dirname(loc);
+        if (existsSync(parent)) {
+          skillDir = loc;
+          break;
+        }
+      }
+      const skillPath = join(skillDir, "SKILL.md");
+      const BT = "```"; // backtick triple for markdown code blocks
+      const skillContent = [
+        "---",
+        "name: navigator-bridge",
+        "description: Control the remote Navigator browser and access the OC Web UI via MCP tools. Navigate to URLs, click elements, fill forms, read page content, execute JavaScript, manage tabs, and open the OC dashboard.",
+        'metadata:',
+        '  { "openclaw": { "emoji": "🌐", "requires": { "bins": ["mcporter"] } } }',
+        "---",
+        "",
+        "# Navigator Bridge (Remote Browser Control + OC Web UI)",
+        "",
+        "Control the **remote** Navigator browser through MCP tools via mcporter.",
+        "",
+        "**Important:** This controls the REMOTE Navigator instance connected via pairing code, NOT local Navigator.",
+        "",
+        "## Quick start",
+        "",
+        BT + "bash",
+        "# Get the OC Web UI URL and open it in Navigator",
+        "mcporter call navigator.navigator_get_ui_url",
+        "mcporter call navigator.navigator_navigate url=<uiURL from above>",
+        "",
+        "# Check connection status",
+        "mcporter call navigator.navigator_status",
+        BT,
+        "",
+        "## All 16 tools",
+        "",
+        "| Tool | What it does |",
+        "|------|-------------|",
+        "| `navigator_status` | Bridge status, connection, tunnel URL |",
+        "| `navigator_get_ui_url` | Get the OC Web UI URL (tunnel + /ui/) |",
+        "| `navigator_navigate` | Go to a URL |",
+        "| `navigator_open_tab` | Open new tab |",
+        "| `navigator_close_tab` | Close a tab |",
+        "| `navigator_list_tabs` | List all open tabs |",
+        "| `navigator_snapshot` | Full browser state snapshot |",
+        "| `navigator_get_text` | Read page text content |",
+        "| `navigator_get_html` | Get full page HTML |",
+        "| `navigator_click` | Click element by CSS selector |",
+        "| `navigator_fill` | Fill input field |",
+        "| `navigator_submit` | Submit form |",
+        "| `navigator_scroll` | Scroll page |",
+        "| `navigator_execute_js` | Run arbitrary JavaScript |",
+        "| `navigator_query_element` | Inspect DOM element |",
+        "| `navigator_wait_ready` | Wait for page load |",
+        "",
+        "## Usage",
+        "",
+        BT + "bash",
+        "mcporter call navigator.<tool_name> param=value",
+        BT,
+        "",
+        "## Common workflows",
+        "",
+        "### Open OC dashboard in Navigator",
+        BT + "bash",
+        "mcporter call navigator.navigator_get_ui_url",
+        "mcporter call navigator.navigator_navigate url=<uiURL>",
+        "mcporter call navigator.navigator_wait_ready",
+        BT,
+        "",
+        "### Browse and read a website",
+        BT + "bash",
+        "mcporter call navigator.navigator_navigate url=https://example.com",
+        "mcporter call navigator.navigator_wait_ready",
+        "mcporter call navigator.navigator_get_text",
+        BT,
+        "",
+        "### Fill and submit a form",
+        BT + "bash",
+        'mcporter call navigator.navigator_fill selector="#email" value="user@example.com"',
+        'mcporter call navigator.navigator_click selector="#submit"',
+        "mcporter call navigator.navigator_wait_ready",
+        BT,
+        "",
+      ].join("\n");
+      mkdirSync(skillDir, { recursive: true });
+      writeFileSync(skillPath, skillContent, "utf8");
+      ok("Installed navigator-bridge skill for OC agent");
+      info(`  Skill: ${skillPath}`);
     } catch (err) {
       warn(`mcporter registration failed: ${err.message}`);
       info("  You can manually configure mcporter for Navigator MCP");

package/mcp.mjs

@@ -156,7 +156,13 @@ const TOOLS = [
   {
     name: "navigator_status",
     description:
-      "Get the Navigator bridge status — connection state, active tabs, current URL, uptime, pending commands.",
+      "Get the Navigator bridge status — connection state, active tabs, current URL, uptime, pending commands. Also returns the tunnel URL and OC Web UI URL.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "navigator_get_ui_url",
+    description:
+      "Get the OC Web UI URL. Returns the Cloudflare tunnel URL with /ui/ path that serves the OpenClaw dashboard. Use this to find the URL before navigating to the UI.",
     inputSchema: { type: "object", properties: {} },
   },
 
@@ -356,6 +362,24 @@ async function handleTool(name, args) {
       case "navigator_status":
         return jsonResult(await bridgeGet("/navigator/status"));
 
+      case "navigator_get_ui_url": {
+        const status = await bridgeGet("/navigator/status");
+        if (status.tunnel?.uiURL) {
+          return jsonResult({
+            ok: true,
+            uiURL: status.tunnel.uiURL,
+            tunnelURL: status.tunnel.url,
+            hint: "Navigate to uiURL to access the OC Web UI dashboard",
+          });
+        }
+        return jsonResult({
+          ok: true,
+          uiURL: `${BRIDGE_URL}/ui/`,
+          tunnelURL: null,
+          hint: "No tunnel active — UI accessible locally only. Start with --mcp to enable tunnel.",
+        });
+      }
+
       // ── Fire-and-forget ──
       case "navigator_navigate":
         return jsonResult(await sendCommand("navigate", { url: args.url }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-navigator",
-  "version": "4.3.7",
+  "version": "4.3.9",
   "description": "One-command bridge + tunnel for the Navigator browser — works on any machine, any OS",
   "keywords": [
     "browser",