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

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:

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

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

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