AionClaw本地工具失效主因是更新后权限作用域被静默重置为最小集，需先运行openclaw doctor --check tool-permissions查拦截项，再检查agent.permissions配置及tos字段是否为"full"，最后按序执行权限重置、补全与进程重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
更新后AionClaw本地工具（如文件读写、Excel解析、定时任务触发）突然失效，不是模型变差或配置丢失，而是权限作用域被静默重置为最小可用状态；必须逐层验证工具调用链路中被砍断的权限节点。
确认工具调用是否被权限拦截
打开终端，执行：openclaw doctor --check tool-permissions。该命令会输出当前所有已注册工具的权限状态，重点查找含 denied、scope_permission_missing 或 deprecated 字样的行。
若无此子命令，说明版本低于2026.3.0，请改用日志过滤：在 AionClaw 客户端设置里开启「详细日志」→ 执行一次失败工具操作 → 在日志窗口搜索 tool_execution 和 WARN，定位拒绝原因字段。
这一步跳过“猜模型”环节，直接锁定是框架层拦截还是工具层报错。
检查权限配置是否被重置
方法一：用命令行查看当前生效的权限集
运行：openclaw config get agent.permissions。正常应返回一个包含 agent.fs.read、agent.fs.write、agent.process.exec 等完整权限项的 JSON 数组。如果只返回 ["agent.fs.read"] 或为空数组，说明更新时权限模板被覆盖回默认最小集。
方法二：手动检查配置文件中的权限声明
先执行 openclaw config --show-path 获取真实配置路径，然后用文本编辑器打开 【openclaw.json】，搜索 "permissions" 字段。注意：不要修改 tos 字段以外的任何顶层键——它控制沙盒开关，改错会导致全部本地操作禁用。
⚠️关键点：【tos】必须设为 "full" 才能启用完整本地工具链，更新后该字段常被自动降级为 "restricted"，这是本地工具集体失灵的最常见原因。
恢复被砍掉的工具权限
第一步：重置为全权限模式
执行：openclaw config set tos full。这一步解除沙盒限制，让底层文件系统、进程调用、剪贴板访问等通道重新开放。
第二步：显式补全缺失权限项
根据第一步 doctor 命令发现的缺失项（例如 agent.fs.write），逐条写入：openclaw config set agent.permissions '["agent.fs.read","agent.fs.write","agent.process.exec"]'
第三步：重启 AionClaw 进程
关闭客户端 → 在终端中确认无残留进程：ps aux | grep openclaw（macOS/Linux）或 tasklist | findstr openclaw（Windows）→ 杀死所有残留进程 → 重新双击启动客户端。
这三步必须按顺序执行，跳过第二步仅设 tos full，部分工具仍因权限白名单未覆盖而拒绝执行；不执行第三步，旧进程缓存的权限状态不会刷新。
