Agent Wallet

For Openclaw:

npx @agentlayer.tech/wallet install --yes

For Codex:

npx @agentlayer.tech/wallet install --yes && npx @agentlayer.tech/wallet codex install --yes

For Claude Code:

npx @agentlayer.tech/wallet install --yes && npx @agentlayer.tech/wallet claude-code install --yes

Or install entirely from inside the Claude Code CLI, via the plugin marketplace (no terminal/npx needed) — two commands, then restart:

/plugin marketplace add lopushok9/Agent-Layer
/plugin install agent-wallet@agentlayer

Restart Claude Code (or run /reload-plugins). On the next session start a SessionStart hook installs the backend runtime automatically — a bridge to the same install --yes that configures the wallet out of the box. No third command needed. (Prefer to trigger it by hand instead? Run /wallet-setup. Opt out of the auto-install with AGENT_WALLET_AUTO_BOOTSTRAP=0 — the hook then only reminds you to run /wallet-setup.)

To get team members down to effectively zero typed commands, pre-register the marketplace in .claude/settings.json so Claude Code prompts to install on trust:

{
  "extraKnownMarketplaces": {
    "agentlayer": { "source": { "source": "github", "repo": "lopushok9/Agent-Layer" } }
  },
  "enabledPlugins": { "agent-wallet@agentlayer": true }
}

For Hermes:

npx @agentlayer.tech/wallet install --yes && npx @agentlayer.tech/wallet hermes install --yes

AgentLayer is a beta local-first wallet and finance stack for agents.

The repository includes:

• agent-wallet/ - the main wallet backend for AgentLayer
• .openclaw/ - the local AgentLayer bridge layer for the OpenClaw wallet integration
• hermes/ - optional Hermes Agent plugin bridge for the same wallet backend
• codex/ - optional Codex plugin bridge for the same wallet backend
• wdk-btc-wallet/ - the local Bitcoin wallet service
• wdk-evm-wallet/ - the local EVM wallet service
• provider-gateway/ - shared provider access for Solana RPC, Bags, and related finance reads
• mcp-server/ - the finance and crypto MCP layer

The goal is simple:

• keep wallet secrets local
• let agents use constrained wallet capabilities
• support real onchain flows without giving agents direct key ownership

Beta

This project is in beta.

Do not treat it as a finished production wallet stack. Test every flow before relying on it.

Quick install

System prerequisites:

• python3
• node
• npm

Install the local runtime:

npx @agentlayer.tech/wallet install --yes

Install the native OpenClaw plugin from ClawHub:

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:

npm install -g @agentlayer.tech/wallet
wallet install --yes

The CLI uses a versioned runtime layout:

~/.openclaw/agent-wallet-runtime/releases/<version>
~/.openclaw/agent-wallet-runtime/current

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:

wallet status
wallet doctor
wallet hermes install --yes
wallet codex install --yes
wallet update --yes
wallet update --yes --dry-run
wallet rollback

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.

Native OpenClaw plugin installs

Use ClawHub when you want the plugin installed through OpenClaw:

openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin

Recommended order:

1. Install or update the local runtime with npx @agentlayer.tech/wallet install --yes.
2. Install the plugin package from ClawHub with openclaw plugins install clawhub:....
3. Restart the OpenClaw gateway and enable/configure the plugin entry in openclaw.json.

The agent-wallet ClawHub plugin checks the standard runtime path at: