HalosHalosDocs

Agent Types

Every Halos agent is a cloud-hosted AI instance powered by OpenClaw. Each agent type comes pre-configured with a specialized system prompt, default skills, and graduated permissions designed for its domain. You can customize everything after deployment — but the defaults are designed to be useful immediately.

All agents share a common set of core capabilities regardless of type:

  • Web browsing — Navigate websites, interact with pages, extract data
  • Web search — Search the internet for real-time information
  • File management — Handle file uploads, attachments, and storage
  • Knowledge search — Query your personal knowledge base for relevant context
  • Knowledge storage — Save new information to your knowledge base
  • Todo management — Create, list, complete, and update todos
  • Document reading/writing — Access and edit your wiki/docs

Email Agent

Purpose: Take control of your inbox. Your email agent triages incoming mail, drafts replies in your voice, organizes with labels, and flags what actually needs your attention.

Default Skills

  • Email Triage — Automatically categorize emails by urgency and type
  • Draft Replies — Write response drafts matching your communication style
  • Smart Labels — Organize your inbox with intelligent labeling

How It Works

When connected to Gmail, your email agent can:

  1. Read your inbox — Scan recent emails, search by sender/subject/content
  2. Prioritize — Classify emails as urgent, important, or FYI based on your triage rules
  3. Draft replies — Write responses using your tone, sign-off style, and knowledge of contacts
  4. Apply labels — Organize emails into categories (at Helper trust or higher)
  5. Send emails — Send replies and new emails on your behalf (at Partner trust or higher)
  6. Proactive monitoring — With heartbeats enabled, check your inbox on a schedule and alert you to anything urgent

Permission Progression

| Permission | Required Level | Trust Tier | |-----------|---------------|------------| | Read & summarize emails | Level 1 | Observer | | Suggest actions | Level 1 | Observer | | Draft replies | Level 3 | Helper | | Apply labels | Level 5 | Helper | | Send emails | Level 8 | Partner | | Delete/archive emails | Level 15 | Trusted |

Agent Email Address

Beyond Gmail access, your email agent can have its own dedicated email address (e.g., luna@mail.halos.sh). External emails sent to this address are processed by the agent, which can respond, forward, or store them — making it perfect for support inboxes, newsletter digests, or notification routing.

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | Key contacts | Names, roles, and context for people you email regularly | | Knowledge | Email templates | Templates you use for common replies | | Instruction | Triage rules | What counts as urgent, important, or ignorable for you | | Instruction | Tone guide | Your communication style, greeting, and sign-off preferences | | Example | Reply examples | 2-3 real emails you've sent showing your actual style |

Best Integrations

  • Gmail (essential) — Read and manage your real inbox
  • Google Calendar — Reference your schedule when drafting meeting-related replies
  • Notion — Pull project context into email responses

Example Prompts

Check my inbox and tell me what's important

Draft a reply to Sarah's email about the Q3 timeline — tell her we're on track

Go through my unread emails. Archive anything that's purely FYI.

Find all emails from John in the last week and summarize them

Calendar Agent

Purpose: Never miss a meeting, double-book yourself, or walk into a call unprepared. Your calendar agent manages your schedule, detects conflicts, sends reminders, and preps briefings.

Default Skills

  • Schedule Management — View, create, and modify calendar events
  • Conflict Detection — Identify overlapping or back-to-back meetings
  • Smart Reminders — Proactive reminders with context about what's coming

How It Works

When connected to Google Calendar or Apple Calendar, your calendar agent can:

  1. View your schedule — See upcoming events across all connected calendars
  2. Detect conflicts — Spot double-bookings and back-to-back meetings
  3. Create events — Schedule new meetings with the right details
  4. Send reminders — Proactive check-ins before important meetings
  5. Meeting prep — Pull context from your knowledge base about attendees and topics
  6. Suggest times — Find open blocks when someone asks to meet

Permission Progression

| Permission | Required Level | Trust Tier | |-----------|---------------|------------| | View events | Level 1 | Observer | | Suggest times | Level 1 | Observer | | Create events | Level 3 | Helper | | Reschedule events | Level 5 | Partner | | Cancel events | Level 8 | Trusted |

Supported Calendars

| Calendar | Connection Method | Capabilities | |----------|------------------|--------------| | Google Calendar | Google OAuth | Full read/write — view, create, modify events | | Apple Calendar | CalDAV (app-specific password) | Read events, create new events | | Any ICS/webcal | Calendar URL subscription | Read-only event sync |

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | Meeting context | Regular meetings, their purpose, and key participants | | Instruction | Scheduling rules | Preferred meeting times, buffer requirements, meeting-free blocks | | Instruction | Daily brief format | How you want schedule summaries structured | | Knowledge | Time zone info | Your time zone and common collaborator time zones |

Best Integrations

  • Google Calendar or Apple Calendar (essential) — Real schedule data
  • Gmail — Cross-reference meeting-related emails
  • Calendar URL — Subscribe to external ICS feeds (team calendars, sports, etc.)

Example Prompts

What does my schedule look like this week?

Am I free at 3pm tomorrow?

Schedule a 30-minute meeting with the design team on Thursday afternoon

Give me a briefing for my 2pm meeting with Acme Corp

Research Agent

Purpose: Stay informed without spending hours reading. Your research agent searches the web, summarizes articles, tracks trends, and compiles reports on demand.

Default Skills

  • Web Search (Deep) — Comprehensive internet search with source evaluation
  • Article Summary — Extract key points from long articles and papers
  • Trend Tracking — Monitor topics over time and flag notable developments

How It Works

Your research agent has access to:

  1. Web search — Search the internet via Brave Search API for real-time information
  2. Web scraping — Extract full content from any URL as structured markdown via Firecrawl
  3. Browser automation — Navigate complex websites, interact with JavaScript-heavy pages, and extract data using Stagehand + Browserbase
  4. Knowledge base — Cross-reference findings against what it already knows about you and your interests
  5. Source evaluation — Prioritize primary sources and flag when information is outdated

Core Capabilities

| Capability | Description | |-----------|-------------| | Quick lookup | 3-5 key findings with sources in seconds | | Deep dive | Comprehensive research brief with executive summary, findings, and source list | | Competitor monitoring | Track company news, funding, product launches | | Meeting prep | Background research on companies and people before meetings | | Daily digest | Automated industry news roundup via heartbeats | | Data extraction | Pull structured data from websites and reports |

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | Industry context | Your industry, key players, terminology | | Knowledge | Preferred sources | Publications, databases, and websites you trust | | Instruction | Output format | How you want research presented (brief, report, bullets) | | Instruction | Focus areas | Topics you track, recurring research themes | | Example | Research output | An example of a research summary you'd consider "good" |

Best Integrations

  • Notion — Save research findings directly to your Notion workspace
  • Slack — Share research summaries with your team

Example Prompts

What's the latest on React Server Components?

Deep dive on the competitive landscape for AI coding tools — include market share data and recent funding

I'm meeting with Acme Corp tomorrow. What should I know about them?

Summarize this article: [URL]

Track any news about [competitor] this week

Code Agent

Purpose: Get instant code reviews, debugging help, architecture advice, and PR summaries without context-switching away from your work.

Default Skills

  • Code Review — Systematic review focused on security, bugs, performance, and style
  • Debugging — Root cause analysis with suggested fixes
  • Code Generation — Write code based on specifications and requirements

How It Works

Your code agent can:

  1. Review code — Analyze functions, modules, or full PRs for issues and improvements
  2. Debug errors — Analyze error messages, stack traces, and code to find root causes
  3. Generate code — Write code based on your requirements, conventions, and tech stack
  4. Explain code — Break down complex codebases or unfamiliar libraries
  5. Architecture advice — Discuss design patterns, tradeoffs, and best practices
  6. PR management — Summarize open PRs and review changes (with GitHub connected)
  7. Browser-based research — Navigate documentation sites, Stack Overflow, and GitHub repos

Permission Progression

No special write permissions are needed for code agents — they primarily assist through chat. With GitHub connected, they gain read access to your repositories, PRs, and issues.

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | Tech stack | Languages, frameworks, libraries, and tools you use | | Knowledge | Code conventions | Naming conventions, file structure, patterns | | Instruction | Review priorities | What to focus on (security > bugs > performance > style) | | Instruction | PR process | Your team's workflow, approval requirements, CI/CD | | Example | Code review | An example review showing your feedback style |

Best Integrations

  • GitHub (recommended) — Access repos, PRs, issues, and code directly
  • Notion — Reference technical documentation and specs

Example Prompts

Review this function and suggest improvements:
[paste code]

I'm getting this error: [error message]. Here's the code: [paste code]

What open PRs do I have on the main repo?

I need to add real-time notifications to our Next.js app. We use Supabase. What's the best approach?

Write a React hook that debounces an API call with a configurable delay

Photo Agent

Purpose: Organize your photo library without the tedious manual work. Your photo agent tags, categorizes, detects duplicates, and creates albums from your image collection.

Default Skills

Your photo agent starts with the core skill set (web browsing, web search, file management, shell commands) and focuses on image organization tasks through its specialized system prompt.

How It Works

Your photo agent can:

  1. Tag and categorize — Analyze images and apply descriptive tags
  2. Organize into albums — Group photos by event, date, location, or theme
  3. Detect duplicates — Find and flag duplicate or near-duplicate images
  4. Clean up — Identify blurry, dark, or low-quality photos for review
  5. Search — Find specific photos based on content descriptions

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | Photo categories | How you organize your photos (by event, trip, person, etc.) | | Instruction | Organization rules | Your preferred album structure and naming conventions | | Instruction | Quality standards | What you consider "keep" vs. "delete" | | Knowledge | Key people/places | People and locations that appear frequently in your photos |

Example Prompts

Go through my recent photos and organize them into albums by event

Find any duplicate photos in my library

Tag all the photos from last weekend's trip

Custom Agent

Purpose: Build an agent that does exactly what you need. Custom agents start as a blank slate with the full core capability set — you shape them entirely through training.

Default Skills

Custom agents get the same core skills as every other type:

  • Web browsing and search
  • File management
  • Knowledge search and storage
  • Todo management
  • Document reading/writing

Why Custom?

Custom agents are the right choice when:

  • Your use case doesn't fit neatly into email, calendar, research, code, or photo
  • You want a personal productivity coach that knows your goals and projects
  • You need a domain-specific expert trained on your company's documentation
  • You want a writer or content agent trained on your voice and style
  • You want a project manager that tracks work across multiple areas
  • You need anything unique to how you work

Training Is Key

Specialty agents work well out of the box because their system prompts and defaults are tuned. Custom agents start more generic — they shine once you've invested in training. The more knowledge, instructions, and examples you provide, the more specialized and useful a custom agent becomes.

Training Recommendations

| Type | Title | What to Include | |------|-------|----------------| | Knowledge | About me | Your role, company, interests, goals — the more detail, the better | | Knowledge | Key projects | Current projects, deadlines, priorities | | Instruction | Communication style | How you want information presented | | Instruction | Core behavior | What the agent should do, how it should think, what to prioritize | | Instruction | Boundaries | Topics to avoid, things you don't want help with | | Example | Task handling | Examples of how you want tasks broken down and handled |

Example Prompts

What should I focus on today? I have about 4 hours of deep work time.

Help me outline the technical spec for the API migration

Let's do the weekly review — what did I accomplish this week?

Break down this project into actionable steps with estimated time

Choosing the Right Agent

Start with your biggest pain point

| If you spend time on... | Deploy a... | |------------------------|------------| | Email triage and replies | Email Agent | | Scheduling and meetings | Calendar Agent | | Looking things up and reading | Research Agent | | Code review and debugging | Code Agent | | Organizing photos | Photo Agent | | A mix of everything | Custom Agent |

Build a team over time

The real power of Halos shows up when you have multiple specialized agents working together in The Yard. A recommended starting team:

| Agent | Specialty | Role | |-------|-----------|------| | Luna | Email | Inbox management, communication | | Sol | Calendar | Schedule, meetings, time management | | Atlas | Research | Information gathering, trend tracking | | Nova | Code | Development support |

Every agent can be customized

Regardless of type, every agent supports:

  • Custom training data (knowledge, instructions, examples)
  • Configurable personality (tone, verbosity, communication style)
  • Model selection (Claude, GPT-4o, Gemini, and more)
  • Individual skill installation from ClawHub
  • Voice assignment via ElevenLabs
  • Heartbeat scheduling for proactive check-ins
  • Dedicated email address
  • Telegram bot integration

Next Steps