Clawdbot 工具
Clawdbot 提供強大的代理工具,用於瀏覽器自動化、畫布、節點、定時任務等。了解如何配置和使用 Clawdbot 工具。
Clawdbot 工具概覽
Clawdbot 提供一流的代理工具,包括瀏覽器、畫布、節點和定時任務。這些工具具有類型定義,無需使用 shell,代理可以直接調用它們。
禁用工具
您可以通過 clawdbot.json 中的 tools.allow / tools.deny 全局允許/拒絕工具(拒絕優先):
{
"tools": {
"deny": ["browser"]
}
}注意:
- 匹配不區分大小寫
- 支持
*通配符("*"表示所有工具)
工具配置檔案
tools.profile 在 tools.allow / tools.deny 之前設置基礎工具白名單。
| 配置檔案 | 包含的工具 |
|---|---|
minimal | 僅 session_status |
coding | group:fs、group:runtime、group:sessions、group:memory、image |
messaging | group:messaging、sessions_list、sessions_history、sessions_send、session_status |
full | 無限制(與未設置相同) |
範例(預設僅限訊息傳遞):
{
"tools": {
"profile": "messaging",
"allow": ["slack", "discord"]
}
}工具群組
工具策略支持 group:* 條目,可擴展為多個工具:
| 群組 | 工具 |
|---|---|
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 |
範例(僅允許文件工具 + 瀏覽器):
{
"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阻止危險工具 - 可為不受信任的輸入提供沙盒環境
下一步
- Clawdbot 技能 - 使用技能擴展
- Clawdbot 斜線命令 - 命令參考
- Clawdbot 網關 - 網關配置