---
title: 工具白名单控制，禁止危险工具
description: "工具白名单控制是OpenClaw安全加固的核心防线，通过限制Agent可调用的系统能力，防止高危操作（如删除文件、执行任意命令、修改权限）被恶意利用或误执行。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaiagent/bestpractice/aiagent-0054.html
sourcePath: /source/zh/kunpengaiagent/bestpractice/aiagent-0054.html
indexId: bd3aace0ca7e8ab55cb7c40ae1b70c6ec46dc4ccb894d9d4668763058addb71656
---
# 工具白名单控制，禁止危险工具

工具白名单控制是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
```


- 方式二

  1. 打开配置文件。

```
vim
~
/.openclaw/openclaw.json
```


  2. 按“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"
]
}
}
```


  3. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
  4. 重启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
```