Skip to main content
An instance is one hosted OpenClaw runtime. Think of it as its own computer: filesystem, browser, terminal, web search, and an LLM. You can upload files, download files, give it API keys, and let it interact with any service a person at a computer could use. Give an instance a GITHUB_TOKEN and it can read repos, open PRs, and trigger workflows. Give it a DATABASE_URL and it can query your database. Give it a weather API key and it can pull forecasts. No dedicated integration needed for every service. If there is an API and you provide the credentials, it figures out the rest. During agent evolution, the Operator agent creates multiple instances to run variants in parallel. Once the best approach emerges, the winner goes to a production instance and variants get cleaned up.

​
What an instance can do

Browse the web

Navigate pages, extract data, fill forms, take screenshots

Run code

Execute scripts, install packages, run shell commands

Read and write files

Upload, download, edit files on the instance filesystem

Call APIs

Any HTTP API with the right credentials

Search the web

Find information, datasets, documentation

Use an LLM

Managed model access for reasoning, analysis, generation
You do not need a pre-built integration for every service. If you can give the instance an API key or a URL, it can work with that service. Integrations are convenient shortcuts, not requirements.

​
Instance types

Includes Operator managed defaults:
  • Managed agent config and integrations
  • Managed AGENTS.md prompt
  • Operator provider injection for model access
  • Managed search and runtime wiring
This is the fastest way to get started. When you ask the Operator agent to deploy an agent, it creates prebuilt instances by default.
If a request is ambiguous, the Operator agent asks whether you want blank or prebuilt before creating anything.

​
Instance detail page

Status

Runtime state and local cron assignments

Agent Skills

Installed managed and custom skills powering this agent

Channels

Telegram and Discord connections

Environment

Secret access and runtime settings

Server

Browse and download files, including skills, scripts, and workspace data
To download an agent’s skill, open the instance, go to Server, and browse .openclaw/skills/{skill-name}/. You can download the SKILL.md, scripts, references, or any file the agent created.

​
Secrets are separate from skills

An agent’s skill can be installed and still unusable. An instance may have the GitHub skill but cannot use it until a matching secret like GITHUB_TOKEN exists and is either global or granted to that instance.
Read Environment and Integrations together.

​
Capacity and plan limits

Your plan controls how many active or provisioning instances you can have at once.
PlanInstance limit
Basic1
Pro5
Max20
During agent evolution, variant instances count against this limit. If you are at capacity, the Operator agent adjusts the number of variants or asks if you want to run sequentially.

​
Security and persistence

  • Instance config is encrypted at rest (AES-256-GCM).
  • Secrets are managed separately from config.
  • Suspending an instance removes the running container but keeps data for later recovery.

Agents

Build, test, evolve lifecycle

Channels

Connect Telegram or Discord

Environment

Secrets and access control

Integrations

External services and APIs