Agent Management

Creating an Agent

oc agent create provisions a managed agent with a core runtime:

oc agent create my-agent --core hermes
oc agent create my-agent --core openclaw
oc agent create my-agent --core hermes --secret OPENAI_API_KEY=sk-...

--core is required. OpenComputer boots a sandbox with the runtime pre-installed and an instance running. To create a raw agent with your own snapshot and entrypoint, use the REST API directly.

Listing & Inspecting

# List all agents
oc agent ls

# Detailed info for a specific agent
oc agent get my-agent

oc agent ls shows a table with ID, core, channels, packages, and age. Add --json for machine-readable output. oc agent get also shows instance status if one exists.

Connecting Channels

Connect messaging platforms to your agent. Currently supports Telegram.

# Connect — prompts for bot token on TTY, or pass via flag for scripts
oc agent connect my-agent telegram
oc agent connect my-agent telegram --bot-token 123:ABC

# Disconnect (use --yes in scripts)
oc agent disconnect my-agent telegram

# List connected channels
oc agent channels my-agent

See Telegram channel for setup details.

Installing Packages

Extend what the agent can do with packages like gbrain for persistent memory.

# Install
oc agent install my-agent gbrain

# Uninstall (data preserved)
oc agent uninstall my-agent gbrain

# List installed packages
oc agent packages my-agent

Deleting an Agent

oc agent delete my-agent          # prompts for confirmation
oc agent delete my-agent --yes    # non-interactive (scripts, CI)

Cascades to instances and sessions — the sandbox is destroyed. The command refuses to delete without --yes when stdin is not a TTY, so a typo in a script can’t silently destroy state.

Shell Access

Any agent is also a sandbox. Drop into it for manual inspection and debugging:

oc shell my-agent

Common Patterns

Create a full agent setup

oc agent create my-agent --core hermes
oc agent connect my-agent telegram
oc agent install my-agent gbrain

Script with JSON output

oc agent ls --json | jq -r '.[].id'

Full flag reference: CLI Reference. REST API equivalents: Agents REST.

Getting Started

Sandboxes

Reserved Capacity

Agent SDK

Hosted Agents

CLI

Guides

TypeScript SDK

Python SDK

CLI Reference

API Reference

Resources

Creating an Agent

Listing & Inspecting

Connecting Channels

Installing Packages

Deleting an Agent

Shell Access

Common Patterns

Create a full agent setup

Script with JSON output

​Creating an Agent

​Listing & Inspecting

​Connecting Channels

​Installing Packages

​Deleting an Agent

​Shell Access

​Common Patterns

​Create a full agent setup

​Script with JSON output

Creating an Agent

Listing & Inspecting

Connecting Channels

Installing Packages

Deleting an Agent

Shell Access

Common Patterns

Create a full agent setup

Script with JSON output