Agents

Each agent is an independent AI assistant with its own personality, memory, model, and Telegram bot.

Create an Agent

From Telegram: Send /newagent to the admin bot.

From CLI:

camel agents

Select “Create new agent”, enter a name, pick a model, optionally add a Telegram bot.

Configure an Agent

camel agents

Select an agent to change:

• Model — which AI model to use
• Name — display name
• Thinking — reasoning depth (off/low/medium/high)
• Effort — response effort (low/medium/high/max)
• Telegram — bot token
• Remove — delete the agent

Agent Workspace

Each agent gets its own workspace at ~/.camelagi/agents/<id>/:

~/.camelagi/agents/coder/
├── SOUL.md          # Personality and behavior
├── TOOLS.md         # Environment notes
├── MEMORY.md        # Long-term curated memory
└── memory/          # Daily auto-journaling
    ├── 2026-03-20.md
    └── 2026-03-21.md

SOUL.md

Defines the agent’s personality, tone, and boundaries. Edit with:

camel soul <agent-id>

Or send /soul <id> in the admin bot.

Memory

Two-tier memory system:

• MEMORY.md — curated facts, decisions, preferences (the agent reads and updates this)
• memory/*.md — daily auto-journaling (appended during context compaction)

Search memory with the memory_search tool. Read specific files with memory_get.

Clone an Agent

From Telegram: /cloneagent

Copies all config, SOUL.md, TOOLS.md, MEMORY.md, and memory files to a new agent.

Built-in Tools

Every agent has access to: