@agentlayer.tech/wallet 0.1.53 → 0.1.55

package/.openclaw/extensions/agent-wallet/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Official OpenClaw plugin bridge for the agent-wallet backends, including Solana, local BTC, and local EVM.",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "contracts": {
     "tools": [
       "agentlayer_autonomous_approve",

package/.openclaw/extensions/agent-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayertech/agent-wallet-plugin",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "OpenClaw plugin bridge for the AgentLayer wallet runtime.",
   "type": "module",
   "license": "SEE LICENSE IN ../../../LICENSE",

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## v0.1.54 - 2026-06-29
+
+- Fixed Claude Code autonomous-mode slash command activation so
+  `/agentlayer-autonomous-approve` no longer relies on the model treating the
+  slash invocation itself as sufficient consent. The command now uses an
+  explicit in-command confirmation step before enabling the standing
+  permission, and both autonomous toggle commands are marked manual-only in the
+  Claude Code command metadata.
+  - `claude-code/plugins/agent-wallet/commands/agentlayer-autonomous-approve.md`
+  - `claude-code/plugins/agent-wallet/commands/agentlayer-autonomous-revoke.md`
+  - `claude-code/plugins/agent-wallet/README.md`
+
 ## v0.1.53 - 2026-06-26
 
 - Fixed Morpho vault and market quote (preview) requests timing out under the

package/README.md

@@ -86,35 +86,37 @@ openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin
 
 The ClawHub package does not replace the npm installer. `npx @agentlayer.tech/wallet install --yes` installs the local runtime, Python backend, and helper services. ClawHub only installs the OpenClaw plugin surface that points at that runtime.
 
-Or install the CLI globally:
+Or install the CLI globally for shorter commands:
 
 ```bash
 npm install -g @agentlayer.tech/wallet
 wallet install --yes
 ```
 
+> **Why install globally?** Without the global install, `wallet` is not in your `PATH` and commands like `wallet update --yes` return `zsh: command not found: wallet`. The global install adds the `wallet` binary once; after that all `wallet <cmd>` shortcuts work. If you skip the global install, prefix every command with `npx @agentlayer.tech/wallet` instead (see the Updating section below).
+
 The CLI uses a versioned runtime layout:
 
 ```bash
-~/.openclaw/agent-wallet-runtime/releases/<version>
-~/.openclaw/agent-wallet-runtime/current
+~/.openclaw/agent-wallet-runtime/releases/<version>   # immutable per-version snapshots
+~/.openclaw/agent-wallet-runtime/current              # symlink → active release
 ```
 
 On first install, `--yes` generates local runtime secrets. The installer stores `master_key` and `approval_secret` in `~/.openclaw/sealed_keys.json`; only the boot key needed to unlock that sealed bundle is written to the runtime `.env`.
 
-Useful npm CLI commands:
+Useful CLI commands (require the global install above):
 
 ```bash
-wallet status
-wallet doctor
-wallet hermes install --yes
-wallet codex install --yes
-wallet update --yes
-wallet update --yes --dry-run
-wallet rollback
+wallet status                    # show active runtime version and health
+wallet doctor                    # diagnose common config problems
+wallet update --yes              # upgrade to the latest published version
+wallet update --yes --dry-run    # preview the upgrade without applying it
+wallet rollback                  # revert to the previous release
+wallet hermes install --yes      # (re)connect Hermes to the current runtime
+wallet codex install --yes       # (re)connect Codex to the current runtime
 ```
 
-`wallet update --yes` delegates to the latest published npm package and reuses shared Python and Node dependency snapshots when possible. Use `wallet update --yes --dry-run` to inspect the target version and dependency plan before switching `current`.
+`wallet update --yes` fetches the latest npm package, installs it under `releases/<version>`, and flips the `current` symlink. Python and Node dependency snapshots are reused when the dependency fingerprint has not changed, so subsequent updates are fast. All frameworks that read from `current/` (Claude Code, Codex, Hermes) pick up the new code automatically on their next session start; OpenClaw requires a gateway restart to reload its TypeScript extension.
 
 ## Native OpenClaw plugin installs
 

package/VERSION

@@ -1 +1 @@
-0.1.53
+0.1.55

package/agent-wallet/agent_wallet/__init__.py

@@ -2,7 +2,7 @@
 
 # Keep in sync with package.json, pyproject.toml, and the npm installer version.
 # scripts/check_release_version.mjs enforces this on release.
-__version__ = "0.1.53"
+__version__ = "0.1.55"
 
 __all__ = [
     "config",

package/agent-wallet/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agent-wallet",
   "name": "Agent Wallet",
   "description": "Plugin-friendly wallet backend for OpenClaw agents with safe wallet tools and runtime instructions across Solana, local BTC, and local EVM.",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "skills": ["skills/wallet-operator"],
   "configSchema": {
     "type": "object",

package/agent-wallet/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openclaw-agent-wallet"
-version = "0.1.53"
+version = "0.1.55"
 description = "Plugin-friendly wallet backend for OpenClaw agents"
 requires-python = ">=3.10"
 dependencies = [

package/claude-code/plugins/agent-wallet/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-wallet",
   "displayName": "Agent Wallet",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "Claude Code bridge for the existing AgentLayer wallet runtime. Connects to Solana, Bitcoin, and EVM wallets without creating a new one.",
   "author": {
     "name": "AgentLayer"

package/claude-code/plugins/agent-wallet/README.md

@@ -51,11 +51,17 @@ no-op once the backend is healthy.
 - `/wallet-setup` — install (or repair) the backend explicitly instead of
   waiting for the hook (requires `/reload-plugins` first so the command is
   registered).
+- `/wallet-sol` — print the current Solana wallet overview directly in chat.
+- `/wallet-evm` — print the wallet overview for the current/default EVM network
+  directly in chat.
+- `/wallet-base` — print the Base EVM wallet overview directly in chat.
+- `/wallet-ethereum` — print the Ethereum EVM wallet overview directly in chat.
 - `/agentlayer-autonomous-approve` — enable high-trust autonomous Base swaps
   (`swap_evm_tokens` / `swap_evm_uniswap_tokens` on Base only) without
-  per-transaction approvals.
-- `/agentlayer-autonomous-revoke` — disable that autonomous Base swap
-  permission.
+  per-transaction approvals. In Claude Code this command now asks for an
+  explicit in-command confirmation before enabling the standing permission.
+- `/agentlayer-autonomous-revoke` — disable the combined autonomous permission
+  group for Base swaps and supported EVM DeFi tools.
 - `AGENT_WALLET_AUTO_BOOTSTRAP=0` — opt out of the auto-install: the
   `SessionStart` hook then only reminds you to run `/wallet-setup` instead of
   installing the backend itself.

package/claude-code/plugins/agent-wallet/commands/agentlayer-autonomous-approve.md

@@ -1,11 +1,24 @@
 ---
 description: Enable AgentLayer autonomous Base swaps and EVM DeFi tools without per-transaction approvals.
-allowed-tools: mcp__agent_wallet__agentlayer_autonomous_approve, mcp__agent_wallet__agentlayer_autonomous_status
+allowed-tools: AskUserQuestion, mcp__agent_wallet__agentlayer_autonomous_approve, mcp__agent_wallet__agentlayer_autonomous_status
+disable-model-invocation: true
 ---
 
 Enable the high-trust autonomous AgentLayer permission group.
 
-Call `agentlayer_autonomous_approve` with:
+First call `agentlayer_autonomous_status`.
+
+If both `base_swaps` and `defi_tools` are already enabled, report that the combined autonomous permission group is already active and remind the user that `/agentlayer-autonomous-revoke` disables it.
+
+Otherwise, use `AskUserQuestion` to confirm:
+
+- header: `Autonomy`
+- question: `Enable AgentLayer autonomous Base swaps and EVM DeFi tools without per-transaction approvals?`
+- options:
+  - `Enable` — `Turns on the combined autonomous permission group until revoked.`
+  - `Cancel` — `Leaves per-transaction approvals in place and does not change permissions.`
+
+Only if the user selects `Enable`, call `agentlayer_autonomous_approve` with:
 
 ```json
 {
@@ -17,6 +30,8 @@ Call `agentlayer_autonomous_approve` with:
 
 Then call `agentlayer_autonomous_status` and report whether both `base_swaps` and `defi_tools` are enabled.
 
+If the user selects `Cancel`, do not call any write tool. State that autonomous permissions were not changed.
+
 Be explicit in the response:
 
 - This removes per-transaction approvals for Base Velora/Uniswap swap execute calls and supported EVM DeFi management tools.

package/claude-code/plugins/agent-wallet/commands/agentlayer-autonomous-revoke.md

@@ -1,6 +1,7 @@
 ---
 description: Disable AgentLayer autonomous Base swaps and EVM DeFi tools.
 allowed-tools: mcp__agent_wallet__agentlayer_autonomous_revoke, mcp__agent_wallet__agentlayer_autonomous_status
+disable-model-invocation: true
 ---
 
 Disable the full high-trust autonomous AgentLayer permission group.

package/claude-code/plugins/agent-wallet/commands/wallet-base.md

@@ -0,0 +1,37 @@
+---
+description: Show the connected EVM wallet overview for Base directly in chat.
+allowed-tools: mcp__agent_wallet__get_wallet_overview
+disable-model-invocation: true
+---
+
+Show the connected EVM wallet overview for Base directly in chat.
+
+1. Call `get_wallet_overview` with:
+
+```json
+{
+  "backend": "evm",
+  "network": "base"
+}
+```
+
+2. Format the response as a compact wallet report:
+
+- state the wallet as `EVM (Base)`
+- include `chain`, `network` (or `requested_network`), `address`, and `total_value_usd` when present
+- render a Markdown table with columns: `Asset | Type | Amount | USD Value`
+- use `assets` when present
+- for each asset row, prefer:
+  - asset label: `symbol`, then `token_address`, then `asset_type`
+  - amount: `amount_ui`, then `balance_ui`, then `balance_native`, then `amount_raw`
+  - usd value: `value_usd`, then `balance_usd`
+- omit zero-value rows only when both the amount and USD value are clearly zero
+- if no asset rows are available, still report the native balance summary in prose
+
+3. After the table, add one short metadata line with any available sources:
+
+- `source`
+- `token_discovery_source`
+- `pricing_source`
+
+4. Do not suggest transfers, swaps, or other write actions unless the user explicitly asks for them.

package/claude-code/plugins/agent-wallet/commands/wallet-ethereum.md

@@ -0,0 +1,37 @@
+---
+description: Show the connected EVM wallet overview for Ethereum directly in chat.
+allowed-tools: mcp__agent_wallet__get_wallet_overview
+disable-model-invocation: true
+---
+
+Show the connected EVM wallet overview for Ethereum directly in chat.
+
+1. Call `get_wallet_overview` with:
+
+```json
+{
+  "backend": "evm",
+  "network": "ethereum"
+}
+```
+
+2. Format the response as a compact wallet report:
+
+- state the wallet as `EVM (Ethereum)`
+- include `chain`, `network` (or `requested_network`), `address`, and `total_value_usd` when present
+- render a Markdown table with columns: `Asset | Type | Amount | USD Value`
+- use `assets` when present
+- for each asset row, prefer:
+  - asset label: `symbol`, then `token_address`, then `asset_type`
+  - amount: `amount_ui`, then `balance_ui`, then `balance_native`, then `amount_raw`
+  - usd value: `value_usd`, then `balance_usd`
+- omit zero-value rows only when both the amount and USD value are clearly zero
+- if no asset rows are available, still report the native balance summary in prose
+
+3. After the table, add one short metadata line with any available sources:
+
+- `source`
+- `token_discovery_source`
+- `pricing_source`
+
+4. Do not suggest transfers, swaps, or other write actions unless the user explicitly asks for them.

package/claude-code/plugins/agent-wallet/commands/wallet-evm.md

@@ -0,0 +1,38 @@
+---
+description: Show the connected EVM wallet overview for the current/default EVM network directly in chat.
+allowed-tools: mcp__agent_wallet__get_wallet_overview
+disable-model-invocation: true
+---
+
+Show the connected EVM wallet overview directly in chat.
+
+1. Call `get_wallet_overview` with:
+
+```json
+{
+  "backend": "evm"
+}
+```
+
+2. Format the response as a compact wallet report:
+
+- state the wallet as `EVM`
+- include `chain`, the active/default EVM network (`network` or `requested_network`), `address`, and `total_value_usd` when present
+- render a Markdown table with columns: `Asset | Type | Amount | USD Value`
+- use `assets` when present
+- for each asset row, prefer:
+  - asset label: `symbol`, then `token_address`, then `asset_type`
+  - amount: `amount_ui`, then `balance_ui`, then `balance_native`, then `amount_raw`
+  - usd value: `value_usd`, then `balance_usd`
+- omit zero-value rows only when both the amount and USD value are clearly zero
+- if no asset rows are available, still report the native balance summary in prose
+
+3. After the table, add one short metadata line with any available sources:
+
+- `source`
+- `token_discovery_source`
+- `pricing_source`
+
+4. Be explicit that this command shows one EVM network at a time: the active/default network returned in the overview payload.
+
+5. Do not suggest transfers, swaps, or other write actions unless the user explicitly asks for them.

package/claude-code/plugins/agent-wallet/commands/wallet-sol.md

@@ -0,0 +1,36 @@
+---
+description: Show the connected Solana wallet overview directly in chat.
+allowed-tools: mcp__agent_wallet__get_wallet_overview
+disable-model-invocation: true
+---
+
+Show the connected Solana wallet overview directly in chat.
+
+1. Call `get_wallet_overview` with:
+
+```json
+{
+  "backend": "solana"
+}
+```
+
+2. Format the response as a compact wallet report:
+
+- state the wallet as `Solana`
+- include `chain`, `network` (or `requested_network` when `network` is absent), `address`, and `total_value_usd` when present
+- render a Markdown table with columns: `Asset | Type | Amount | USD Value`
+- use `assets` when present
+- for each asset row, prefer:
+  - asset label: `symbol`, then `mint`, then `token_address`, then `asset_type`
+  - amount: `amount_ui`, then `balance_ui`, then `balance_native`, then `amount_raw`
+  - usd value: `value_usd`, then `balance_usd`
+- omit zero-value rows only when both the amount and USD value are clearly zero
+- if no asset rows are available, still report the native balance summary in prose
+
+3. After the table, add one short metadata line with any available sources:
+
+- `source`
+- `token_discovery_source`
+- `pricing_source`
+
+4. Do not suggest transfers, swaps, or other write actions unless the user explicitly asks for them.

package/codex/plugins/agent-wallet/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-wallet",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "Codex plugin bridge for the AgentLayer wallet runtime.",
   "author": {
     "name": "AgentLayer"

package/codex/plugins/agent-wallet/server.py

@@ -361,6 +361,15 @@ def _normalize_selectable_evm_network(value: Any) -> str:
     return network
 
 
+def _implied_evm_network_from_backend_alias(value: Any) -> str | None:
+    normalized = str(value or "").strip().lower()
+    if normalized in {"base", "base-mainnet"}:
+        return "base"
+    if normalized in {"ethereum", "eth", "mainnet", "eth-mainnet"}:
+        return "ethereum"
+    return None
+
+
 def _normalize_solana_network(value: Any) -> str | None:
     network = str(value or "").strip().lower()
     if not network:
@@ -492,12 +501,17 @@ def _reject_secret_config_json(config: dict[str, Any]) -> None:
 
 
 def _base_config(args: dict[str, Any], *, tool_name: str = "") -> dict[str, Any]:
+    requested_backend = args.get("backend")
     backend = (
-        _normalize_wallet_backend(args.get("backend"))
-        if args.get("backend") is not None
+        _normalize_wallet_backend(requested_backend)
+        if requested_backend is not None
         else _active_backend_for_tool(tool_name)
     )
     config = _effective_config_for_backend(backend)
+    if backend == "wdk_evm_local":
+        implied_evm_network = _implied_evm_network_from_backend_alias(requested_backend)
+        if implied_evm_network and args.get("network") is None:
+            config["network"] = implied_evm_network
     if "config" in args:
         extra = args.get("config")
         if not isinstance(extra, dict):
@@ -807,6 +821,33 @@ def _sanitize_schema(schema: dict[str, Any]) -> dict[str, Any]:
 
 def _manual_tool_definitions() -> list[dict[str, Any]]:
     return [
+        {
+            "name": "get_wallet_overview",
+            "description": (
+                "Get a one-off wallet overview for a requested backend/network without changing the "
+                "active Codex wallet session. Returns the same enriched balance payload used by "
+                "get_wallet_balance."
+            ),
+            "input_schema": {
+                "type": "object",
+                "properties": {
+                    "backend": {
+                        "type": "string",
+                        "description": "solana, evm, base, ethereum, btc, or bitcoin.",
+                    },
+                    "network": {
+                        "type": "string",
+                        "description": "Optional network override. Use base or ethereum for EVM.",
+                    },
+                    "address": {
+                        "type": "string",
+                        "description": "Optional wallet address override.",
+                    },
+                },
+                "additionalProperties": False,
+            },
+            "read_only": True,
+        },
         {
             "name": "get_active_wallet_backend",
             "description": (
@@ -909,7 +950,13 @@ async def _handle_set_wallet_backend(params: dict[str, Any]) -> dict[str, Any]:
     # globals after the validating wallet call succeeds, so a failed switch never
     # leaves a stale backend paired with a freshly mutated network selection.
     if backend == "wdk_evm_local":
-        implied = params.get("network") or selected_evm_network or _default_evm_network() or "ethereum"
+        implied = (
+            params.get("network")
+            or _implied_evm_network_from_backend_alias(requested)
+            or selected_evm_network
+            or _default_evm_network()
+            or "ethereum"
+        )
         resolved_network = _normalize_selectable_evm_network(implied)
     elif backend == "wdk_btc_local":
         resolved_network = _normalize_btc_network(
@@ -978,6 +1025,29 @@ async def _handle_set_evm_network(params: dict[str, Any]) -> dict[str, Any]:
     }
 
 
+async def _handle_get_wallet_overview(params: dict[str, Any]) -> dict[str, Any]:
+    config = _base_config(params, tool_name="get_wallet_balance")
+    backend = _normalize_wallet_backend(config.get("backend"))
+
+    effective_params: dict[str, Any] = {}
+    if params.get("address") is not None:
+        effective_params["address"] = params.get("address")
+
+    payload = await asyncio.to_thread(_invoke_tool, "get_wallet_balance", effective_params, config)
+    if payload.get("ok") is False:
+        raise RuntimeError(str(payload.get("error") or "get_wallet_overview failed"))
+    data = payload.get("data", {})
+    if not isinstance(data, dict):
+        return {
+            "requested_backend": _backend_label(backend),
+            "requested_network": config.get("network"),
+            "data": data,
+        }
+    data.setdefault("requested_backend", _backend_label(backend))
+    data.setdefault("requested_network", config.get("network"))
+    return data
+
+
 def _invoke_wallet_tool_blocking(
     tool_name: str,
     config: dict[str, Any],
@@ -1068,6 +1138,8 @@ def build_server():
 
     async def _dispatch(tool_name: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
         params = params or {}
+        if tool_name == "get_wallet_overview":
+            return await _handle_get_wallet_overview(params)
         if tool_name == "get_active_wallet_backend":
             return await _handle_get_active_wallet_backend()
         if tool_name == "set_wallet_backend":

package/hermes/plugins/agent_wallet/plugin.yaml

@@ -1,5 +1,5 @@
 name: agent-wallet
-version: 0.1.53
+version: 0.1.55
 description: Thin Hermes Agent bridge to the existing AgentLayer/OpenClaw wallet backend
 provides_tools:
   - agent_wallet_tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "description": "NPM installer for the OpenClaw Agent Wallet local runtime.",
   "type": "module",
   "repository": {

package/wdk-btc-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-btc-wallet",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "private": true,
   "type": "module",
   "description": "Separate BTC-only wallet service built on Tether WDK.",

package/wdk-evm-wallet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdk-evm-wallet",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "private": true,
   "type": "module",
   "description": "Separate EVM wallet service built on Tether WDK.",