OpenClaw Setup

Overview

Connect Bilt MCP Server to OpenClaw for powerful AI-assisted development across all platforms. OpenClaw natively supports MCP with advanced features like background execution, tool discovery, and multi-agent workflows.

OpenClaw supports MCP out of the box with zero configuration required beyond adding servers.

Platform Support

macOSFull support for macOS 11+

WindowsFull support for Windows 10+

LinuxFull support for all major distros

Prerequisites

OpenClaw installed - Download from openclaw.ai
Bilt API token - Get one at bilt.me/sign-up

Quick Setup

Step 1: Locate Config File

The OpenClaw config file location varies by platform:

macOS/Linux
Windows

~/.openclaw/openclaw.json

%USERPROFILE%\.openclaw\openclaw.json

Step 2: Edit Configuration

macOS/Linux
Windows

# Create directory if needed
mkdir -p ~/.openclaw

# Edit config
nano ~/.openclaw/openclaw.json

# Create directory if needed
mkdir -Force "$env:USERPROFILE\.openclaw"

# Edit config
notepad "$env:USERPROFILE\.openclaw\openclaw.json"

Step 3: Add Bilt Configuration

Add this to your openclaw.json:

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
        }
      },
      "capabilities": ["tools"],
      "metadata": {
        "name": "Bilt",
        "description": "Build and deploy native mobile applications",
        "icon": "🏗️"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with your actual Bilt API token.

Step 4: Restart OpenClaw

CLI
macOS Menu Bar
Windows

openclaw gateway restart

Step 5: Verify Connection

openclaw status

You should see:

✓ MCP Server: bilt (7 tools)
  - bilt_list_projects
  - bilt_get_project
  - bilt_create_project
  - bilt_get_session
  - bilt_send_message
  - bilt_cancel_workflow
  - bilt_get_messages

Configuration Options

Basic Configuration

Minimal setup:

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN"
        }
      }
    }
  }
}

Advanced Configuration

With metadata and capabilities:

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN"
        }
      },
      "capabilities": ["tools"],
      "metadata": {
        "name": "Bilt Application Builder",
        "description": "AI-powered native mobile app development and deployment",
        "icon": "🏗️",
        "version": "1.0.0"
      },
      "enabled": true,
      "autoStart": true
    }
  }
}

Environment Variables

Use environment variables for tokens (recommended):

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_API_TOKEN}"
        }
      }
    }
  }
}

Then set the variable:

macOS/Linux
Windows

# Add to ~/.zshrc or ~/.bashrc
export BILT_API_TOKEN="bilt_live_YOUR_TOKEN"

# Reload shell
source ~/.zshrc

# Restart OpenClaw
openclaw gateway restart

# Set permanently
[System.Environment]::SetEnvironmentVariable(
  "BILT_API_TOKEN",
  "bilt_live_YOUR_TOKEN",
  "User"
)

# Restart OpenClaw
openclaw gateway restart

Multiple Environments

Configure dev and production:

{
  "mcpServers": {
    "bilt-dev": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_DEV_TOKEN}"
        }
      },
      "metadata": {
        "name": "Bilt (Development)",
        "icon": "🔧"
      }
    },
    "bilt-prod": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_PROD_TOKEN}"
        }
      },
      "metadata": {
        "name": "Bilt (Production)",
        "icon": "🚀"
      }
    }
  }
}

Using Bilt in OpenClaw

Natural Language Commands

OpenClaw automatically discovers and uses Bilt tools:

You: "Use Bilt to create a todo app"

OpenClaw: [Discovers bilt_create_project tool]
[Executes tool with parameters]
"Created project: todo-app (550e8400-e29b-41d4-a716-446655440000)"

You: "Add authentication and dark mode"

OpenClaw: [Uses bilt_send_message]
"Building features... Progress: 45%"

Direct Tool Invocation

You can also invoke tools directly:

You: "Call bilt_list_projects"

OpenClaw: [Returns JSON with all projects]

Background Execution

OpenClaw supports background tool execution:

You: "Build my landing page in the background"

OpenClaw: [Starts bilt_send_message in background]
"Build started in background. I'll notify you when complete."

[5 minutes later]

OpenClaw: "Your landing page is ready! Deployed to: https://..."

OpenClaw-Specific Features

Tool Discovery

OpenClaw automatically:

Discovers all 8 Bilt tools
Parses parameter schemas
Suggests tools based on context

Error Handling

OpenClaw provides enhanced error messages:

Error: 401 Unauthorized
Suggestion: Your Bilt API token may be invalid.
Try: openclaw config get mcpServers.bilt

Session Management

OpenClaw maintains MCP sessions across restarts:

# Check active sessions
openclaw sessions list

# View Bilt tool calls
openclaw logs --filter bilt

Rate Limit Handling

OpenClaw automatically:

Respects rate limits
Retries with backoff
Shows rate limit status

Troubleshooting

Server not connecting

Check status:

openclaw status

View logs:

openclaw logs --tail 50

Test connection:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.bilt.me/health

Tools not available

Verify config:

openclaw config get mcpServers.bilt

Restart gateway:

openclaw gateway restart

Check logs for errors:

openclaw logs --filter error

401 Unauthorized

Check token format:

openclaw config get mcpServers.bilt.transport.headers.Authorization

Should return: Bearer bilt_live_...Update token:

openclaw config set mcpServers.bilt.transport.headers.Authorization \
  "Bearer bilt_live_NEW_TOKEN"

openclaw gateway restart

Slow responses

Check network:

ping mcp.bilt.me

Monitor latency:

openclaw stats --server bilt

CLI Commands

Configuration

# View all MCP servers
openclaw config get mcpServers

# View Bilt config
openclaw config get mcpServers.bilt

# Update token
openclaw config set mcpServers.bilt.transport.headers.Authorization \
  "Bearer bilt_live_NEW_TOKEN"

# Enable/disable server
openclaw config set mcpServers.bilt.enabled true

Monitoring

# Check gateway status
openclaw gateway status

# View logs
openclaw logs --follow

# View specific server logs
openclaw logs --server bilt

# Check tool usage stats
openclaw stats --tool bilt_send_message

Management

# Restart gateway
openclaw gateway restart

# Stop gateway
openclaw gateway stop

# Start gateway
openclaw gateway start

# Update OpenClaw
openclaw update

Advanced Usage

Webhook Integration

OpenClaw can trigger webhooks on Bilt events:

{
  "mcpServers": {
    "bilt": {
      "transport": { "..." },
      "webhooks": {
        "onSuccess": "https://your-app.com/webhook/build-complete",
        "onError": "https://your-app.com/webhook/build-failed"
      }
    }
  }
}

Custom Prompts

Define custom prompts for Bilt:

{
  "mcpServers": {
    "bilt": {
      "transport": { "..." },
      "prompts": {
        "create-app": "Use Bilt to create a {type} native mobile application with {features}",
        "deploy": "Deploy {project} to production using Bilt"
      }
    }
  }
}

Logging

Configure detailed logging:

{
  "mcpServers": {
    "bilt": {
      "transport": { "..." },
      "logging": {
        "level": "debug",
        "file": "~/.openclaw/logs/bilt.log"
      }
    }
  }
}

Get Started

Client Setup

Tools Reference

OpenClaw Setup

Overview

Platform Support

Prerequisites

Quick Setup

Step 1: Locate Config File

Step 2: Edit Configuration

Step 3: Add Bilt Configuration

Step 4: Restart OpenClaw

Step 5: Verify Connection

Configuration Options

Basic Configuration

Advanced Configuration

Environment Variables

Multiple Environments

Using Bilt in OpenClaw

Natural Language Commands

Direct Tool Invocation

Background Execution

OpenClaw-Specific Features

Tool Discovery

Error Handling

Session Management

Rate Limit Handling

Troubleshooting

CLI Commands

Configuration

Monitoring

Management

Advanced Usage

Webhook Integration

Custom Prompts

Logging

Next Steps

API Reference

OpenClaw Docs

​Overview

​Platform Support

​Prerequisites

​Quick Setup

​Step 1: Locate Config File

​Step 2: Edit Configuration

​Step 3: Add Bilt Configuration

​Step 4: Restart OpenClaw

​Step 5: Verify Connection

​Configuration Options

​Basic Configuration

​Advanced Configuration

​Environment Variables

​Multiple Environments

​Using Bilt in OpenClaw

​Natural Language Commands

​Direct Tool Invocation

​Background Execution

​OpenClaw-Specific Features

​Tool Discovery

​Error Handling

​Session Management

​Rate Limit Handling

​Troubleshooting

​CLI Commands

​Configuration

​Monitoring

​Management

​Advanced Usage

​Webhook Integration

​Custom Prompts

​Logging

​Next Steps

API Reference

OpenClaw Docs

Overview

Platform Support

Prerequisites

Quick Setup

Step 1: Locate Config File

Step 2: Edit Configuration

Step 3: Add Bilt Configuration

Step 4: Restart OpenClaw

Step 5: Verify Connection

Configuration Options

Basic Configuration

Advanced Configuration

Environment Variables

Multiple Environments

Using Bilt in OpenClaw

Natural Language Commands

Direct Tool Invocation

Background Execution

OpenClaw-Specific Features

Tool Discovery

Error Handling

Session Management

Rate Limit Handling

Troubleshooting

CLI Commands

Configuration

Monitoring

Management

Advanced Usage

Webhook Integration

Custom Prompts

Logging

Next Steps