open-ma/open-managed-agents/create-agent

openma Agent Creator

What is openma?

openma is an open-source platform for building, deploying, and managing AI agents. Think of it as a managed runtime — you define an agent (model + system prompt + tools), the platform handles sandboxed execution, credential management, and session state.

What you can do with it:

• Build agents for any task: coding, research, data analysis, customer support, automation
• Run agents in sandboxes — each session gets an isolated container with file system, shell, and network
• Connect external services via MCP servers (GitHub, Slack, Linear, Notion, etc.) with OAuth
• Use any LLM — Anthropic, OpenAI, DeepSeek, or any OpenAI-compatible provider
• Install community skills from ClawHub to extend agent capabilities
• Manage credentials securely in vaults — agents get scoped access, secrets never leak
• Collaborate — multi-user workspace with API key access for CLI/SDK integration

Creating an Agent

Flow

1. Understand the goal — ask what the agent should do. If vague, one question:

"What's the main task?" Two rounds max, then build.

1. Pick the model — check /v1/model_cards first. Defaults:

• Complex/coding: claude-opus-4-6
• General (default): claude-sonnet-4-6
• Simple/fast: claude-haiku-4-5-20251001
• OpenAI: gpt-4o, o3

1. Write system prompt — specific, actionable, bounded. Not generic.

1. Select tools — default agent_toolset_20260401 (file ops, bash, web) covers most cases.

1. Create:

`` POST /v1/agents { "name", "model", "system", "tools": [{"type":"agent_toolset_20260401"}] } ``

1. Next steps — offer to create session, configure skills, set up model card.

Platform Quick Ref

Agents need a session to run. Sessions need an environment (sandbox).

oma agents create <name>                    # create agent
oma sessions create --agent <id> --env <id> # start session
oma sessions message <id> <text>            # send message
oma models create --name <n> --model-id <id> --api-key <key>
oma keys create                             # generate API key
oma skills install <slug>                   # install from ClawHub
oma --help                                  # full command list

Model card providers: ant, oai, ant-compatible, oai-compatible.