Bots

Bots are the execution unit in Claw. Each bot combines identity, access, runtime, and behavior so automations stay predictable and easy to operate.

Open Settings > Bots to create and manage them.

What a bot contains

A bot profile usually includes:

• Workspace
• Routing mode
• Runtime mode
• Permission profile
• Working style

Think of this as: who the bot is, where it can run, and how it should behave.

First reliable bot pattern

1. Pick workspace scope (managed or project folder)
2. Choose runtime (Host or Container)
3. Set routing (Local only or channel preset)
4. Apply permission and security constraints
5. Set/confirm working style
6. Run a safe validation task

Workspace options

• Managed: isolated workspace managed by Claw
• Project folder: execution in existing repo/docs folders

Guidance:

• Use managed workspaces for isolation and experimentation
• Use project folders for repo-aware execution

Routing options

• Local only: no remote channel dependency
• Channel preset: reusable remote destination and sender policy

Start local-only first, then add channel routing once bot behavior is stable.

Runtime options

• Host: runs directly on your machine
• Container: runs in Docker/Podman

Container controls include:

• Network on/off
• Shell/terminal access
• Web access behavior (depends on network setting)

Guidance:

• Use container runtime for stronger isolation
• Use host runtime for faster local iteration

Lifecycle actions

Common operations:

• Create
• Edit
• Clone
• Open chat
• Open activity
• Stop
• Delete

Operations guidance

• Clone bots to test behavior without changing production profiles
• Keep one purpose per bot when possible
• Review activity after major config changes
• Re-validate permissions when workspace/runtime changes

Related detail pages

• Security
• Working Styles
• Channels
• Tasks
• Playbooks