核心配置項(xiàng)

"tools": {
  "profile": "coding",
  "allow": ["read", "write", "exec", "message"],
  "deny": ["rm", "format"],
  "exec": {
    "enabled": true,
    "allowedCommands": ["mkdir", "echo", "cat", "ls", "git", "npm"],
    "allowShell": false,
    "workingDirectory": "/Users/yangwen/.openclaw/workspace",
    "timeout": 30
  },
  "approval": {
    "mode": "auto",
    "highRiskCommands": ["rm", "dd", "shutdown"]
  }
}

1. profile 工具集預(yù)設(shè)

• 可選值：coding / general / full / custom
• 作用：快速切換不同場(chǎng)景的工具集預(yù)設(shè)
• coding：代碼開發(fā)場(chǎng)景，默認(rèn)開放文件讀寫、代碼執(zhí)行、Git操作等開發(fā)常用工具
• general：通用辦公場(chǎng)景，開放消息處理、文檔編輯、日歷管理等工具
• full：全量工具權(quán)限（風(fēng)險(xiǎn)較高，僅推薦測(cè)試環(huán)境使用）
• custom：自定義模式，完全由 allow/deny 列表控制

2. allow 工具白名單

• 數(shù)組類型，顯式指定允許使用的工具名稱
• 優(yōu)先級(jí)高于 profile 預(yù)設(shè)，會(huì)額外開放預(yù)設(shè)外的工具
• 示例：["read", "write", "exec", "feishu_doc"] 表示允許使用文件讀寫、命令執(zhí)行和飛書文檔工具

3. deny 工具黑名單

• 數(shù)組類型，顯式禁止使用的工具名稱
• 優(yōu)先級(jí)最高，即使在 profile 或 allow 列表中包含，也會(huì)被禁止
• 示例：["rm", "format", "exec"] 表示禁用刪除、格式化和命令執(zhí)行工具

exec 命令執(zhí)行工具專屬配置：

approval 工具審批配置：

常用配置示例

代碼開發(fā)場(chǎng)景推薦配置

"tools": {
  "profile": "coding",
  "exec": {
    "enabled": true,
    "allowedCommands": ["mkdir", "echo", "cat", "ls", "git", "npm", "python", "java"],
    "allowShell": false,
    "timeout": 60
  }
}

高安全場(chǎng)景配置

"tools": {
  "profile": "general",
  "deny": ["exec", "rm"],
  "approval": {
    "mode": "high-risk-only"
  }
}

配置修改后需要執(zhí)行 openclaw gateway restart 重啟網(wǎng)關(guān)生效

到此這篇關(guān)于openclaw的tools配置詳細(xì)的文章就介紹到這了,更多相關(guān)openclaw tools配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論