# OpenComputer

> Cloud sandboxes for running AI agents

## Docs

- [Overview](https://docs.opencomputer.dev/agents-api/overview.md): Run AI agents on OpenComputer — pick a core, connect channels, install packages
- [Telegram](https://docs.opencomputer.dev/agents/channels/telegram.md): Connect your agent to Telegram via webhook
- [Hermes](https://docs.opencomputer.dev/agents/cores/hermes.md): Self-improving AI agent with skill creation, memory, and multi-channel gateway
- [OpenClaw](https://docs.opencomputer.dev/agents/cores/openclaw.md): Multi-channel AI gateway with plugin SDK, native MCP support, and hot-reload config
- [gbrain Package](https://docs.opencomputer.dev/agents/packages/gbrain.md): Install persistent memory on a managed agent with gbrain
- [Agents](https://docs.opencomputer.dev/agents/rest/agents.md): Create and manage agent definitions — snapshot, entrypoint, secrets, elasticity
- [Instances](https://docs.opencomputer.dev/agents/rest/instances.md): Persistent sandboxes that multiplex conversations, hibernate when idle, and wake on demand
- [Sessions](https://docs.opencomputer.dev/agents/rest/sessions.md): Ephemeral sandboxes for fire-and-forget agent tasks with input/result
- [Connect Channel](https://docs.opencomputer.dev/api-reference/agents/connect-channel.md)
- [Create Agent](https://docs.opencomputer.dev/api-reference/agents/create.md)
- [Create Instance](https://docs.opencomputer.dev/api-reference/agents/create-instance.md)
- [Create Session](https://docs.opencomputer.dev/api-reference/agents/create-session.md)
- [Delete Agent](https://docs.opencomputer.dev/api-reference/agents/delete.md)
- [Delete Instance](https://docs.opencomputer.dev/api-reference/agents/delete-instance.md)
- [Delete Secret](https://docs.opencomputer.dev/api-reference/agents/delete-secret.md)
- [Delete Session](https://docs.opencomputer.dev/api-reference/agents/delete-session.md)
- [Disconnect Channel](https://docs.opencomputer.dev/api-reference/agents/disconnect-channel.md)
- [Get Agent](https://docs.opencomputer.dev/api-reference/agents/get.md)
- [Get Instance](https://docs.opencomputer.dev/api-reference/agents/get-instance.md)
- [Get Session](https://docs.opencomputer.dev/api-reference/agents/get-session.md)
- [Get Session Result](https://docs.opencomputer.dev/api-reference/agents/get-session-result.md)
- [Install Package](https://docs.opencomputer.dev/api-reference/agents/install-package.md)
- [List Agents](https://docs.opencomputer.dev/api-reference/agents/list.md)
- [List Channels](https://docs.opencomputer.dev/api-reference/agents/list-channels.md)
- [List Instances](https://docs.opencomputer.dev/api-reference/agents/list-instances.md)
- [List Packages](https://docs.opencomputer.dev/api-reference/agents/list-packages.md)
- [List Secrets](https://docs.opencomputer.dev/api-reference/agents/list-secrets.md)
- [Send Message](https://docs.opencomputer.dev/api-reference/agents/send-message.md)
- [Set Secret](https://docs.opencomputer.dev/api-reference/agents/set-secret.md)
- [Uninstall Package](https://docs.opencomputer.dev/api-reference/agents/uninstall-package.md)
- [Update Agent](https://docs.opencomputer.dev/api-reference/agents/update.md)
- [Create Reservation](https://docs.opencomputer.dev/api-reference/capacity/create-reservations.md)
- [Get Calendar](https://docs.opencomputer.dev/api-reference/capacity/get-calendar.md)
- [List Reservations](https://docs.opencomputer.dev/api-reference/capacity/list-reservations.md)
- [Create Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/create.md)
- [Delete Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/delete.md)
- [Fork from Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/fork.md)
- [List Checkpoints](https://docs.opencomputer.dev/api-reference/checkpoints/list.md)
- [Restore Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/restore.md)
- [Create Exec Session](https://docs.opencomputer.dev/api-reference/exec/create-session.md)
- [Kill Exec Session](https://docs.opencomputer.dev/api-reference/exec/kill-session.md)
- [List Exec Sessions](https://docs.opencomputer.dev/api-reference/exec/list-sessions.md)
- [Run Command](https://docs.opencomputer.dev/api-reference/exec/run.md)
- [Delete File or Directory](https://docs.opencomputer.dev/api-reference/files/delete.md)
- [Generate Download URL](https://docs.opencomputer.dev/api-reference/files/generate-download-url.md)
- [Generate Upload URL](https://docs.opencomputer.dev/api-reference/files/generate-upload-url.md)
- [List Directory](https://docs.opencomputer.dev/api-reference/files/list-directory.md)
- [Create Directory](https://docs.opencomputer.dev/api-reference/files/mkdir.md)
- [Read File](https://docs.opencomputer.dev/api-reference/files/read.md)
- [Signed Download](https://docs.opencomputer.dev/api-reference/files/signed-download.md)
- [Signed Upload](https://docs.opencomputer.dev/api-reference/files/signed-upload.md)
- [Write File](https://docs.opencomputer.dev/api-reference/files/write.md)
- [API Reference](https://docs.opencomputer.dev/api-reference/overview.md): Complete REST API reference for OpenComputer
- [Create Patch](https://docs.opencomputer.dev/api-reference/patches/create.md)
- [Delete Patch](https://docs.opencomputer.dev/api-reference/patches/delete.md)
- [List Patches](https://docs.opencomputer.dev/api-reference/patches/list.md)
- [Create Preview URL](https://docs.opencomputer.dev/api-reference/preview/create.md)
- [Delete Preview URL](https://docs.opencomputer.dev/api-reference/preview/delete.md)
- [List Preview URLs](https://docs.opencomputer.dev/api-reference/preview/list.md)
- [Create PTY Session](https://docs.opencomputer.dev/api-reference/pty/create.md)
- [Kill PTY Session](https://docs.opencomputer.dev/api-reference/pty/kill.md)
- [Resize PTY](https://docs.opencomputer.dev/api-reference/pty/resize.md)
- [Create Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/create.md)
- [Kill Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/delete.md)
- [Get Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/get.md)
- [Get Sandbox Tags](https://docs.opencomputer.dev/api-reference/sandboxes/get-tags.md)
- [Hibernate Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/hibernate.md)
- [List Sandboxes](https://docs.opencomputer.dev/api-reference/sandboxes/list.md)
- [Set Sandbox Tags](https://docs.opencomputer.dev/api-reference/sandboxes/set-tags.md)
- [Set Timeout](https://docs.opencomputer.dev/api-reference/sandboxes/set-timeout.md)
- [Wake Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/wake.md)
- [Create Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/create.md)
- [Delete Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/delete.md)
- [Get Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/get.md)
- [List Snapshots](https://docs.opencomputer.dev/api-reference/snapshots/list.md)
- [Sandbox Usage Drilldown](https://docs.opencomputer.dev/api-reference/usage/get-sandbox-usage.md)
- [Usage Aggregator](https://docs.opencomputer.dev/api-reference/usage/get-usage.md)
- [List Tag Keys](https://docs.opencomputer.dev/api-reference/usage/list-tags.md)
- [Agent Management](https://docs.opencomputer.dev/cli/agents.md): Create, inspect, and manage agents, channels, and packages from the CLI
- [Checkpoints](https://docs.opencomputer.dev/cli/checkpoint.md): Snapshot, fork, and restore from the CLI
- [Running Commands](https://docs.opencomputer.dev/cli/exec.md): Execute shell commands from the CLI
- [CLI](https://docs.opencomputer.dev/cli/overview.md): Manage sandboxes from your terminal
- [Patches](https://docs.opencomputer.dev/cli/patch.md): Attach scripts to checkpoints from the CLI
- [Preview URLs](https://docs.opencomputer.dev/cli/preview.md): Expose sandbox ports from the CLI
- [Sandbox Management](https://docs.opencomputer.dev/cli/sandbox.md): Create, manage, and control sandbox lifecycles from the CLI
- [Secrets](https://docs.opencomputer.dev/cli/secrets.md): Manage secret stores and secrets from the CLI
- [Shell](https://docs.opencomputer.dev/cli/shell.md): Interactive terminal sessions from the CLI
- [Agent Skill](https://docs.opencomputer.dev/guides/agent-skill.md): Use AI agents to manage cloud sandboxes with natural language
- [Browser Automation](https://docs.opencomputer.dev/guides/browser-automation.md): Run headless and headed browsers inside OpenComputer sandboxes — for scraping, logged-in workflows, and AI-driven automation.
- [Build a Lovable Clone](https://docs.opencomputer.dev/guides/build-a-lovable-clone.md): Build an open-source AI app builder using OpenComputer sandboxes
- [Create a Hermes Agent](https://docs.opencomputer.dev/guides/create-hermes-agent.md): Deploy a personal AI agent on Telegram with persistent memory using the oc CLI
- [Create an OpenClaw Agent](https://docs.opencomputer.dev/guides/create-openclaw-agent.md): Deploy a personal AI agent on Telegram using OpenClaw — a multi-channel gateway with native plugin support
- [Deploy OpenClaw](https://docs.opencomputer.dev/guides/deploy-openclaw.md): Run managed, per-user OpenClaw AI agent instances inside OpenComputer sandboxes
- [How It Works](https://docs.opencomputer.dev/how-it-works.md): Architecture and key technical decisions
- [Introduction](https://docs.opencomputer.dev/introduction.md): Cloud sandboxes for AI apps
- [Quickstart](https://docs.opencomputer.dev/quickstart.md): Create your first sandbox in 2 minutes
- [oc agent](https://docs.opencomputer.dev/reference/cli/agent.md): Manage agents, channels, and packages
- [oc checkpoint](https://docs.opencomputer.dev/reference/cli/checkpoint.md): Manage sandbox checkpoints
- [oc config](https://docs.opencomputer.dev/reference/cli/config.md): CLI configuration
- [oc exec](https://docs.opencomputer.dev/reference/cli/exec.md): Execute commands inside a sandbox
- [CLI Reference](https://docs.opencomputer.dev/reference/cli/overview.md): Every command, subcommand, and flag
- [oc patch](https://docs.opencomputer.dev/reference/cli/patch.md): Manage checkpoint patches
- [oc preview](https://docs.opencomputer.dev/reference/cli/preview.md): Manage preview URLs
- [oc sandbox](https://docs.opencomputer.dev/reference/cli/sandbox.md): Manage sandbox lifecycle
- [oc shell](https://docs.opencomputer.dev/reference/cli/shell.md): Interactive terminal access
- [Exec](https://docs.opencomputer.dev/reference/python-sdk/exec.md): Run commands and manage exec sessions
- [Filesystem](https://docs.opencomputer.dev/reference/python-sdk/filesystem.md): Read, write, and manage files
- [Image](https://docs.opencomputer.dev/reference/python-sdk/image.md): Declarative sandbox image builder
- [Python SDK](https://docs.opencomputer.dev/reference/python-sdk/overview.md): Complete Python SDK reference
- [PTY](https://docs.opencomputer.dev/reference/python-sdk/pty.md): Interactive terminal sessions
- [Sandbox](https://docs.opencomputer.dev/reference/python-sdk/sandbox.md): Create, connect, and manage sandbox lifecycle
- [Secret Stores](https://docs.opencomputer.dev/reference/python-sdk/secrets.md): Manage secrets and egress control
- [Snapshots](https://docs.opencomputer.dev/reference/python-sdk/snapshots.md): Pre-built sandbox environments
- [Exec](https://docs.opencomputer.dev/reference/typescript-sdk/exec.md): Run commands and manage exec sessions
- [Filesystem](https://docs.opencomputer.dev/reference/typescript-sdk/filesystem.md): Read, write, and manage files
- [Image](https://docs.opencomputer.dev/reference/typescript-sdk/image.md): Declarative sandbox image builder
- [TypeScript SDK](https://docs.opencomputer.dev/reference/typescript-sdk/overview.md): Complete TypeScript SDK reference
- [PTY](https://docs.opencomputer.dev/reference/typescript-sdk/pty.md): Interactive terminal sessions
- [Sandbox](https://docs.opencomputer.dev/reference/typescript-sdk/sandbox.md): Create, connect, and manage sandbox lifecycle
- [Secret Stores](https://docs.opencomputer.dev/reference/typescript-sdk/secrets.md): Manage secrets and egress control
- [Snapshots](https://docs.opencomputer.dev/reference/typescript-sdk/snapshots.md): Pre-built sandbox environments
- [Reading the Calendar](https://docs.opencomputer.dev/reserved-capacity/calendar.md): Preview reservable capacity and existing commitments per 15-minute interval
- [Concepts](https://docs.opencomputer.dev/reserved-capacity/concepts.md): Intervals, reservations, the reservation log, and the per-org cap
- [Reserved Capacity](https://docs.opencomputer.dev/reserved-capacity/overview.md): Commit memory capacity to future 15-minute intervals at a discounted rate
- [Reserving Capacity](https://docs.opencomputer.dev/reserved-capacity/reserving.md): Write flow, idempotency, atomicity, and the audit list
- [Usage and Overage](https://docs.opencomputer.dev/reserved-capacity/usage-and-overage.md): How reserved capacity is consumed and how overage is calculated
- [Checkpoints](https://docs.opencomputer.dev/sandboxes/checkpoints.md): Snapshot and fork sandbox state
- [Elasticity](https://docs.opencomputer.dev/sandboxes/elasticity.md): Dynamically scale sandbox memory and CPU from inside the VM
- [Interactive Terminals](https://docs.opencomputer.dev/sandboxes/interactive-terminals.md): Full PTY sessions inside sandboxes
- [Sandboxes](https://docs.opencomputer.dev/sandboxes/overview.md): The compute primitive — full Linux VMs in the cloud
- [Patches](https://docs.opencomputer.dev/sandboxes/patches.md): Scripts that run when forking from a checkpoint
- [Preview URLs](https://docs.opencomputer.dev/sandboxes/preview-urls.md): Expose sandbox ports to the internet
- [Running Commands](https://docs.opencomputer.dev/sandboxes/running-commands.md): Execute shell commands inside a sandbox
- [Secrets](https://docs.opencomputer.dev/sandboxes/secrets.md): Inject encrypted secrets into sandboxes without exposing them to the VM
- [Signed URLs](https://docs.opencomputer.dev/sandboxes/signed-urls.md): Generate pre-signed URLs for direct file uploads and downloads without API keys
- [Templates](https://docs.opencomputer.dev/sandboxes/templates.md): Define sandbox environments programmatically with the Image builder and Snapshots
- [Timeout & Hibernation](https://docs.opencomputer.dev/sandboxes/timeout.md): Control how long a sandbox stays alive when idle
- [Working with Files](https://docs.opencomputer.dev/sandboxes/working-with-files.md): Read, write, and manage files inside a sandbox
- [Troubleshooting](https://docs.opencomputer.dev/troubleshooting.md): Common errors and debugging tips