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

• 🤖 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

1. Download the skill files
2. Copy to OpenClaw skills directory:

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

3. Set your API key:

   export ERRANDAI_API_KEY="your_api_key_here"
   

4. 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

The skill understands various 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

The skill handles common errors gracefully:

• 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: support@errand.be
• 💬 Discord: ErrandAI Community
• 🐛 Issues: GitHub
• 📖 Docs: docs.errand.be

License

MIT License - See LICENSE file for details

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Credits

Created by the ErrandAI team for the OpenClaw ecosystem.