内置工具

AweeClaw 平台提供了一系列内置工具，场景可以直接声明使用，无需额外开发。

可用工具列表

文件操作

工具名	说明	权限要求
read_file	读取文件内容	workspace:read
write_file	写入文件	workspace:write
list_files	列出目录文件	workspace:read
delete_file	删除文件	workspace:write
search_files	搜索文件内容	workspace:read

网络操作

工具名	说明	权限要求
web_search	搜索互联网	web:search
web_fetch	获取网页内容	web:fetch

用户交互

工具名	说明	权限要求
ask_user	向用户提问	无
show_message	显示消息	无
confirm	获取用户确认	无

知识管理

工具名	说明	权限要求
remember	记住信息	memory:write
recall	回忆信息	memory:read
forget	删除记忆	memory:write

系统操作

工具名	说明	权限要求
execute_command	执行命令	system:shell
open_url	打开 URL	system:url

使用方式

声明式场景

在 scenario.json 的 capabilities.builtinTools 中声明：

{
  "capabilities": {
    "builtinTools": [
      "web_search",
      "read_file",
      "write_file",
      "ask_user",
      "remember"
    ]
  }
}

编程式场景

在 getPlugin() 的 capabilities.toolPacks 中声明：

getPlugin() {
  return {
    capabilities: {
      toolPacks: ['web-search', 'file-operations', 'memory'],
    }
  }
}

工具包 (Tool Packs)

编程式场景支持按工具包批量启用：

工具包	包含工具
web-search	web_search, web_fetch
file-operations	read_file, write_file, list_files, delete_file, search_files
memory	remember, recall, forget
user-interaction	ask_user, show_message, confirm
system	execute_command, open_url

权限要求

每个内置工具都需要相应的权限声明。如果场景未声明权限，对应工具将不可用。

{
  "permissions": [
    "workspace:read",
    "workspace:write",
    "web:search",
    "memory:write"
  ]
}

详见 权限声明。