Skip to main content

​
Deploy Your First Agent

This is the fastest path to a production agent on ClawdNet Cloud.
Bring your own model key (Anthropic, OpenAI, or OpenRouter), and keep a little USDC on Base for runtime billing.

​
1) Sign Up

Create your account at clawdnet.xyz and open the dashboard. 
open https://clawdnet.xyz

​
2) Choose a Template or Upload SOUL.md

In the deploy wizard:
  • Select a starter template (support, research, social, coding)
  • or upload your own SOUL.md to define the agent identity and behavior
# SOUL

Name: Orbit
Role: Research assistant
Tone: concise, technical, helpful

## Core Instructions
- Prefer verified sources
- Explain trade-offs
- Ask clarifying questions when intent is ambiguous

​
3) Connect Model Provider

Add at least one provider key:
Add ANTHROPIC_API_KEY in the dashboard secrets panel.
ClawdNet never exposes your raw keys to channels. Keys are stored as encrypted runtime secrets.

​
4) Connect Channels

Attach at least one communication channel so your agent can receive work.
  • Telegram (bot token)
  • Discord (bot token + intents)
# Example env values you will set in dashboard secrets
TELEGRAM_BOT_TOKEN=...
DISCORD_BOT_TOKEN=...

​
5) Fund USDC Wallet

Each deployed agent gets a wallet on Base for usage billing.
  • Deposit USDC into the shown wallet address
  • Runtime and inference usage are deducted over time
  • Configure low-balance alerts in dashboard settings
# Example (illustrative) balance check endpoint
curl -s https://api.clawdnet.xyz/v1/agents/{agent_id}/wallet \
  -H "Authorization: Bearer <token>"

​
6) Go Live

Click Deploy Agent. In most cases, your agent is reachable in under a minute with:
  • container runtime active
  • health checks passing
  • channels connected
  • logs streaming in dashboard

​
What Happens After Deploy

1

Run

Agent processes messages/jobs and records state changes continuously.
2

Bill

USDC balance is charged for uptime and inference usage.
3

Sleep Safely

If balance reaches zero, runtime pauses while preserving state.
4

Wake Instantly

Top up wallet and resume from the same state.

​
Next

Cloud Quickstart

End-to-end getting started flow

Payments

Understand USDC streaming and inference billing

Compute

Hosting tiers and runtime architecture

Node Operator Guide

Host cloud workloads and earn from compute