Clawdbot 工具
Clawdbot 提供强大的代理工具,用于浏览器自动化、画布、节点、定时任务等。了解如何配置和使用 Clawdbot 工具。
Clawdbot 工具概述
Clawdbot 提供一流的代理工具,用于浏览器、画布、节点和定时任务。这些工具是类型化的,不需要 shell,代理可以直接依赖它们。
禁用工具
您可以通过 clawdbot.json 中的 tools.allow / tools.deny 全局允许/拒绝工具(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 网关 - 网关配置