跳到主要内容

工具配置

工具配置位于 config.jsontools 字段下。

{
"tools": {
"web": { ... },
"exec": { ... },
"cron": { ... },
"skills": { ... }
}
}

网络搜索工具

配置项类型默认值说明
enabledboolfalse启用 Brave 搜索
api_keystringBrave Search API Key
max_resultsint5最大返回结果数

brave.com/search/api 免费获取 API Key(每月 2000 次查询)。

DuckDuckGo

配置项类型默认值说明
enabledbooltrue启用 DuckDuckGo 搜索
max_resultsint5最大返回结果数

DuckDuckGo 默认启用,无需 API Key。

Perplexity

配置项类型默认值说明
enabledboolfalse启用 Perplexity 搜索
api_keystringPerplexity API Key
max_resultsint5最大返回结果数

网络搜索配置示例

{
"tools": {
"web": {
"brave": {
"enabled": true,
"api_key": "YOUR_BRAVE_API_KEY",
"max_results": 5
},
"duckduckgo": {
"enabled": true,
"max_results": 5
},
"perplexity": {
"enabled": false,
"api_key": "pplx-xxx",
"max_results": 5
}
}
}
}

Exec 工具(命令执行)

Exec 工具代替 Agent 在系统上执行 Shell 命令。

配置项类型默认值说明
enable_deny_patternsbooltrue启用默认危险命令拦截
custom_deny_patternsarray[]自定义拦截正则表达式

默认拦截的危险命令

PicoClaw 默认拦截以下命令:

  • 删除类:rm -rfdel /f/qrmdir /s
  • 磁盘操作:formatmkfsdiskpartdd if=、写入 /dev/sd*
  • 系统操作:shutdownrebootpoweroff
  • 命令替换:$()${}、反引号
  • 管道执行:| sh| bash
  • 权限提升:sudochmodchown
  • 进程控制:pkillkillallkill -9
  • 远程执行:curl | shwget | shssh
  • 包管理:aptyumdnfnpm install -gpip install --user
  • 容器:docker rundocker exec
  • Git:git pushgit force
  • 其他:evalsource *.sh

Exec 配置示例

{
"tools": {
"exec": {
"enable_deny_patterns": true,
"custom_deny_patterns": [
"\\brm\\s+-r\\b",
"\\bkillall\\s+python"
]
}
}
}

Cron 工具(定时任务)

配置项类型默认值说明
exec_timeout_minutesint5任务执行超时时间(分钟),0 表示不限制

Skills 工具(技能商店)

Skills 工具管理通过注册表(如 ClawHub)发现和安装技能。

配置项类型默认值说明
registries.clawhub.enabledbooltrue启用 ClawHub 注册表
registries.clawhub.base_urlstringhttps://clawhub.aiClawHub 地址
registries.clawhub.search_pathstring/api/v1/search搜索 API 路径
registries.clawhub.skills_pathstring/api/v1/skills技能 API 路径
registries.clawhub.download_pathstring/api/v1/download下载 API 路径
{
"tools": {
"skills": {
"registries": {
"clawhub": {
"enabled": true,
"base_url": "https://clawhub.ai"
}
}
}
}
}

环境变量

所有配置项均可通过环境变量覆盖,格式为 PICOCLAW_TOOLS_<区域>_<键>

  • PICOCLAW_TOOLS_WEB_BRAVE_ENABLED=true
  • PICOCLAW_TOOLS_EXEC_ENABLE_DENY_PATTERNS=false
  • PICOCLAW_TOOLS_CRON_EXEC_TIMEOUT_MINUTES=10

注意:数组类型的配置项暂不支持通过环境变量设置,必须在配置文件中配置。