OpenClaw部署后Tools工具权限被禁用？一行配置解决

问题描述

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

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

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

原因分析

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
   # 或使用systemd
   sudo systemctl restart openclaw
   

验证修复

重启后访问Gateway Dashboard（默认），进入Tools页面：

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

权限策略说明

安全建议

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

参考

• OpenClaw官方文档 - 工具权限配置
• OpenClaw GitHub Issues

记录于2026年3月4日