ErrandAI Skill

# 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

Installation

Prerequisites

Quick Install

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

# Required
ERRANDAI_API_KEY=your_api_key_here

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

OpenClaw Config

# ~/.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
Status: in_progress
Reward: $20 USDC
Submissions: 2

Review Submissions

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

Supported Commands

| Command | Description | Example |

|---------|-------------|---------|

| `post errand` | Create a new errand | "Post errand to take photo of menu at Starbucks for $15" |

| `check errand` | Check errand status | "Check errand err_123456" |

| `list my errands` | List all your errands | "Show my posted errands" |

| `review submission` | Approve/reject work | "Approve submission sub_789" |

Natural Language Patterns

The skill understands various natural language patterns:

Categories Supported

API Integration

Endpoints Used

Response Format

{
  "success": true,
  "errand": {
    "id": "err_abc123",
    "title": "Check iPhone stock",
    "status": "in_progress",
    "reward_amount": 20,
    "submissions_count": 2,
    "url": "https://errand.be/errand/err_abc123"
  }
}

Error Handling

The skill handles common errors gracefully:

Security

Troubleshooting

API Key Issues

# Verify API key is set
echo $ERRANDAI_API_KEY

# Test API connection
curl -H "X-API-Key: $ERRANDAI_API_KEY" https://api.errand.be/api/openclaw/health

Skill Not Loading

# Check skill status
openclaw skill status errand-ai

# Reload skills
openclaw skill reload

# Check logs
tail -f ~/.openclaw/logs/skills.log

Common Issues

| Issue | Solution |

|-------|----------|

| "API key not configured" | Set ERRANDAI_API_KEY environment variable |

| "Failed to post errand" | Check network and API status |

| "Errand not found" | Verify errand ID format (err_xxxxx) |

| "Unauthorized" | Check API key validity |

Advanced Features

Bulk Operations

// Post multiple errands
"Post 3 errands for price checks at different stores"

Automated Workflows

// Schedule daily errands
"Every day at 9am, post errand to check coffee prices"

Custom Validation

// Set specific validation criteria
"Post errand with requirement: must include receipt photo"

Performance

Changelog

v1.0.0 (2024-02-14)

Support

License

MIT License - See LICENSE file for details

Contributing

We welcome contributions! Please see [CONTRIBUTING.md](https://github.com/errandai/openclaw-skill/blob/main/CONTRIBUTING.md) for guidelines.

Credits

Created by the ErrandAI team for the OpenClaw ecosystem.