Clawdbot 工具

Clawdbot 提供強大的代理工具,用於瀏覽器自動化、畫布、節點、定時任務等。了解如何配置和使用 Clawdbot 工具。

Clawdbot 工具概覽

Clawdbot 提供一流的代理工具,包括瀏覽器、畫布、節點和定時任務。這些工具具有類型定義,無需使用 shell,代理可以直接調用它們。

禁用工具

您可以通過 clawdbot.json 中的 tools.allow / tools.deny 全局允許/拒絕工具(拒絕優先):

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

注意:

  • 匹配不區分大小寫
  • 支持 * 通配符("*" 表示所有工具)

工具配置檔案

tools.profiletools.allow / tools.deny 之前設置基礎工具白名單。

配置檔案包含的工具
minimalsession_status
codinggroup:fsgroup:runtimegroup:sessionsgroup:memoryimage
messaginggroup:messagingsessions_listsessions_historysessions_sendsession_status
full無限制(與未設置相同)

範例(預設僅限訊息傳遞):

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

工具群組

工具策略支持 group:* 條目,可擴展為多個工具:

群組工具
group:runtimeexecbashprocess
group:fsreadwriteeditapply_patch
group:sessionssessions_listsessions_historysessions_sendsessions_spawnsession_status
group:memorymemory_searchmemory_get
group:webweb_searchweb_fetch
group:uibrowsercanvas
group:automationcrongateway
group:messagingmessage
group:nodesnodes

範例(僅允許文件工具 + 瀏覽器):

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

工具清單

核心工具

工具說明
apply_patch將統一差異補丁應用於文件
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 阻止危險工具
  • 可為不受信任的輸入提供沙盒環境

下一步