← Back to Skills Marketplace
517
Downloads
0
Stars
0
Active Installs
13
Versions
Install in OpenClaw
/install monero-wallet
Description
Official KYC-rip Monero Agent Skill. Manage XMR wallets on Mainnet/Stagenet via Ripley Gateway.
Usage Guidance
This skill is internally coherent: it expects you to run a local Ripley Gateway and to supply a gateway API key (AGENT_API_KEY). Before installing, verify you trust the skill source and the Ripley Docker images (kyc.rip / GitHub repo), because running a local gateway image gives that code access to your node/wallet. Only set AGENT_API_KEY if the gateway is genuinely under your control (127.0.0.1 is enforced by the helper script). Be aware that using pay-402 will spend real XMR — double-check nonce/address/amounts and transaction logs to avoid duplicate payments. If you need higher assurance, review the GitHub repo and Docker image manifests and run the gateway in an isolated environment first.
Capability Analysis
Type: OpenClaw Skill
Name: monero-wallet
Version: 1.0.12
The skill facilitates Monero wallet management and includes instructions in SKILL.md for the agent to automatically perform financial transfers when encountering HTTP 402 'Payment Required' challenges from external websites. While the script monero_wallet_rpc.py includes defensive measures like hardcoding the gateway to 127.0.0.1 to prevent API key exfiltration, the automated payment logic based on untrusted WWW-Authenticate headers is a high-risk capability that could be exploited by malicious third-party sites to drain the wallet. The behavior is aligned with the stated purpose of the skill, but the automation of payments based on external input warrants a suspicious classification.
Capability Assessment
Purpose & Capability
Name/description (manage XMR via Ripley Gateway) match the declared requirements: python3, curl, AGENT_API_KEY, and a local gateway. The single included script and curl examples are appropriate for that purpose.
Instruction Scope
SKILL.md instructs the agent to talk only to a local Ripley Gateway (127.0.0.1:38084) or use the included Python helper. The instructions focus on balance, addresses, transfers, and XMR402 payment flows; they do not instruct reading unrelated files or exfiltrating arbitrary data. Note: the skill directs the agent to perform on-chain payments (pay-402), which is within scope but implies financial consequences.
Install Mechanism
No install spec (instruction-only) and a small helper script included. No downloads from remote URLs or archive extraction. Declared pip dependency (requests) is reasonable for the helper script.
Credentials
Only AGENT_API_KEY is required and is used as the gateway authentication key; that is proportional to the skill's function. The helper script reads only that env var (or an explicit --api-key). No other secrets or unrelated env vars are requested.
Persistence & Privilege
Skill is not forced to always-load and uses normal autonomous invocation. It does not request system-wide config changes, nor access to other skills' credentials or config paths.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install monero-wallet - After installation, invoke the skill by name or use
/monero-wallet - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
No user-visible changes in this version.
- No file changes detected.
- Documentation and functionality remain the same as previous release.
v1.0.11
- Added "Get Wallet Address" and its usage to the Python helper commands.
- Expanded REST API documentation: added endpoints for getting wallet address, XMR402 payment gating (`pay_402`), proof recovery (`get_proof`), and viewing the transaction log.
- Introduced detailed instructions and flow for handling HTTP 402 (XMR402 protocol) Monero-paywalled APIs, including duplicate payment prevention and proof recovery methods.
- Clarified security features: spending limits, privacy tips, OPSEC advice, and gateway host binding.
- Minor updates for accuracy and step reordering in the command sections.
v1.0.10
- Added "get-network" command to the Python RPC helper instructions for checking network orientation.
- Documented the corresponding "GET /network" REST API endpoint for network status checks.
- Improved documentation for network-related operations; no other changes detected.
v1.0.9
- Updated gateway installation instructions to refer users to official setup site (kyc.rip/ripley) instead of inline Docker command.
- Clarified that all components (Monero node, wallet RPC, gateway) are started by the official setup.
- Minor formatting improvements for easier reading.
- No changes to functionality or requirements.
v1.0.8
**Adds gateway setup instructions and Docker pre-conditions for Monero agent skill.**
- Added section detailing the requirement to run the gateway locally using Docker before using the skill.
- Provided official install script and verification steps for setting up the gateway stack.
- Clarified pre-conditions necessary for proper skill operation.
- All helper commands and usage instructions remain unchanged.
- Improves clarity for new users setting up the Monero wallet agent.
v1.0.7
- REST API usage example updated to use the explicit local gateway URL: http://127.0.0.1:38084/sync
- No other changes detected.
v1.0.6
- Updated environment variable requirements: `AGENT_GATEWAY_URL` is no longer needed.
- Adjusted metadata to remove the `AGENT_GATEWAY_URL` and clarify only `AGENT_API_KEY` is required.
- Updated documentation to reflect connection is now via a secure **Local** Gateway.
- Clarified environment configuration and removed the default gateway URL reference.
v1.0.5
- Added documentation and instructions for the new Native Python RPC Helper (`monero_wallet_rpc.py`) as the primary interface for wallet actions.
- REST API usage documentation has been moved to a secondary/fallback position.
- Provided explicit, copy-paste-ready examples for both Python and curl operation modes.
- Clarified authentication setup in the Python helper and streamlined setup instructions.
v1.0.4
- Added support for configuring the Ripley Gateway endpoint via the new AGENT_GATEWAY_URL environment variable.
- Updated environment requirements: now requires AGENT_GATEWAY_URL (optional) and the Python 'requests' package.
- Clarified environment configuration details and security best practices in documentation.
- Moved official swap service mention to a dedicated section, improving guidance for users with insufficient funds.
- Enhanced warnings about transmitting AGENT_API_KEY to untrusted endpoints.
v1.0.3
### Added
- **OpenClaw Support**: Integrated `metadata.openclaw` with `primaryEnv: AGENT_API_KEY` to enable the configuration panel UI.
- **Ecosystem Meta**: Added `emoji`, `categories`, and `homepage` to standard skill definition.
- **Skill CLI**: Added a custom installation guide for `clawhub install` and `gemini skills install`.
- **Swap Guidance**: Integrated explicit instructions for agents to suggest [kyc.rip/swap](https://kyc.rip/swap) when wallet balance is insufficient.
### Changed
- **Authenticated Architecture**: Migrated all instructions from plain Python scripts to secure, authenticated HTTP Gateway calls.
- **Identity Refinement**: Formally branded as the official **Ripley XMR Gateway** skill.
- **Helper Script Optimization**: `monero_wallet_rpc.py` now supports explicit `--api-key` passing for better integration with host-injected environments.
### Security
- **Mandatory Authentication**: All agent tools now require `AGENT_API_KEY`.
- **Privacy Focus**: Enhanced guidelines for subaddress generation to ensure on-chain anonymity.
v1.0.2
### Added
- **OpenClaw Support**: Integrated `metadata.openclaw` with `primaryEnv: AGENT_API_KEY` to enable the configuration panel UI.
- **Ecosystem Meta**: Added `emoji`, `categories`, and `homepage` to standard skill definition.
- **Skill CLI**: Added a custom installation guide for `clawhub install` and `gemini skills install`.
- **Swap Guidance**: Integrated explicit instructions for agents to suggest [kyc.rip/swap](https://kyc.rip/swap) when wallet balance is insufficient.
### Changed
- **Authenticated Architecture**: Migrated all instructions from plain Python scripts to secure, authenticated HTTP Gateway calls.
- **Identity Refinement**: Formally branded as the official **Ripley XMR Gateway** skill.
- **Helper Script Optimization**: `monero_wallet_rpc.py` now supports explicit `--api-key` passing for better integration with host-injected environments.
### Security
- **Mandatory Authentication**: All agent tools now require `AGENT_API_KEY`.
- **Privacy Focus**: Enhanced guidelines for subaddress generation to ensure on-chain anonymity.
v1.0.1
- Updated skill description to clarify Ripley Gateway usage and endpoint requirements.
- Metadata now specifies that the `AGENT_API_KEY` environment variable is required.
- Documentation now explicitly states that the API key must be sourced from `AGENT_API_KEY`.
- No changes to code or functionality.
v1.0.0
Initial release of the Monero Wallet Skill:
- Official Monero agent skill for managing XMR wallets on Mainnet and Stagenet.
- Provides REST API access for checking sync status, viewing balances, creating subaddresses, and sending payments.
- Includes security practices such as API key authentication and privacy-conscious usage.
- Designed for autonomous, non-custodial wallet management through an authenticated Gateway.
Metadata
Frequently Asked Questions
What is Monero Wallet?
Official KYC-rip Monero Agent Skill. Manage XMR wallets on Mainnet/Stagenet via Ripley Gateway. It is an AI Agent Skill for Claude Code / OpenClaw, with 517 downloads so far.
How do I install Monero Wallet?
Run "/install monero-wallet" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Monero Wallet free?
Yes, Monero Wallet is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Monero Wallet support?
Monero Wallet is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Monero Wallet?
It is built and maintained by XBToshi (@xbtoshi); the current version is v1.0.12.
More Skills