一行配置帮你解决OpenClaw部署后Tools工具权限被禁用的问题

作者:袖梨 2026-08-03

一行配置帮你解决OpenClaw部署后Tools工具权限被禁用的问题需要先看清适用场景和关键步骤,避免只记结论却忽略实际限制。

问题描述

刚部署完OpenClaw,发现Agent无法执行基本操作:

  1. 无法读取/修改本地文件
  2. 无法访问终端执行命令
  3.  Gateway Dashboard的Tools页面显示大量权限被关闭
  4. 尝试在Dashboard中手动开启权限,开关无法点击或保存后失效

如下图所示,Tools页面显示大部分工具处于禁用状态:

img_6a7019efb67ca30.webp

原因分析

OpenClaw默认使用最小权限原则(minimal profile),出于安全考虑,默认禁用了文件操作、命令执行等敏感工具。Dashboard中的权限开关受全局配置控制,当profile设置为minimal时,单个工具的开关无法被手动覆盖。

解决方案

修改OpenClaw配置文件,将工具权限策略从minimal(也有可能是别的,例如message)改为full

步骤

1.找到OpenClaw配置文件,通常位于:

~/.openclaw/openclaw.json# 或/etc/openclaw/openclaw.json

2.编辑配置文件,在tools部分添加或修改profile字段:

{  "tools": {    "profile": "full"  }}

完整配置示例:

{  "gateway": {    "host": "0.0.0.0",    "port": 8080  },  "tools": {    "profile": "full"  },  "agents": {    "main": {      "model": "kimi-coding/k2p5"    }  }}

3.重启OpenClaw Gateway使配置生效:

openclaw gateway restart# 或使用systemdsudo systemctl restart openclaw

验证修复

重启后访问Gateway Dashboard(默认http://localhost:8080),进入Tools页面:

img_6a7019efb67cf31.webp

可以看到所有工具权限已正常启用,显示"25/25 enabled"。

权限策略说明

Profile说明适用场景
minimal仅启用最基础工具(如web搜索)生产环境、高安全性要求
coding启用开发相关工具(文件读写、终端)代码开发、脚本编写
messaging启用消息发送相关工具自动化通知、IM集成
full启用所有可用工具本地开发、功能测试

安全建议

  1. 本地开发:可使用full profile获得完整功能
  2. 生产部署:建议根据实际需求选择codingmessaging,而非直接全开
  3. 敏感环境:保持minimal,通过perToolOverrides单独授权特定工具

相关文章

精彩推荐