Clawdbot expose des outils d'agent puissants pour l'automatisation du navigateur, le canvas, les nœuds, les tâches planifiées et plus encore. Apprenez à configurer et utiliser les outils Clawdbot.

Aperçu des outils Clawdbot

Clawdbot expose des outils d'agent de première classe pour le navigateur, le canvas, les nœuds et cron. Ces outils sont typés, ne nécessitent pas de shell, et l'agent peut s'y fier directement.

Désactiver les outils

Vous pouvez autoriser/refuser globalement les outils via tools.allow / tools.deny dans clawdbot.json (le refus l'emporte) :

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

Notes :

La correspondance est insensible à la casse
Les caractères génériques * sont pris en charge ("*" signifie tous les outils)

Profils d'outils

tools.profile définit une liste blanche d'outils de base avant tools.allow / tools.deny.

Profil	Outils inclus
`minimal`	`session_status` uniquement
`coding`	`group:fs`, `group:runtime`, `group:sessions`, `group:memory`, `image`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`full`	Aucune restriction (identique à non défini)

Exemple (messagerie uniquement par défaut) :

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

Groupes d'outils

Les politiques d'outils prennent en charge les entrées group:* qui s'étendent à plusieurs outils :

Groupe	Outils
`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`

Exemple (autoriser uniquement les outils de fichiers + navigateur) :

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

Inventaire des outils

Outils principaux

Outil	Description
`apply_patch`	Appliquer des patchs diff unifiés aux fichiers
`exec`	Exécuter des commandes shell
`process`	Gestion des processus
`web_search`	Recherche sur le web
`web_fetch`	Récupérer des pages web
`browser`	Automatisation du navigateur
`canvas`	Canvas pour le contenu visuel
`nodes`	Commandes des appareils de nœud
`image`	Traitement d'images
`message`	Envoyer des messages
`cron`	Planifier des tâches
`gateway`	Gestion de la passerelle

Outils de session

Outil	Description
`sessions_list`	Lister les sessions actives
`sessions_history`	Obtenir l'historique de session
`sessions_send`	Envoyer à une session
`sessions_spawn`	Créer une nouvelle session
`session_status`	Obtenir le statut de session

Politique d'outils spécifique au fournisseur

Utilisez tools.byProvider pour restreindre les outils pour des fournisseurs spécifiques :

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

Plugins + Outils

Les plugins peuvent enregistrer des outils supplémentaires au-delà de l'ensemble principal. Consultez la documentation des Plugins pour plus de détails.

Sécurité

Les outils sont présentés à l'agent avec des descriptions claires
Utilisez tools.deny pour bloquer les outils dangereux
Le sandboxing est disponible pour les entrées non fiables

Prochaines étapes

Compétences Clawdbot - Étendre avec des compétences
Commandes slash Clawdbot - Référence des commandes
Passerelle Clawdbot - Configuration de la passerelle

Outils Clawdbot