AgentStead Deploy

Deploy an OpenClaw agent to AgentStead's cloud hosting in minutes.

API Base URL: https://www.agentstead.com/api/v1

Quick Deploy Flow

1. Register/login → 2. Create agent → 3. Add channel → 4. Set up billing → 5. Start agent → 6. Verify

Conversation Guide

Before calling any APIs, gather from the user:

1. Agent name — What should the agent be called?
2. Personality/instructions — System prompt or personality description
3. Channel — Telegram (need bot token from @BotFather) or Discord (need bot token from Discord Developer Portal)
4. AI credit plan — Pay-as-you-go ($0 base), 1K ($10/mo), 3K ($30/mo), 5K ($50/mo), or 10K ($100/mo) ASTD/mo
5. AI model — Claude 3.5 Haiku (fast), Claude Sonnet 4 (balanced), or Claude Opus 4.6 (most capable)
6. Hosting plan — Starter $9/mo, Pro $19/mo, Business $39/mo, Enterprise $79/mo
7. Payment method — ASTD Balance, Crypto (USDC on Base/Polygon), or Card (Stripe)

Step-by-Step Workflow

Step 1: Register

curl -X POST https://www.agentstead.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "securepass123"}'

Response includes token — use as Authorization: Bearer <token> for all subsequent requests.

If user already has an account, use login instead:

curl -X POST https://www.agentstead.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "securepass123"}'

Step 2: Create Agent

curl -X POST https://www.agentstead.com/api/v1/agents \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyAgent",
    "personality": "You are a helpful assistant...",
    "plan": "pro",
    "aiPlan": "ASTD_5000",
    "defaultModel": "anthropic/claude-sonnet-4-20250514"
  }'

Valid aiPlan values:

Valid defaultModel values:

Response includes the agent id — save it for subsequent steps.

Step 3: Add Channel

Telegram:

curl -X POST https://www.agentstead.com/api/v1/agents/<agent_id>/channels \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"type": "telegram", "botToken": "123456:ABC-DEF..."}'

Discord:

curl -X POST https://www.agentstead.com/api/v1/agents/<agent_id>/channels \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"type": "discord", "botToken": "MTIz..."}'

Step 4: Set Up Billing

Crypto (USDC):

curl -X POST https://www.agentstead.com/api/v1/billing/crypto/create-invoice \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"agentId": "<agent_id>", "plan": "pro", "aiPlan": "ASTD_5000"}'

Returns a deposit address. Guide user to send USDC on Base or Polygon chain.

Stripe (card):

curl -X POST https://www.agentstead.com/api/v1/billing/checkout \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"agentId": "<agent_id>", "plan": "pro", "aiPlan": "ASTD_5000"}'

Returns a Stripe checkout URL. Send to user to complete payment.

Step 5: Start Agent

curl -X POST https://www.agentstead.com/api/v1/agents/<agent_id>/start \
  -H "Authorization: Bearer <token>"

Step 6: Verify

curl -X GET https://www.agentstead.com/api/v1/agents/<agent_id> \
  -H "Authorization: Bearer <token>"

Check that status is "RUNNING". If not, wait a few seconds and retry.

Pricing Reference

Hardware Plans (per agent)

AI Credit Plans

All plans include access to Claude 3.5 Haiku, Claude Sonnet 4, and Claude Opus 4.6.

ASTD conversion: 100 ASTD = $1 USD. Platform fee: 4% on top of AI provider cost.

Notes

• Telegram bot tokens come from @BotFather
• Discord bot tokens come from the Discord Developer Portal
• Agents can be stopped with POST /agents/:id/stop and restarted anytime
• Top up ASTD balance via the web dashboard or iOS app
• See references/api-reference.md for full API documentation