authenticate-wallet

Sign in to AgnicPay wallet via browser-based OAuth. Use when you or the user want to authenticate, sign in, log in, connect wallet, or set up the CLI. Covers phrases like "sign in", "log in", "authenticate", "connect my wallet", "set up agnic".

3,891 stars

byopenclaw

Complexity: easy

View on GitHub Installation ↓

About this skill

This AI agent skill enables secure authentication for the `awal` payments wallet. It automates the process of logging in, connecting, or setting up the wallet, which is essential before performing any transactional operations such as sending, trading, or funding. The skill is designed to handle situations where the wallet is not signed in or when authentication errors occur during other wallet operations. The authentication flow is a robust two-step email OTP (One-Time Password) mechanism. The agent first initiates a login sequence by providing an email address, which triggers the delivery of a 6-digit verification code to that email and provides a unique `flowId`. Subsequently, the agent, either by accessing the user's email directly or by prompting the user for the OTP, completes the authentication by verifying the `flowId` and the received code. This skill significantly streamlines wallet management for AI agents, allowing them to independently manage authentication state. By providing a clear sequence of `npx awal` CLI commands, it ensures reliable and secure access to wallet functionalities, enhancing the agent's capabilities in financial or Web3-related tasks.

Best use case

The primary use case is to establish or re-establish an authenticated session with the `awal` payments wallet, enabling subsequent secure financial transactions. AI agents managing user funds or performing Web3 operations will benefit most, as it provides a standardized and secure method to handle wallet logins programmatically, reducing friction and manual intervention.

The `awal` wallet will be successfully signed in, displaying its address and status, and allowing subsequent authenticated operations.

Practical example

Example input

Log in to my `awal` payments wallet using user@example.com.

Example output

Initiating login for user@example.com...
A 6-digit OTP has been sent to user@example.com. Please provide the OTP received.
flowId: abc123
(User provides OTP: 123456)
Verifying OTP...
Wallet authenticated successfully!
Wallet Address: 0x...
Status: Signed in

When to use this skill

When the user explicitly requests to log in, sign in, connect, or set up their `awal` wallet.
Before any `awal` wallet operation (like sending, trading, or funding) that requires authentication.
When a previous `awal` wallet operation fails due to "not signed in" or authentication errors.
To verify the current authentication status of the `awal` wallet.

When not to use this skill

If the user does not use the `awal` payments wallet.
If the user explicitly does not want to authenticate or connect their wallet.
For operations that do not require wallet access or authentication.
If the user cannot provide an email or OTP code when prompted.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/agnicpay-authenticate-wallet/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/agnicpay-prog/agnicpay-authenticate-wallet/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/agnicpay-authenticate-wallet/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How authenticate-wallet Compares

Feature / Agent	authenticate-wallet	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	easy	N/A

Frequently Asked Questions

What does this skill do?

How difficult is it to install?

The installation complexity is rated as easy. You can find the installation instructions above.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

Best AI Skills for Claude

Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

ChatGPT vs Claude for Agent Skills

Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.

SKILL.md Source

# Authenticating the AgnicPay Wallet

Use `npx agnic@latest auth login` to authenticate via browser-based OAuth. This opens the user's default browser to AgnicPay where they sign in and set spending limits for the CLI session.

## Confirm wallet is initialized and authed

```bash
npx agnic@latest status
```

If already authenticated, no further action is needed. If not authenticated, proceed with login.

## Login Flow

```bash
npx agnic@latest auth login
```

This command:
1. Starts a temporary local server on a random port
2. Opens the user's default browser to AgnicPay's OAuth consent screen
3. The user signs in (email, Google, or wallet) and approves spending limits
4. The browser redirects back to `http://localhost:<port>/callback`
5. The CLI exchanges the authorization code for tokens and saves them locally

Wait for the CLI to print `✓ Authenticated!` before proceeding.

## Verify Authentication

After login, confirm the session is active:

```bash
npx agnic@latest status
```

Expected output:

```
Wallet Status
✓ Authenticated

Email: user@example.com
Wallet: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
Expires: 2026-05-22 14:30:00 UTC
```

## Logout

To remove stored credentials:

```bash
npx agnic@latest auth logout
```

## Token Storage

Credentials are stored in `~/.agnic/config.json` with restricted permissions (`0600`). Tokens auto-refresh on 401 responses — no manual re-authentication needed until the refresh token expires (90 days).

## Error Handling

Common errors:

- "Not authenticated" — Run `npx agnic@latest auth login`
- "Authentication failed" — User cancelled the browser flow or the timeout (5 min) expired
- "Could not open browser" — The CLI prints a URL to copy and open manually
- "Token expired" — Tokens auto-refresh; if refresh also fails, re-run `npx agnic@latest auth login`

Related Skills

AgentWallet — Non-Custodial Smart Wallets for AI Agents

3891