Skip to main content

​
Prerequisites

Before creating an instance, make sure you have:
  1. A verified Suji account (register here)
  2. An active subscription (choose a plan)
  3. An AI API key (e.g., Anthropic, OpenAI)

​
Create an Instance

1

Navigate to Instances

Go to app.suji.fr and click Instances in the sidebar, then click New Instance.
2

Choose a subdomain

Pick a subdomain for your instance. A random suffix will be automatically added for uniqueness (e.g., my-bot-a1b2).Your instance will be accessible at your-subdomain-xxxx.suji.fr where -xxxx is a randomly generated suffix.Subdomains must be 3-32 characters, lowercase alphanumeric with hyphens allowed.
3

Configure your AI provider

Select your AI provider and enter your API key:
  • Anthropic — Claude Sonnet 4.5, Opus 4.6
  • OpenAI — GPT-4.1, GPT-4o
  • Google — Gemini 2.5 Pro/Flash
  • Others — xAI, Mistral, Groq, Cerebras, OpenRouter
Your API key is encrypted and stored securely.
4

Add a channel (optional)

During onboarding, you can optionally connect Telegram or Discord:
  • Telegram — Enter your bot token from @BotFather
  • Discord — Enter your bot token from the Discord Developer Portal
You can skip this step and add channels later from the instance dashboard.
5

Create

Click Create Instance. Provisioning starts immediately and typically completes in 30-60 seconds.

​
What Happens During Provisioning

When you create an instance, Suji automatically:
  1. Creates an isolated virtual machine environment
  2. Provisions encrypted storage for your instance
  3. Deploys OpenClaw with your configuration
  4. Configures SSL certificates and DNS for your subdomain
  5. Securely injects your AI API key
  6. Starts your instance
You can monitor provisioning progress in real-time on the instance detail page. Provisioning typically completes in 30-60 seconds.

​
Instance States

StatusDescription
ProvisioningInstance is being created
RunningInstance is active and healthy
StartingInstance is being started
StoppingInstance is being stopped
StoppedInstance is stopped (no compute charges)
SuspendedInstance suspended due to payment issues
ErrorInstance encountered an error (can be restarted)

​
Next Steps

Once your instance is running:
  • If you added a channel during creation, test it by sending a message
  • If you skipped the channel step, you’ll need to create a new instance to add channels (channel management after creation is coming in a future release)
  • See our Telegram or Discord guides for credential setup