OpenClaw部署后Tools权限禁用？一行配置快速修复

典型故障现象

OpenClaw刚启动，Agent便停止响应，这类问题在初次部署时相当普遍。具体表现为：

• Agent完全无法读取本地文件，更别提执行写入或修改操作
• 终端命令被彻底封锁，Agent无法调用任何系统指令
• Gateway Dashboard的Tools页面中，权限开关几乎全部处于关闭状态
• 更棘手的是，即便手动点击Dashboard里的开关，按钮要么毫无反应，要么保存后自动复位

直观来看，下图所示即为典型状态——工具列表大面积灰色禁用：

根因剖析

这一现象源自OpenClaw内置的安全保护机制。默认配置采用最小权限策略（minimal profile），优先确保安全性，因此文件操作、命令执行等高敏感工具在初始状态下全部禁用。那Dashboard上的开关能否手动开启？答案是否定的——因为所有开关受全局配置统领，一旦profile被锁定为minimal，单个工具的手动覆盖便不再生效。开关明明可见，点击却形同虚设。

解决方案

核心思路是将权限策略从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. 重启生效
修改完毕后，必须重启Gateway服务：

openclaw gateway restart
# 或使用systemd
sudo systemctl restart openclaw

验证修复

重启完成，再次打开Gateway Dashboard（默认地址http://localhost:8080），进入Tools页面确认：

此时所有工具权限正常激活，显示“25/25 enabled”——全部就位。

权限策略详解

为帮助准确选型，下表整理了各Profile的核心区别：

安全实践建议

最后，提供几条实际部署时值得采纳的建议：

• 本地开发：直接使用full profile，释放全部功能，提升开发效率。
• 生产部署：避免盲目全开，根据业务需求选择coding或messaging即可。
• 敏感环境：保留minimal不变，若确实需要特定工具，通过perToolOverrides单独授权——实现细粒度控制，兼顾安全与灵活。

来源：互联网