Errand Ai

# ErrandAI Skill

## Overview
Enable your AI assistant to post and manage errands for human workers through the ErrandAI platform. This skill integrates OpenClaw with ErrandAI's decentralized task marketplace.

## Features
- 🤖 **Natural Language Commands** - Post errands using conversational language
- 📊 **Status Tracking** - Check errand status and submissions in real-time
- ✅ **Work Review** - Approve or reject submissions with feedback
- 💰 **Automated Payments** - USDC payments released automatically upon approval
- 🌍 **Global Reach** - Post errands for any location worldwide

## Installation

### Prerequisites
- OpenClaw v1.0.0 or higher
- Node.js v14.0.0 or higher
- ErrandAI API key (get from [errand.be/dashboard](https://errand.be/dashboard))

### Quick Install
```bash
openclaw skill install errand-ai
```

### Manual Installation
1. Download the skill files
2. Copy to OpenClaw skills directory:
   ```bash
   cp -r errand-ai ~/.openclaw/skills/
   ```
3. Set your API key:
   ```bash
   export ERRANDAI_API_KEY="your_api_key_here"
   ```
4. Enable the skill:
   ```bash
   openclaw skill enable errand-ai
   ```

## Configuration

### Environment Variables
```bash
# Required
ERRANDAI_API_KEY=your_api_key_here

# Optional (defaults shown)
ERRANDAI_API_URL=https://api.errand.be
```

### OpenClaw Config
```yaml
# ~/.openclaw/config.yaml
skills:
  errand-ai:
    enabled: true
    api_key: ${ERRANDAI_API_KEY}
    api_url: ${ERRANDAI_API_URL}
    default_reward: 15  # Default reward in USDC
    default_deadline_hours: 24
```

## Usage Examples

### Post an Errand
```
You: Post an errand to check iPhone 15 stock at Apple Store Gangnam for $20
OpenClaw: ✅ Errand posted successfully!
Title: check iPhone 15 stock at Apple Store Gangnam
Location: Apple Store Gangnam
Reward: $20 USDC
ID: err_abc123
URL: https://errand.be/errand/err_abc123
```

### Check Status
```
You: Check errand err_abc123
OpenClaw: 📋 Errand Status
Title: check iPhone 15 stock at Apple Store Gangnam...

# ErrandAI Skill for OpenClaw

Enable your AI assistant to post and manage errands for human workers through the ErrandAI platform.

## Features

- 🤖 Post errands using natural language
- 📊 Check errand status and submissions
- ✅ Review and approve/reject work submissions
- 💰 Automated payment handling
- 🌍 Multi-location support

## Installation

### 1. Install the Skill

```bash
# Clone or download this skill
git clone https://github.com/errandai/openclaw-skill.git

# Copy to OpenClaw skills directory
cp -r openclaw-skill/errandai ~/.openclaw/skills/

# Or install via OpenClaw CLI (if available)
openclaw skill install errandai
```

### 2. Configure API Credentials

Get your API key from [ErrandAI Dashboard](https://errand.be/dashboard)

```bash
# Set environment variables
export ERRANDAI_API_KEY="your_api_key_here"
export ERRANDAI_API_URL="https://api.errand.be"  # Optional, defaults to production

# Or add to ~/.openclaw/.env
echo "ERRANDAI_API_KEY=your_api_key_here" >> ~/.openclaw/.env
```

### 3. Enable the Skill

Add to your OpenClaw configuration:

```yaml
# ~/.openclaw/config.yaml
skills:
  errandai:
    enabled: true
    api_key: ${ERRANDAI_API_KEY}
    api_url: ${ERRANDAI_API_URL}
```

Or enable via CLI:

```bash
openclaw skill enable errandai
```

## Usage

### Natural Language Commands

```
You: Post an errand to check iPhone 15 stock at Apple Store Gangnam for $20
OpenClaw: ✅ Errand posted successfully!
Title: check iPhone 15 stock at Apple Store Gangnam
Location: Apple Store Gangnam
Reward: $20 USDC
ID: err_abc123
URL: https://errand.be/errand/err_abc123

You: Check errand err_abc123
OpenClaw: 📋 Errand Status
Title: check iPhone 15 stock at Apple Store Gangnam
Status: in_progress
Reward: $20 USDC
Submissions: 2

You: Approve submission sub_def456
OpenClaw: ✅ Submission approved! Payment has been released to the worker.
```

### Command Examples

#### Post Errands
- "Post errand to take photo of coffee menu at Starbucks Downtown for $15"
- "Creat...