openclaw的tools配置详细实用指南

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“openclaw的tools配置详细”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

核心设置项

"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 工具集预设

• 可选值：coding / general / full / custom
• 作用：更快切换不同场景的工具集预设
• coding：代码开发场景，默认开放文件读写、代码执行、Git操作等开发常用工具
• general：通用办公场景，开放消息处理、文档编辑、日历管理等工具
• full：全量工具权限（风险较高，仅建议测试环境采用）
• custom：自定义模式，完全由 allow/deny 列表控制

2. allow 工具白名单

• 数组类型，显式指定允许采用的工具名称
• 优先级高于 profile 预设，会额外开放预设外的工具
• 示例：["read", "write", "exec", "feishu_doc"] 表示允许采用文件读写、命令执行和飞书文档工具

3. deny 工具黑名单

• 数组类型，显式禁止采用的工具名称
• 落到代码里，优先级最高，即使在 profile 或 allow 列表中包含，也会被禁止
• 示例：["rm", "format", "exec"] 表示禁用删除、格式化和命令执行工具

exec 命令执行工具专属设置：

approval 工具审批设置：

常用设置示例

代码开发场景建议设置

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

高安全场景设置

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

设置修改后需执行 openclaw gateway restart 重启网关生效

落到代码里，到此这篇关于openclaw的tools设置详细的文章就介绍到这了,更多相关openclaw tools设置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！