Clawdbot exposes powerful agent tools for browser automation, canvas, nodes, cron jobs, and more. Learn how to configure and use Clawdbot tools.

Clawdbot Tools Overview

Clawdbot exposes first-class agent tools for browser, canvas, nodes, and cron. These tools are typed, require no shelling, and the agent can rely on them directly.

Disabling Tools

You can globally allow/deny tools via tools.allow / tools.deny in clawdbot.json (deny wins):

{
  "tools": {
    "deny": ["browser"]
  }
}

Notes:

Matching is case-insensitive
* wildcards are supported ("*" means all tools)

Tool Profiles

tools.profile sets a base tool allowlist before tools.allow / tools.deny.

Profile	Tools Included
`minimal`	`session_status` only
`coding`	`group:fs`, `group:runtime`, `group:sessions`, `group:memory`, `image`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`full`	No restriction (same as unset)

Example (messaging-only by default):

{
  "tools": {
    "profile": "messaging",
    "allow": ["slack", "discord"]
  }
}

Tool Groups

Tool policies support group:* entries that expand to multiple tools:

Group	Tools
`group:runtime`	`exec`, `bash`, `process`
`group:fs`	`read`, `write`, `edit`, `apply_patch`
`group:sessions`	`sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `session_status`
`group:memory`	`memory_search`, `memory_get`
`group:web`	`web_search`, `web_fetch`
`group:ui`	`browser`, `canvas`
`group:automation`	`cron`, `gateway`
`group:messaging`	`message`
`group:nodes`	`nodes`

Example (allow only file tools + browser):

{
  "tools": {
    "allow": ["group:fs", "browser"]
  }
}

Tool Inventory

Core Tools

Tool	Description
`apply_patch`	Apply unified diff patches to files
`exec`	Execute shell commands
`process`	Process management
`web_search`	Search the web
`web_fetch`	Fetch web pages
`browser`	Browser automation
`canvas`	Canvas for visual content
`nodes`	Node device commands
`image`	Image processing
`message`	Send messages
`cron`	Schedule tasks
`gateway`	Gateway management

Session Tools

Tool	Description
`sessions_list`	List active sessions
`sessions_history`	Get session history
`sessions_send`	Send to a session
`sessions_spawn`	Spawn a new session
`session_status`	Get session status

Provider-Specific Tool Policy

Use tools.byProvider to restrict tools for specific providers:

{
  "tools": {
    "profile": "coding",
    "byProvider": {
      "google-antigravity": {
        "profile": "minimal"
      }
    }
  }
}

Plugins + Tools

Plugins can register additional tools beyond the core set. See the Plugins documentation for details.

Safety

Tools are presented to the agent with clear descriptions
Use tools.deny to block dangerous tools
Sandboxing is available for untrusted inputs

Next Steps

Clawdbot Skills - Extend with skills
Clawdbot Slash Commands - Command reference
Clawdbot Gateway - Gateway configuration

Clawdbot Tools

On this page