axelrod

# Axelrod

Execute Base-chain trading and on-chain queries using natural language through the AIxVC AI Automation.

## Quick Start

### First-Time Setup

1. **Configure credentials** in OpenClaw config under `skills.entries.axelrod.env`:

```json
{
  "skills": {
    "entries": {
      "axelrod": {
        "enabled": true,
        "env": {
          "AIXVC_ACCESS_KEY": "your_access_key",
          "AIXVC_SECRET_KEY": "your_secret_key"
        }
      }
    }
  }
}
```

2. **Install dependencies**:

```bash
pip install -r skills/axelrod/requirements.txt
```

3. **Verify setup**:

```bash
python skills/axelrod/scripts/axelrod_chat.py --message "check my balance"
```

## Core Usage

### Simple Query

For straightforward requests that complete quickly:

```bash
python skills/axelrod/scripts/axelrod_chat.py --message "check my ETH balance"
python skills/axelrod/scripts/axelrod_chat.py --message "what is ETH price now"
```

### JSON Debug Mode

For inspecting the full API response:

```bash
python skills/axelrod/scripts/axelrod_chat.py --message "check my balance" --json
```

## Mandatory Workflow

1. **Check AK/SK** — If `AIXVC_ACCESS_KEY` or `AIXVC_SECRET_KEY` is missing, ask the user to configure them. Do not guess or fabricate credentials.
2. **Run the script** — Whenever the request needs real-time on-chain data or execution, always run the CLI. Do not answer from model memory alone.
3. **Return stdout** — Capture the script's stdout and return it to the user. Light formatting is fine, but do not omit key results (amounts, tx hashes, confirm keys, error messages).
4. **Handle confirmation** — If the response includes `confirmKey`, guide the user to confirm or cancel (see Confirmation Flow below).

## Capabilities Overview

### Trading Operations

- **Spot Buy/Sell/Swap**: Exchange tokens on Base chain
- **DCA**: Dollar-cost averaging automation (e.g. "DCA 20u into ETH every day")
- **Limit/Trigger Orders**: Execute at target prices or PnL rates
- **RSI Strategy**: Con...

# Axelrod — Base Chain Trading Skill for OpenClaw

[AIxVC AI Automation](https://aixvc.io/chat) **skill pack** for [OpenClaw](https://github.com/openclaw/openclaw) (also known as Moltbot).

Axelrod enables every OpenClaw agent to trade, query, and automate strategies on the **Base chain** through the AIxVC AI Automation. It supports spot buy/sell/swap, DCA, limit/trigger orders, RSI strategies, token analysis, balance and price queries, order management, and take-profit/stop-loss orders — all via natural language commands.

This skill runs via a Python CLI at **scripts/axelrod_chat.py**, which calls the AIxVC AI Automation with AK/SK SigV4-style signing and returns human-readable results to the agent.

## Installation

1. Clone the axelrod repository:

   ```bash
   git clone https://github.com/AIxVC-Team/axelrod.git
   ```

2. **Add the skill directory** to OpenClaw config (`~/.openclaw/openclaw.json`):

   ```json
   {
     "skills": {
       "load": {
         "extraDirs": ["/path/to/axelrod"]
       }
     }
   }
   ```

   Use the path to the root of this skill (the skill lives at `SKILL.md`; the script is at `scripts/axelrod_chat.py`).

3. **Install dependencies** (required for the CLI):

   ```bash
   pip install -r skills/axelrod/requirements.txt
   ```

## Configure Credentials

**Configure credentials** under `skills.entries.axelrod.env`:

```json
{
  "skills": {
    "entries": {
      "axelrod": {
        "enabled": true,
        "env": {
          "AIXVC_ACCESS_KEY": "your_access_key",
          "AIXVC_SECRET_KEY": "your_secret_key"
        }
      }
    }
  }
}
```

| Variable             | Description                                        |
| -------------------- | -------------------------------------------------- |
| `AIXVC_ACCESS_KEY`   | AIxVC OpenAPI access key (AK).                     |
| `AIXVC_SECRET_KEY`   | AIxVC OpenAPI secret key (SK), used for signing.   |

To obtain the credentials:

1. Contact the AIxVC team or visit the AIxVC platform...