From d189037c69a4df67ba0dc88e44a920f427a77e29 Mon Sep 17 00:00:00 2001
From: Fsocietyhhh <1211904451@qq.com>
Date: Tue, 12 May 2026 22:54:14 -0700
Subject: [PATCH] docs: add `xclawrouter setup` step after each OpenClaw
 install path
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Before this, only the curl one-liner included the OKX wallet onboarding
prompt (via scripts/reinstall.sh's "Next step" block). Users following
Options 2 (`openclaw plugins install`) or 3 (`npm install -g`) saw the
plugin install succeed with zero indication that anything else was
needed. Net effect: the gateway restarted, the plugin loaded, OKX
detection failed (no session), the OnchainOsRequiredError was logged to
the gateway's file log where no user looks, and BlockRun models silently
didn't work in OpenClaw.

The plugin can't easily prompt the user from inside the gateway daemon
(no TTY, no stdin), so the README is the right surface to make this
explicit. Each Option now ends with a `xclawrouter setup` line.

Also reworded the trailing paragraph: dropped the "On first run
XClawRouter prompts you to log in..." sentence — that auto-prompt only
fires when the user runs `npx @blockrun/xclawrouter` standalone in an
interactive TTY, not on the OpenClaw plugin path, so it was misleading
in this context.
---
 README.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 06ce019..500c2c7 100644
--- a/README.md
+++ b/README.md
@@ -84,11 +84,12 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r
 
 [OpenClaw](https://openclaw.ai) is an AI coding agent. If you're using it, XClawRouter installs as a plugin. Three install paths — pick whichever fits:
 
-**1. One-liner (recommended)** — bundles config injection, cleanup of legacy installs, and onchainos bootstrap:
+**1. One-liner (recommended)** — installs the plugin, bootstraps onchainos, and points you at the wallet login command:
 
 ```bash
 curl -fsSL https://blockrun.ai/XClawRouter-update | bash
 openclaw gateway restart
+npx @blockrun/xclawrouter setup        # email + OTP login to your OKX Agentic Wallet
 ```
 
 **2. Manual via OpenClaw plugin manager** — if you want to see each step:
@@ -96,6 +97,7 @@ openclaw gateway restart
 ```bash
 openclaw plugins install @blockrun/xclawrouter
 openclaw gateway restart
+npx @blockrun/xclawrouter setup        # email + OTP login to your OKX Agentic Wallet
 ```
 
 **3. Global npm install** — same effect as #2, useful for CI or pinned deployments:
@@ -103,9 +105,12 @@ openclaw gateway restart
 ```bash
 npm install -g @blockrun/xclawrouter
 openclaw gateway restart
+xclawrouter setup                      # email + OTP login to your OKX Agentic Wallet
 ```
 
-Done. Smart routing (`blockrun/auto`) is now your default model. On first run XClawRouter prompts you to log in to your OKX Agentic Wallet via email — no local private key, signing happens in OKX's TEE.
+`setup` walks you through two prompts (email, then the OTP it mails you) and is a no-op if you're already signed in — safe to re-run. Signing happens in OKX's TEE; no local private key is stored.
+
+Done. Smart routing (`blockrun/auto`) is now your default model.
 
 ### Option B — Standalone (continue.dev, Cursor, VS Code, any OpenAI-compatible client)