Skip to content

Releases: BlockRunAI/XClawRouter

v0.12.182 — OKX-first wallet onboarding

13 May 01:04
@1bcMax 1bcMax
v0.12.182
5c05235

Choose a tag to compare

View all tags
v0.12.182 — OKX-first wallet onboarding Latest
Latest

First major UX change to the install flow: fresh installs no longer silently mint a local BIP-39 wallet. The plugin now guides users into an OKX Agentic Wallet (onchainos) via a polished xclawrouter setup command. Existing wallets keep working unchanged.

Consolidates three unreleased commits (v0.12.180–.182) — npm has been on v0.12.179 since the migration to @blockrun/xclawrouter.

Highlights

  • xclawrouter setup — guided OKX onboarding. Two prompts (email → OTP), TEE-backed signing, no local private key written to disk. Auto-installs the onchainos binary if missing. Auto-launches on first npx @blockrun/xclawrouter in an interactive terminal.
  • Fresh installs without OKX no longer silent-fall-back to local BIP-39. resolveOrGenerateWalletKey() throws OnchainOsRequiredError with a verbatim guide; the user sees the next-step commands instead of waking up later with a wallet they didn't know was generated.
  • XCLAWROUTER_USE_LOCAL_WALLET=1 opt-out preserved for CI / Docker / power users who want the legacy local-key path.
  • Non-interactive callers (CI, Docker, gateway daemon) keep fail-fast exit 2 behaviour — no stdin prompts that nobody will answer.
  • README documents the three OpenClaw install paths — curl one-liner, openclaw plugins install, global npm install -g.

Compatibility

  • clawrouter CLI bin is back as a deprecation alias. v0.12.180 renamed the bin to xclawrouter; this release restores clawrouter pointing at the same binary, with a one-line stderr deprecation notice. pm2 start clawrouter, shell aliases, and shipped onboarding docs continue to work. Alias is removed in v0.13. Suppress the notice with XCLAW_SUPPRESS_RENAME_NOTICE=1.
  • Saved wallet.key files keep working unchanged — zero-disruption upgrade for users who already had a local wallet.

What's in each version

  • v0.12.180 — OKX-first wallet onboarding via guided setup. OnchainOsRequiredError throw on fresh installs; xclawrouter setup subcommand; auto-launch on interactive TTY; opt-out env var; CLI bin renamed to xclawrouter.
  • v0.12.181 — Polish setup UX. ANSI-styled header + summary box, suppressed onchainos JSON output, dropped duplicate skill-install path; reinstall.sh adds a prominent "Next step — log in to your OKX Agentic Wallet" block.
  • v0.12.182 — Code review fixes: restored clawrouter bin alias, guarded the post-setup wallet re-resolve, humanized cmdSetup failure messages, deduped helpers and the OKX installer URL.

Install / upgrade

# OpenClaw users
curl -fsSL https://blockrun.ai/XClawRouter-update | bash
openclaw gateway restart

# Standalone (continue.dev / Cursor / VS Code / any OpenAI-compatible client)
npx @blockrun/xclawrouter

# Power users who want the legacy local-key path
export XCLAWROUTER_USE_LOCAL_WALLET=1
npx @blockrun/xclawrouter

Test plan covered before release

  • npm run typecheck — clean
  • npm run lint — clean
  • npm run format:check — clean
  • npx vitest run src/ — 460 unit tests pass
  • npm publish --dry-run — clean
  • End-to-end with a real OKX account on andy@blockrun.ai — email + OTP completes, proxy on port 8402 uses the OKX wallet, no wallet.key written to disk
Assets 2
Loading