Amrood

Name: Amrood
Rating: 3.5 (1 reviews)
Author: amroodio

By amroodio 👁 31 views ▲ 0 votes

OpenClaw plugin for Amrood — India fiat payment infrastructure for AI agents

GitHub

Install

npm install

#

README

# openclaw-amrood

India fiat payment infrastructure for AI agents on [OpenClaw](https://github.com/openclaw/openclaw).

Fund wallets, pay other agents, hold escrow, and access paid APIs — all in INR via UPI, cards, and netbanking.

## Install

```bash
openclaw plugins install @amroodio/openclaw-amrood
```

### Alternative: MCP server (works today without native plugin)

If you prefer to use Amrood's existing MCP server directly, add this to your `openclaw.json`:

```json5
{
  mcp: {
    servers: {
      amrood: {
        command: "uvx",
        args: ["amrood-mcp"],
        env: {
          AMROOD_AGENT_KEY: "secret://env/AMROOD_AGENT_KEY"
        }
      }
    }
  }
}
```

## Configuration

Add your Amrood agent key to `openclaw.json`:

```json5
{
  plugins: {
    entries: {
      "openclaw-amrood": {
        config: {
          agentKey: "amr_your_key_here",
          // baseUrl: "https://api.amrood.io" // optional, defaults to production
        }
      }
    }
  }
}
```

Or set the `AMROOD_AGENT_KEY` environment variable.

### Getting an agent key

1. Visit [amrood.io](https://amrood.io) and sign up with your phone number
2. Complete KYC (PAN + bank account or UPI)
3. Create an agent — the agent key is shown once, save it

Or use the onboarding tools (`amrood_register` → `amrood_verify` → `amrood_kyc` → `amrood_create_agent`) directly from chat.

### Enabling optional tools

Read-only tools (balance, identity, transactions, verify, proof, escrow status) are always available. Tools with side effects (payments, escrow, onboarding) require explicit opt-in:

```json5
{
  agents: {
    list: [{
      id: "main",
      tools: {
        allow: ["openclaw-amrood"] // enables all tools from this plugin
      }
    }]
  }
}
```

## Tools

### Wallet

| Tool | Description |
|---|---|
| `amrood_balance` | Check wallet balance, total funded, and total spent |
| `amrood_fund` | Get a payment link to add funds (UPI/card/netbanking) |
| `amrood_withdraw` | Withdraw to the owner's bank account (T+1 settlement) |
| `amrood_transactions` | View recent transaction history with optional type filter |

### Payments

| Tool | Description |
|---|---|
| `amrood_pay` | Pay another agent by handle or ID. 0.5% fee (min ₹1) |
| `amrood_http_pay` | Make HTTP requests with automatic x402 payment handling |

### Identity

| Tool | Description |
|---|---|
| `amrood_identity` | Get this agent's handle, name, and status |
| `amrood_verify_agent` | Check if another agent exists on the network |
| `amrood_proof` | Generate a signed identity proof (expires in 1 hour) |

### Escrow

| Tool | Description |
|---|---|
| `amrood_escrow_hold` | Hold funds in escrow (basic, timed, or attested) |
| `amrood_escrow_release` | Release escrowed funds to a recipient |
| `amrood_escrow_refund` | Refund escrowed funds to the sender |
| `amrood_escrow_status` | Check escrow status (held/released/refunded/expired) |

### Onboarding

| Tool | Description |
|---|---|
| `amrood_register` | Send OTP to phone (Step 1) |
| `amrood_verify` | Verify OTP code (Step 2) |
| `amrood_kyc` | Submit PAN + bank/UPI details (Step 3) |
| `amrood_create_agent` | Create agent and get API key (Step 4) |

## Troubleshooting

### Tools not appearing in agent

If you see the plugin loaded (`openclaw plugins inspect openclaw-amrood`) but tools aren't available to the agent:

1. Make sure the plugin is in your allowlist:
   ```json5
   { plugins: { allow: ["openclaw-amrood"] } }
   ```

2. If you use `tools.profile`, add our tools explicitly:
   ```json5
   {
     tools: {
       profile: "coding",
       alsoAllow: ["openclaw-amrood"]
     }
   }
   ```

3. Restart the gateway: `openclaw gateway restart`

See [OpenClaw #47683](https://github.com/openclaw/openclaw/issues/47683) for details on the known tool registration issue.

### Authentication errors

- Verify your agent key: `openclaw plugins inspect openclaw-amrood`
- Check the key is set correctly in config or environment
- Test the key directly: `curl -H "x-agent-key: amr_..." https://api.amrood.io/v1/agents/me`

## Development

```bash
git clone https://github.com/amroodio/openclaw-amrood.git
cd openclaw-amrood
npm install

# Run unit tests
npm test

# Run integration tests (requires AMROOD_TEST_AGENT_KEY env var)
npm run test:integration

# Type check
npm run build

# Install locally in OpenClaw for E2E testing
openclaw plugins install --link ./
```

## License

MIT

tools