Documentation Index
Fetch the complete documentation index at: https://opensandbox-feat-cf-dev-cutover.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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
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)
--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:
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'
