Skip to main content

​
What is an Agent?

An agent in Havoc is an autonomous AI entity that runs inside a secure Docker container. Each agent has its own OpenClaw gateway, workspace, memory, and channel connections. Agents can:
  • Respond to messages from any connected channel (WhatsApp, Telegram, Discord, etc.)
  • Execute tools (web search, file operations, browser automation, etc.)
  • Maintain long-term memory across conversations
  • Run scheduled tasks via cron jobs
  • Spawn sub-agents for complex workflows

​
Agent Lifecycle

Template (optional)
    |
    v
Create Agent --> Configure --> Deploy --> Running
                                            |
                                    [ Pause / Resume / Delete ]
StateDescription
CreatedAgent configuration exists but container is not running.
DeployingDocker container is being provisioned.
RunningAgent is active and processing messages.
PausedContainer is stopped but configuration is preserved.
ErrorContainer failed to start or crashed.

​
Agent Configuration

Each agent has an extensive configuration with 80+ fields, organized into sections:

​
Model Configuration

Select the primary AI model and fallbacks: 
{
  "model": {
    "primary": "anthropic/claude-sonnet-4-5",
    "fallbacks": ["openai/gpt-5.2"]
  }
}
Supported providers: Anthropic, OpenAI, Google, OpenRouter, Groq, Mistral, xAI, Ollama, and many more.

​
Workspace Files

Every agent has a workspace with markdown files that define its behavior:
FilePurpose
AGENTS.mdOperating instructions, priorities, memory rules
SOUL.mdPersona, tone, boundaries
TOOLS.mdLocal tool notes and conventions
IDENTITY.mdAgent name, vibe, emoji
USER.mdUser profile, how to address the user
MEMORY.mdCurated long-term memory

Learn more about Workspaces

Deep dive into workspace file structure and best practices.

​
Tool Policy

Control which tools the agent can use: 
{
  "tools": {
    "allow": [],
    "deny": ["group:automation"],
    "elevated": { "enabled": false }
  }
}
Tool groups include: group:runtime, group:fs, group:web, group:ui, group:sessions, group:memory, group:messaging, group:automation, group:nodes.

​
Templates

Havoc provides pre-built templates for common use cases:
  • Customer Support Agent — Handles tickets, FAQs, and escalations
  • Sales Agent — Lead qualification and appointment booking
  • Research Agent — Web research and report generation
  • Personal Assistant — Calendar, reminders, and task management
Templates pre-configure the workspace files, model selection, and tool policy for each use case.

​
Multi-Agent

Havoc supports running multiple agents with independent configurations:
  • Each agent has its own Docker container, workspace, and sessions
  • Agents can be routed to different channels via bindings
  • Sub-agents can be spawned for background tasks

Guide: Create an Agent

Step-by-step guide to creating and deploying your first agent.