OpenClaw工具配置详细教程：一步步操作指南

先来拆解 OpenClaw 工具配置的核心部分——它直接决定了 AI 能调用的能力边界。每个工具的行为都由 tools 配置文件管辖，下图展示了一个典型配置的完整结构：

整个配置文件逻辑清晰：先选定一个预设方案，再用黑白名单做细粒度调整，最后明确执行与审批权限。

profile：场景预设，一键切换

profile 是快速切换工具集预设的入口，支持四种模式：

• coding：代码开发场景，默认开放文件读写、代码执行、Git 操作等开发常用工具
• general：通用办公场景，开放消息处理、文档编辑、日历管理等工具
• full：全量工具权限，风险较高，仅推荐测试环境使用
• custom：完全自定义，由 allow/deny 列表全权控制

选择哪种预设取决于业务场景。日常开发选 coding，办公场景 general 基本够用。

allow 与 deny：黑白名单的精髓

allow 是工具白名单，显式指定允许使用的工具名称。它的优先级高于 profile 预设，可额外开放预设外的工具。例如 ["read", "write", "exec", "feishu_doc"] 表示允许文件读写、命令执行和飞书文档工具。

deny 则是黑名单，优先级最高。即便工具出现在 profile 或 allow 列表中，一旦列入 deny 即被禁止。例如 ["rm", "format", "exec"] 直接封死删除、格式化和命令执行这些高危操作。

exec 子模块：命令执行的控制中枢

这是整个配置里最容易出问题的模块，细节较多，参考下表：

特别提醒 allowShell 这个配置——开启后 AI 可运行 rm -rf 这类危险指令，风险极高，建议保持 false。日常工作环境下，通过 allowedCommands 列一个白名单足以覆盖大多数需求。

approval 配置：审批机制怎么设

审批模式决定了 AI 调用工具时的自动化程度，目前有三种选择：

• auto：自动放行低风险操作，适合日常开发
• manual：所有工具调用都需要人工审批，最安全但效率最低
• high-risk-only：仅高风险操作需要审批，推荐这种模式，安全与效率兼顾

highRiskCommands 则定义哪些命令会被视为“危险”，触发审批流程。默认通常包含 ["rm", "dd", "shutdown", "reboot", "mkfs", "chmod 777"]，你也可以自定义，比如用正则表达式匹配 ["rm -rf", "curl .* | sh", "wget .* | bash"] 来拦截更具体的危险行为。

常用配置示例

代码开发场景推荐配置：

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

高安全场景配置：

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

配置修改完成后，记得执行 openclaw gateway restart 重启网关，新配置才会生效。

来源：互联网