ErrandAI Skill

Overview

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)

Quick Install

openclaw skill install errand-ai

Manual Installation

• Download the skill files
• Copy to OpenClaw skills directory:

cp -r errand-ai ~/.openclaw/skills/

• Set your API key:

export ERRANDAI_API_KEY="your_api_key_here"

• Enable the skill:

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

Natural Language Patterns

• "Create an errand to..."
• "I need someone to..."
• "Post a task for..."
• "Check the status of..."
• "Approve/Reject submission..."

Categories Supported

• 📸 Photography - Product photos, location verification
• 🔍 Product Verification - Stock checks, availability
• 💰 Price Research - Price comparisons, market research
• 📝 Translation - Document and menu translation
• 📊 Research - Surveys, interviews, data collection
• 📦 Delivery - Package pickup, delivery confirmation
• 🎯 General - Custom tasks

API Integration

Endpoints Used

• POST /api/openclaw/errands - Create new errand
• GET /api/openclaw/errands/{id} - Check errand status
• POST /api/openclaw/submissions/{id}/review - Review submission
• GET /api/openclaw/errands - List user's errands

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

• Missing API key: Prompts to set ERRANDAI_API_KEY
• Network errors: Retries with exponential backoff
• Invalid commands: Provides helpful examples
• API errors: Returns clear error messages

Security

• API keys stored as environment variables
• All API calls use HTTPS
• Webhook signatures verified
• No sensitive data logged

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

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

• Average response time: <500ms
• Concurrent errand limit: 10
• Rate limit: 100 requests/minute
• Webhook latency: <100ms

Changelog

v1.0.0 (2024-02-14)

• Initial release
• Basic errand posting and management
• Natural language processing
• Submission review functionality
• USDC payment integration

Support

• 📧 Email: [email protected]
• 💬 Discord: ErrandAI Community
• 🐛 Issues: GitHub
• 📖 Docs: docs.errand.be

License

Contributing

Credits