authenticate-wallet
Sign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or "not signed in" errors. This skill is a prerequisite before sending, trading, or funding.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xrag/authenticate-walletWhat This Skill Does
The authenticate-wallet skill provides a structured interface for OpenClaw AI agents to manage secure, session-based authentication for the Payments Wallet. It leverages the npx awal CLI tool to perform two-factor authentication, ensuring that wallet interactions—such as sending funds, trading assets, or checking balances—are authorized and secure. By automating the login flow, this skill removes the friction of manual wallet management, allowing the agent to handle the heavy lifting of authentication via email-based OTP verification.
Installation
To integrate this skill into your environment, run the following command in your terminal:
clawhub install openclaw/skills/skills/0xrag/authenticate-wallet
Ensure you have the latest npx and environment access configured to execute the awal CLI commands successfully.
Use Cases
This skill is essential whenever your agent needs to perform financial transactions. Use it to initiate an authentication session when starting a new workspace, when the agent detects a 'not signed in' error during a transaction, or whenever the session times out. It is also highly effective for onboarding users to a new wallet environment by guiding them through the initial auth login and auth verify steps.
Example Prompts
- "I need to check my USDC balance, please make sure the wallet is authenticated first."
- "Log me into my payments wallet so I can start sending funds. Here is my email: [email protected]."
- "The wallet says I'm not signed in. Can you trigger the login flow and let me know when you need the OTP?"
Tips & Limitations
Always check the wallet status first using npx awal status to avoid unnecessary login attempts. Note that the flowId returned during the login step is transient and required for the verification step; if you lose it, you will need to restart the login process. Security is paramount: ensure that the agent only handles authentication when the user provides explicit consent, and never share OTP codes outside of the authorized auth verify CLI command context. If authentication continues to fail, verify your internet connection and ensure the npx package is updated to the latest version.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xrag-authenticate-wallet": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api, code-execution
Related Skills
trade
Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH".
search-for-service
Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
fund
Add money to the wallet. Use when you or the user want to fund, deposit, top up, load, buy USDC, add funds, onramp, or get USDC. Also use when the wallet has insufficient balance for a send or trade operation, or when someone asks "how do I get USDC?"
send-usdc
Send USDC to an Ethereum address or ENS name. Use when you or the user want to send money, pay someone, transfer USDC, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", or "transfer to vitalik.eth".
monetize-service
Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers "make money by offering an endpoint", "sell a service", "monetize your data", "create a paid API".