# Agent Wallet: Hermes Agent plugin

> Approval-gated multi-chain wallet for agents.

Canonical: https://hermeswatcher.com/plugins/agent-wallet  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/agent-wallet  
Last updated in catalog: 2026-11-14

Approval-gated multi-chain wallet for agents. Default coins are XMR, BTC and XRP (XRP is receive-only in this release); ETH, POL and USDC on Base and Polygon are one toggle away. The agent can ask to pay, propose an auto-pay mandate, ask for a capped sandbox budget (created unfunded) or close an incoming order. A human types a six-digit PIN on a card that shows the exact destination, amount, fee and fiat value for each manual payment; a budget or autopay that human armed spends unattended — capped, receipted, no per-payment PIN. No key material ever enters the Hermes process: a daemon (walletd) holds an encrypted keystore, signs Bitcoin and EVM locally, supervises the Monero signer, enforces spend policy, and writes Ed25519-signed, hash-chained receipts (denials included, anchored so truncation is detected). Purchases can be priced from an HTTP 402 (x402) response and settled with an EIP-3009 authorisation. 23 agent tools, one per distinct act. Monero's signer runs as the same OS user, so while the wallet is unlocked a process running as that user — including the agent's terminal — can reach it directly (docs/THREAT-MODEL.md states this). Ships a native Desktop page (balances, approvals, mandates, sandboxes, receipts, per-coin switches) and full CLI parity.

## Good to know before installing

Crypto wallet that moves real funds: runs a local daemon (walletd, a 0600 unix socket) and, after an explicit `signer install`, downloads the official monero-wallet-rpc release (SHA256-pinned) and runs it on 127.0.0.1; it sends balance, height and broadcast requests to public third-party nodes (Monero community nodes, blockstream.info/mempool.space, XRPL public servers, Base/Polygon public RPCs) and fiat price lookups to CoinGecko/Kraken; it fetches any checkout URL the agent is asked to pay (public addresses only); payments need a PIN typed in the Wallet pane, except budgets and autopays the user arms as unattended, which spend within their caps without asking; while the wallet is unlocked, any process running as your user, including the agent's terminal, can reach the Monero signer directly and bypass the PIN; `hermes wallet service install` adds a systemd --user unit.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install agent-wallet
```

2. Said no? Turn it on later:

```bash
hermes plugins enable agent-wallet
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Security & privacy, Cost, speed & monitoring
- Maintained by: BlackHelio (Community)
- Needs: No API keys declared
- Adds tools: `wallet_merchants`, `wallet_contacts`, `wallet_contact_save`, `wallet_deposits`, `wallet_sandboxes`, `wallet_request_sandbox`, `wallet_orders`, `wallet_close_order`, `wallet_readiness`, `wallet_nodes`, `wallet_status`, `wallet_balances`, `wallet_pay_url`, `wallet_receive_address`, `wallet_cancel`, `wallet_spend`, `wallet_ledger`, `wallet_verify_payment`, `wallet_request_approval`, `wallet_request_payment`, `wallet_mandate_propose`, `wallet_mandate_list`, `wallet_mandate_revoke`
- Requires Hermes: `>=0.21.0`
- Version: 0.9.3
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/agent-wallet)
- [Source code](https://github.com/BlackHelio/agent-wallet#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
