Agents
Guide Available

Create, Configure, and Run an Agent

An Agent is created with a pinned Template version, selected Skills, platform credentials, and explicit creator access. Configuration is applied deliberately, and running Agents restart when a runtime-relevant change must take effect.

For
Agent operators
On this page
  1. Choose a supported Runtime and Platform
  2. Understand the lifecycle
  3. Apply configuration safely
  4. Shared-channel behavior
  5. Before you start
01

Choose a supported Runtime and Platform

Runtime and chat Platform are separate choices. Hermes supports Slack, Telegram, and Discord. OpenClaw supports Slack, Microsoft Teams, Telegram, and Discord. The API validates each pairing, and the Platform cannot be changed through a normal Agent update.

02

Understand the lifecycle

Slack and Discord Agents start in STOPPED. Teams and Telegram Agents attempt to start during creation and become RUNNING or ERROR. STOPPED and ERROR Agents can be started; RUNNING Agents can be stopped. Deletion soft-deletes the Agent after removing runtime resources.

  1. 02.1

    Start rebuilds runtime resources, renders the pinned Template, and creates a fresh Ingest key.

  2. 02.2

    Stop snapshots logs before removing active runtime resources.

  3. 02.3

    A successful start clears a prior error; invalid repeated transitions return a conflict.

  4. 02.4

    Deleting a Slack or Discord Agent releases its bot token for reuse.

03

Apply configuration safely

The configuration page groups Profile, Template, platform routing, Skills, keys and integrations, Agent-owned overrides, and the Danger zone. A stopped Agent uses Apply and remains stopped. A running Agent uses Apply & Restart for runtime-relevant changes. Secret changes require separate credential-management permission, and plaintext is never returned.

04

Shared-channel behavior

Agents require an explicit mention in shared channels and groups. Slack requires a fresh mention on every message, including later thread messages. Direct messages are exempt. Mention policy is generated at start, so restart an Agent after changing applicable configuration.

05

Before you start

Verify the Template requirements, assigned Skills, provider credentials, routing allowlists, model, approval mode, and intended access. Test one representative request in an allowed destination and one request outside the allowed boundary.

Documentation