Customer Portal Guide

The Orquestio customer portal is a web interface built on Odoo that lets you manage every aspect of your OpenClaw deployment. Under the hood, the portal calls the same orchestrator API — so anything you can do in the portal, you can also automate via the REST API.

Logging in

1. Navigate to portal.orquestio.com.
2. Sign in with the credentials you received during onboarding.
3. After login you land on the Dashboard, which shows an overview of your active instances.

Tip

If you forgot your password, use the “Reset password” link on the login page. The reset email arrives within a few minutes.

Dashboard

The dashboard gives you a quick snapshot of your account:

• Active instances — count, current state, and plan tier.
• Recent operations — the last 10 tasks dispatched against your instances.
• Alerts — any instances in unhealthy or degraded state.

Click any instance card to open its detail page.

Instance management

Creating an instance

1. Click New Instance in the top-right corner.
2. Choose a blueprint (e.g., OpenClaw).
3. Select a plan (e.g., openclaw-basic, openclaw-pro).
4. Enter an instance ID — a short, unique slug (lowercase, hyphens allowed).
5. Click Create.

The portal dispatches a create task to the orchestrator. You can track progress in the Task History tab. Provisioning typically takes 1-3 minutes.

Instance lifecycle

Each instance has a state visible on its detail page:

State	Meaning
running	Instance is live and accepting traffic
stopped	Instance is shut down; data is preserved
starting	A start operation is in progress
stopping	A stop operation is in progress
provisioning	Initial creation in progress
error	Something went wrong — check task history

Use the action buttons on the instance detail page to:

• Start — boot a stopped instance.
• Stop — gracefully shut down a running instance.
• Restart — stop then start in a single operation.
• Destroy — permanently delete the instance and all its data.

Caution

Destroy is irreversible. All instance data, environment variables, and custom domain configuration will be permanently deleted. The portal asks for confirmation before proceeding.

Resizing an instance

1. Open the instance detail page.
2. Click Resize (or Change Plan).
3. Select the new plan tier.
4. Confirm the change.

Resizing may cause a brief restart. The portal shows the task progress in real time.

Environment variables

Environment variables let you inject configuration into your OpenClaw instance — most importantly, your LLM API keys.

Viewing current variables

Navigate to the instance detail page and open the Environment tab. Existing variables are listed with their keys visible and values masked.

Adding or updating a variable

1. Click Add Variable (or the edit icon next to an existing variable).
2. Enter the key (e.g., OPENAI_API_KEY) and value.
3. Click Save.

The change triggers a task that updates the instance configuration. Depending on the variable, the instance may restart automatically.

Common variables

Variable	Purpose
OPENAI_API_KEY	Your OpenAI API key for GPT models
ANTHROPIC_API_KEY	Your Anthropic API key for Claude models
LLM_MODEL	Default model identifier (e.g., gpt-4o, claude-sonnet-4-20250514)

Tip

You can set multiple LLM provider keys simultaneously. OpenClaw will use whichever key matches the model you configure in LLM_MODEL.

Custom domains

By default, your instance is accessible at a URL like https://<instance-id>.orquestio.com. You can add your own domain instead.

Setting up a custom domain

1. Open the instance detail page and go to the Custom Domain tab.
2. Click Add Custom Domain.
3. Enter your domain (e.g., ai.example.com).
4. The portal shows the CNAME target you need to configure in your DNS provider.
5. Add a CNAME record in your DNS pointing your domain to the provided target.
6. Click Verify once DNS has propagated.

The orchestrator automatically provisions a TLS certificate via Let’s Encrypt once the CNAME is verified. Certificate issuance typically takes under a minute.

Checking domain status

The Custom Domain tab shows the current state:

Status	Meaning
pending_dns	Waiting for you to configure the CNAME record
pending_cert	CNAME verified, TLS certificate being issued
active	Domain is live with a valid certificate
error	Something went wrong — hover for details

Caution

DNS propagation can take up to 48 hours depending on your provider and TTL settings, though most providers propagate within minutes. If verification fails, wait and try again.

Task history and operation logs

Every action you perform (create, start, stop, resize, environment change, domain setup) generates a task tracked by the orchestrator.

Viewing task history

1. Open the instance detail page.
2. Click the Tasks tab.

Each task entry shows:

• Task type — the operation performed.
• Status — pending, running, completed, or failed.
• Timestamps — when it was created and when it finished.
• Details — expand to see the full operation log.

You can also view a global task list across all instances from the Operations item in the main navigation menu.

Account settings

Access account settings from the user menu (top-right corner):

• Profile — update your name, email, and password.
• Billing — view your current plan, invoices, and payment method.
• API Keys — generate and manage API keys for programmatic access to the orchestrator API.
• Notifications — configure email alerts for instance state changes and billing events.