Инструменты Clawdbot

Clawdbot предоставляет мощные инструменты агента для автоматизации браузера, холста, узлов, запланированных задач и многого другого. Узнайте, как настроить и использовать инструменты Clawdbot.

Обзор инструментов Clawdbot

Clawdbot предоставляет первоклассные инструменты агента для браузера, холста, узлов и cron. Эти инструменты типизированы, не требуют shell, и агент может полагаться на них напрямую.

Отключение инструментов

Вы можете глобально разрешить/запретить инструменты через tools.allow / tools.deny в clawdbot.json (запрет имеет приоритет):

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

Примечания:

  • Сопоставление не учитывает регистр
  • Поддерживаются подстановочные знаки * ("*" означает все инструменты)

Профили инструментов

tools.profile устанавливает базовый список разрешённых инструментов перед tools.allow / tools.deny.

ПрофильВключённые инструменты
minimalТолько session_status
codinggroup:fs, group:runtime, group:sessions, group:memory, image
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
fullБез ограничений (то же, что не установлено)

Пример (только обмен сообщениями по умолчанию):

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

Группы инструментов

Политики инструментов поддерживают записи group:*, которые расширяются до нескольких инструментов:

ГруппаИнструменты
group:runtimeexec, bash, process
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, session_status
group:memorymemory_search, memory_get
group:webweb_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes

Пример (разрешить только файловые инструменты + браузер):

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

Каталог инструментов

Основные инструменты

ИнструментОписание
apply_patchПрименить унифицированные diff-патчи к файлам
execВыполнить shell-команды
processУправление процессами
web_searchПоиск в интернете
web_fetchПолучение веб-страниц
browserАвтоматизация браузера
canvasХолст для визуального контента
nodesКоманды узловых устройств
imageОбработка изображений
messageОтправка сообщений
cronПланирование задач
gatewayУправление шлюзом

Инструменты сессий

ИнструментОписание
sessions_listСписок активных сессий
sessions_historyПолучить историю сессии
sessions_sendОтправить в сессию
sessions_spawnСоздать новую сессию
session_statusПолучить статус сессии

Политика инструментов для конкретного провайдера

Используйте tools.byProvider для ограничения инструментов для конкретных провайдеров:

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

Плагины + Инструменты

Плагины могут регистрировать дополнительные инструменты помимо основного набора. Подробности см. в документации по плагинам.

Безопасность

  • Инструменты представляются агенту с чёткими описаниями
  • Используйте tools.deny для блокировки опасных инструментов
  • Песочница доступна для ненадёжных входных данных

Следующие шаги