一行配置帮你解决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（默认http://localhost:8080），进入Tools页面：

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

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

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

到此这篇关于一行配置帮你解决OpenClaw部署后Tools工具权限被禁用的问题的文章就介绍到这了,更多相关OpenClaw Tools工具权限被禁用解决内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！