# Send Agent Wallet CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agent-wallet-cli",
    "name": "Agent Wallet CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/donald-jackson/agent-wallet-cli",
    "canonicalUrl": "https://clawhub.ai/donald-jackson/agent-wallet-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-wallet-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wallet-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-wallet-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T13:48:27.705Z",
      "expiresAt": "2026-05-06T13:48:27.705Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wallet-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wallet-cli",
        "contentDisposition": "attachment; filename=\"agent-wallet-cli-1.4.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-wallet-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agent-wallet-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agent-wallet-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-wallet-cli",
    "agentUrl": "https://openagent3.xyz/skills/agent-wallet-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-wallet-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-wallet-cli/agent.md"
  }
}
```
## Documentation

### Agent Wallet

Self-custodial crypto wallet CLI for AI agents. Your keys, your coins — the agent never sees your mnemonic after init.

Open source: github.com/donald-jackson/agent-wallet-cli — audit before use
npm package: npmjs.com/package/agent-wallet-cli
Self-custodial: Keys encrypted locally with Argon2id + AES-256-GCM. No server, no third party.
Session-based access: Agents use time-limited tokens, never your password directly.
Multi-chain: Ethereum, Solana, Polygon, Arbitrum, Base — native coins and tokens.

### Security Model

You create or import a wallet with a password → encrypted on disk in ~/.agent-wallet-cli/
You (or the agent) unlock with the password → get a time-limited session token (wlt_...)
The agent uses only the session token — it expires automatically (default 1hr, max 24hr)
No telemetry, no analytics, no server calls — only public blockchain RPCs for queries and transactions

Important: If you give the agent your WALLET_PASSWORD, it can perform any password-level operation (init, import, unlock, and export). For maximum security, unlock the wallet yourself and only give the agent the session token. Session tokens cannot export mnemonics or change passwords — they can only sign transactions and read balances.

Before trusting this skill with real funds:

Audit the source: github.com/donald-jackson/agent-wallet-cli
Verify the npm package matches the repo: npm info agent-wallet-cli
Test with small amounts first
Use short session durations (1hr default)
Run in an isolated environment if possible

### Setup

npm install -g agent-wallet-cli

Verify installation: agent-wallet-cli --version

### Workflow

Init (first time): agent-wallet-cli init --password "$WALLET_PASSWORD"

Displays mnemonic ONCE — save it securely


Import (existing wallet): agent-wallet-cli import --password "$WALLET_PASSWORD" --mnemonic "word1 word2 ..."
Unlock: agent-wallet-cli unlock --password "$WALLET_PASSWORD" --duration 3600

Returns session token (wlt_...) valid for specified duration


Use: Pass --token wlt_... to all commands (no password needed)
Lock: agent-wallet-cli lock when done

Note: --password and --mnemonic can be omitted to be prompted securely via stdin (recommended for interactive use). When using in automation, --password is accepted but will show a warning about shell history visibility.

### Global Options

All commands accept:

--format json|text (default: json)
--wallet-dir <path> (default: ~/.agent-wallet-cli)
--quiet — suppress output
--name <name> — wallet name (default: "default")

### Wallet Management

agent-wallet-cli init [--password <pw>] [--word-count 12|24] [--name <name>]
agent-wallet-cli import [--password <pw>] [--mnemonic "<phrase>"] [--name <name>]
agent-wallet-cli unlock [--password <pw>] [--duration <secs>] [--name <name>]
agent-wallet-cli lock [--name <name>]
agent-wallet-cli export [--password <pw>] --confirm [--name <name>]

### Addresses & Balances

agent-wallet-cli address --token <wlt_...> [--chain ethereum|solana] [--account-index 0]
agent-wallet-cli balance --token <wlt_...> --chain <chain> [--network <network>] [--token-address usdc]

Important: --chain is required for balance/send/history. --token is the session token (wlt_...), --token-address is the coin/token contract or alias.

L2 networks: For Base, Polygon, Arbitrum use --chain ethereum --network base (etc). Default network is mainnet.

### Transfers

# Native (ETH/SOL)
agent-wallet-cli send --token <wlt_...> --chain <chain> --to <addr> --amount <amt> --yes [--dry-run] [--no-relay]
# ERC-20/SPL token
agent-wallet-cli send --token <wlt_...> --chain <chain> --to <addr> --amount <amt> --token-address <addr|alias> --yes [--no-relay]

--yes: Skip confirmation prompt (required for non-TTY/agent use)
--dry-run: Simulate transaction without sending
--no-relay: Disable gasless relay fallback
--network <network>: Target network (default: mainnet)

### x402 Payments

agent-wallet-cli x402 <url> --token <wlt_...> [--method GET] [--header "Key:Value"] [--body <data|@file>] [--max-amount <amt>] [--dry-run] [--yes]

Make HTTP requests with automatic x402 payment. The CLI detects 402 Payment Required responses, pays the requested amount in stablecoins, and retries.

--max-amount <amount>: Maximum willing to pay (human-readable, e.g. "0.10")
--dry-run: Show payment requirements without paying
--yes: Skip payment confirmation
--header: Repeatable for multiple headers
--body: Request body, or @filepath to read from file

### Approvals (ERC-20/SPL)

agent-wallet-cli approve --token <wlt_...> --chain <chain> --token-address <addr> --spender <addr> --amount <amt|unlimited> --yes [--network <net>]
agent-wallet-cli allowance --chain <chain> --token-address <addr> --owner <addr> --spender <addr> [--network <net>]
agent-wallet-cli transfer-from --token <wlt_...> --chain <chain> --token-address <addr> --from <addr> --to <addr> --amount <amt> --yes [--network <net>]
agent-wallet-cli approvals --token <wlt_...> [--chain ethereum] [--network mainnet] [--limit 20]

### Signing

agent-wallet-cli sign --token <wlt_...> --chain <chain> --message "text"
agent-wallet-cli sign --token <wlt_...> --chain <chain> --typed-data '<json|@file>'
agent-wallet-cli sign --token <wlt_...> --chain <chain> --data <hex>

### Transaction History

agent-wallet-cli history --token <wlt_...> --chain <chain> [--network mainnet] [--limit 10]

### Network Configuration

agent-wallet-cli networks                                          # list all
agent-wallet-cli networks --set ethereum:mainnet --rpc-url <url>   # custom RPC
agent-wallet-cli networks --reset ethereum:mainnet                 # reset to default

### Chains & Networks

ChainNetworksethereummainnet, sepolia, polygon, arbitrum, base, base-sepoliasolanamainnet, devnet

EVM L2s (Base, Polygon, Arbitrum) use --chain ethereum --network <l2name>.

--chain is required for balance, send, history, approve, allowance, transfer-from, approvals, and sign.

### Token Aliases

Use shorthand instead of contract addresses: usdc, usdt, dai, weth, wbtc

### Security Notes

Self-custodial — keys never leave your machine, encrypted at rest
No analytics, no telemetry, no network calls except to public RPCs for blockchain queries
Session tokens grant temporary fund access — treat as passwords
Always --dry-run before large transfers
Lock wallet when done
Never log or share session tokens or mnemonics
Audit the source: github.com/donald-jackson/agent-wallet-cli
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: donald-jackson
- Version: 1.4.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T13:48:27.705Z
- Expires at: 2026-05-06T13:48:27.705Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-wallet-cli)
- [Send to Agent page](https://openagent3.xyz/skills/agent-wallet-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-wallet-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-wallet-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-wallet-cli)