Accounts, email, first login
The panel is where you configure your agent and manage your gateway. Start here if this is your first time.
Create your account, then verify email if prompted.
After login, open SETTINGS to start configuration.
Gateway status, redeploy, destroy
The Home page shows your agent identifier and live gateway status. It also controls destructive actions like redeploying and destroying your gateway VM.
PROVISIONING: Deployment in progress. Some actions are blocked.
ERROR/OFFLINE: Gateway is unavailable. Open Settings for recovery.
REDEPLOY AGENT destroys the current gateway VM and creates a new one. STOP / DESTROY deprovisions the gateway VM. Both actions require an active subscription and explicit confirmation.
Monthly vs yearly, checkout, billing portal
Billing controls which actions are unlocked (deploy/rebuild). Yearly plans include a 50% discount.
If billing is inactive, use ACTIVATE SUBSCRIPTION to open Stripe Checkout.
Use MANAGE BILLING to open the Stripe customer portal (update payment method, cancel, invoices).
Wizard steps and advanced settings
Settings contains a guided wizard plus advanced configuration fields for your agent and channels.
You can revisit Settings anytime to change name, purpose, personality, and channel configuration.
When WhatsApp is selected you can set: WHATSAPP_DM_POLICY (disabled / allowlist / pairing / open) and WHATSAPP_ALLOW_FROM as a comma-separated list. Use * only if you intentionally want open access.
When your gateway is already ONLINE, saving certain settings requires a restart. You may see an action like Save & apply now (restart agent). When the gateway is not online yet, settings are saved and applied on first deploy.
LLM providers and web search
The panel supports multiple LLM providers and web search backends. Keys are validated client-side to reduce common mistakes.
Supported: Anthropic, OpenAI, Moonshot, Kimi Coding.
Prefix reminders: Anthropic keys usually start with sk-ant-, while OpenAI/Moonshot typically start with sk-.
Supported: Brave, Perplexity, Grok. Configure the provider key in Settings.
Prefix reminders: Perplexity often starts with pplx-. Grok/xAI often starts with xai-.
Available channels and endpoints
Connections lists the channel types your gateway can support. Some are fully configurable (Telegram, WhatsApp), while others may be shown as future/placeholder capabilities.
Telegram and WhatsApp connections include deep links to the Integrations page for configuration.
Telegram + WhatsApp
Integrations is where you connect real messaging apps to your gateway.
Configure bot token and webhook settings. You can also set DM/group policies and allowlists.
Start QR login, scan with your phone, then wait for the link to complete. If the panel suggests it, retry with force.
The panel uses a best-effort retry strategy for transient WebSocket failures and timeouts.
Install, auto-install, ClawHub
Skills are optional tools that can be installed on your gateway. The panel separates skills into two main views: installed vs browse.
When binaries are missing, the gateway may auto-install them in the background. The Skills page will show a notice and auto-refresh.
OS-incompatible skills are filtered so Linux gateways won’t show macOS-only install methods.
In the Browse tab you can install by slug (optionally pin a version) and force overwrite.
version: (optional)
force overwrite: true/false
In Installed, you can update skills and configure env/config inputs. In Browse, you can install single skills or use INSTALL_ALL to install the first available installer for each actionable skill.
If a skill shows Missing binaries, it means required executables are not yet present on the gateway.
Terminal chat and gateway version
Chat opens a secure WebSocket session to your gateway. When connected, the UI displays the running OPENCLAW vX.Y.Z (and commit hash when available).
If your gateway is still provisioning, Chat shows a wait state and unlocks automatically when ready.
Ask assistant and send feedback
The floating support widget (bottom-right) gives you two fast actions: Ask assistant (panel help) and Send feedback (bug reports, screenshots).
Use this when you have questions about CLAW_HOST billing, provisioning, gateway, skills, and onboarding.
When allowed, the panel will attempt a pixel-perfect capture via the Screen Capture API (current tab), with an HTML render fallback.
Feedback submissions are saved in the database and emailed to: contact@shape.host
Common issues and fixes
Your gateway is still deploying or the chat channel is finalizing. Don’t refresh. The panel unlocks chat automatically.
Common causes: whitespace in keys, pasting an env var reference (starts with $), or using the wrong prefix.
The gateway auto-installer may still be running. The Skills page will show a notice and auto-refresh. OS-incompatible skills are excluded on Linux.