add-parallel

Add Parallel AI Integration

Adds Parallel AI MCP integration to ClaudeClaw for advanced web research capabilities.

What This Adds

• Quick Search - Fast web lookups using Parallel Search API (free to use)
• Deep Research - Comprehensive analysis using Parallel Task API (asks permission)
• Non-blocking Design - Uses ClaudeClaw scheduler for result polling (no container blocking)

Prerequisites

User must have:

1. Parallel AI API key from https://platform.parallel.ai
2. ClaudeClaw already set up and running
3. Docker installed and running

Implementation Steps

Run all steps automatically. Only pause for user input when explicitly needed.

1. Get Parallel AI API Key

Use AskUserQuestion: Do you have a Parallel AI API key, or should I help you get one?

If they have one: Collect it now.

If they need one: Tell them:

1. Go to https://platform.parallel.ai
2. Sign up or log in
3. Navigate to API Keys section
4. Create a new API key
5. Copy the key and paste it here

Wait for the API key.

2. Add API Key to Environment

Add PARALLEL_API_KEY to .env:

# Check if .env exists, create if not
if [ ! -f .env ]; then
    touch .env
fi

# Add PARALLEL_API_KEY if not already present
if ! grep -q "PARALLEL_API_KEY=" .env; then
    echo "PARALLEL_API_KEY=${API_KEY_FROM_USER}" >> .env
    echo "✓ Added PARALLEL_API_KEY to .env"
else
    # Update existing key
    sed -i.bak "s/^PARALLEL_API_KEY=.*/PARALLEL_API_KEY=${API_KEY_FROM_USER}/" .env
    echo "✓ Updated PARALLEL_API_KEY in .env"
fi

Verify:

grep "PARALLEL_API_KEY" .env | head -c 50

3. Update Container Runner

Add PARALLEL_API_KEY to allowed environment variables in src/orchestrator/container-runner.ts:

Find the line:

const allowedVars = ['CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY'];

Replace with:

const allowedVars = ['CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY', 'PARALLEL_API_KEY'];

4. Configure MCP Servers in Agent Runner