工具白名单控制，禁止危险工具

工具白名单控制是OpenClaw安全加固的核心防线，通过限制Agent可调用的系统能力，防止高危操作（如删除文件、执行任意命令、修改权限）被恶意利用或误执行。

工具说明

表1 工具组说明
工具组	包含工具	风险等级
group:runtime	exec、bash、process	极高
group:fs	read、write、edit、apply_patch	高
group:web	web_search、web_fetch	中
group:ui	browser、canvas	中
group:sessions	sessions_list、sessions_history、sessions_send、sessions_spawn、session_status	低
group:memory	memory_search、memory_get	低

表2 必须禁止的高危工具清单
工具	风险说明	禁用必要性
exec	执行任意Shell命令，可删库、篡改系统。	必须禁止
process	管理后台进程，可终止关键服务。	必须禁止
write / edit / apply_patch	写入/修改文件，可覆盖敏感配置。	强烈建议禁止
browser	可能访问敏感网站、抓取需要登录的页面、或在攻击者诱导下执行恶意操作。	建议关闭
nodes	节点调度，默认无用。	建议关闭
canvas	绘图功能，极少使用。	建议关闭

操作步骤

方式一：
1. 禁用所有高危工具。
  下述命令会禁用所有运行时操作类工具、文件系统操作、网络相关工具、UI交互工具、节点操作、画布绘图工具、应用补丁工具，请根据实际使用情况进行设置。
```
openclaw config set tools.deny '["group:runtime","group:fs","group:web","group:ui","nodes","canvas","apply_patch"]' --json
```
2. 重启OpenClaw网关。
```
openclaw gateway restart
```

方式二

打开配置文件。
```
vim ~/.openclaw/openclaw.json
```

按“i”进入编辑模式，请修改如下内容，若不存在请手动添加。

{
  "tools": {
    "deny": [
      "group:runtime",   // 运行时工具组 (exec, bash, process) - 最关键！
      "group:ui",        // 禁止UI交互工具，会影响TUI功能
      "group:fs",        // 禁止文件系统操作（读/写/删除文件、目录遍历等）
      "group:web",       // 禁止网络相关工具（HTTP请求、网页抓取等）
      "nodes",           // 禁止节点操作（可能是 node 管理相关工具）
      "canvas",          // 禁止画布/绘图工具
      "apply_patch"      // 禁止应用补丁工具（禁止代码修改）
    ]
  }
}

精准禁止（最严格）直接列出需要禁用的工具。

{
  "tools": {
    "allow": [
      "read",
      "web_search",
      "web_fetch",
      "sessions_list",
      "session_status",
      "memory_search",
      "memory_get"
    ],
    "deny": [
      "exec",
      "process",
      "write",
      "edit",
      "apply_patch",
      "nodes",
      "canvas",
      "cron",
      "gateway"
    ]
  }
}

按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
重启OpenClaw网关。
```
openclaw gateway restart
```

其他配置举例（使用预置Profile）

OpenClaw提供三种预置工具配置文件，可直接使用。

Profile	包含工具	适用场景
minimal	仅保留session_status。	只读对话场景，最安全。
messaging	消息类工具组。	聊天机器人。
coding	开放开发相关权限：文件系统（group:fs，如read/write）、运行时（group:runtime，如exec/process）、会话（group:sessions）、内存（group:memory）、图片（image）等。	开发/代码场景。
full	无权限限制。	本地开发、功能测试、需要完整AI能力场景。

方式一：
1. 将OpenClaw工具权限设置为最小权限。
```
openclaw config set tools.profile "minimal"
```
2. 重启OpenClaw网关。
```
openclaw gateway restart
```
方式二
1. 打开配置文件。
```
vim ~/.openclaw/openclaw.json
```
2. 按“i”进入编辑模式，请修改如下内容，若不存在请手动添加。
```
{
  "tools": {
    "profile": "minimal"
   }
}
```
3. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
4. 重启OpenClaw网关。
```
openclaw gateway restart
```

父主题： 运行配置