AionClaw中任务卡在“调用工具”环节，主因是工具未启用/未授权、依赖缺失、路径错误或安全软件拦截。需依次检查工具状态与授权、验证Python/Office等依赖、修正可执行文件路径、将AionClaw及子目录加入杀毒软件白名单。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
任务在AionClaw中卡在“调用工具”环节，说明智能体已识别指令、生成执行计划，但无法成功触发本地文件读写、浏览器操作、邮件发送等具体动作——这通常不是模型能力问题，而是权限、路径或工具状态未就绪。
确认工具是否已启用并完成授权
打开AionClaw客户端 → 左侧导航栏点击【工具管理】→ 查看右侧列表中目标工具（如“Excel操作”“微信消息发送”“本地文件搜索”）状态是否为绿色【已启用】。若显示灰色或“未授权”，点击右侧【授权】按钮，按提示允许AionClaw访问对应系统功能。
⚠️ 注意：macOS系统需额外进入「系统设置 → 隐私与安全性 → 完全磁盘访问」，手动勾选AionClaw；Windows用户需确认UAC弹窗未被静默拦截，必要时右键以管理员身份重启客户端。
检查工具依赖是否缺失或版本不兼容
方法一：查看工具详情页底部的「依赖项」标签。例如“PDF转文字”工具明确要求系统已安装Python 3.9+及pymupdf库；若未安装，AionClaw不会主动报错，而是卡在调用前等待超时。
方法二：在终端（Mac/Linux）或命令提示符（Windows）中运行aionclaw-cli --check-tool excel（将excel替换为实际工具名），它会返回缺失依赖的具体名称和安装命令，比如提示“libreoffice not found”，你就得先装LibreOffice而非仅靠WPS。
这一步不能跳过——很多工具表面显示“已启用”，实则因底层依赖未就位而静默失败。
验证工具调用路径是否指向真实可执行文件
第一步：在【工具管理】中找到目标工具 → 点击【编辑配置】→ 查看「可执行路径」字段。
第二步：将该路径完整复制，粘贴到文件管理器地址栏中回车。如果提示“文件不存在”或打开的是空文件夹，说明路径已失效——常见于用户重装软件、迁移办公电脑、或更新Office后导致exe位置变更（如从C:\Program Files\Microsoft Office\root\Office16\OUTLOOK.EXE变成C:\Program Files\Microsoft Office\root\vsoffice16\OUTLOOK.EXE）。
【必须手动修正路径，AionClaw不会自动扫描新位置】
第三步：修正后点击【保存并重启工具】，不要只点保存，否则新路径不生效。
排查工具进程是否被安全软件拦截
① 临时关闭Windows Defender实时保护、火绒、360等终端防护软件；
② 在任务管理器中查找是否有残留的aionclaw-tool-*进程（如aionclaw-tool-browser.exe），结束全部相关进程；
③ 重新触发一次任务，观察【自动化】面板中该工具条目右侧是否出现红色错误图标；
④ 若出现，鼠标悬停可看到具体报错，如“Access is denied”即为典型拦截信号，需将AionClaw安装目录及子目录aionclaw-tools整体加入白名单。
