必须确认技能依赖的本地工具、系统权限和运行时环境已就绪,如缺少pandas库或excel路径未注册,将卡在“准备环境”阶段且无明确错误提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要确保AionClaw运行特定技能时不报错、不中断,必须在执行前确认该技能所依赖的本地工具、系统权限和运行时环境已就绪——比如「自动整理Excel报表」技能若缺少Python pandas库或Excel可执行文件路径未注册,会直接卡在“准备环境”阶段且无明确错误提示。
查看技能依赖清单
打开AionClaw客户端 → 点击左下角「技能中心」→ 在搜索框输入目标技能名称(如“飞书日报生成”)→ 点击技能卡片右上角「⋯」→ 选择「查看依赖」。这里会列出该技能明确要求的三项内容:必需的本地软件(如飞书桌面版v7.10+)、系统级权限(如辅助功能/屏幕录制权限)、运行时组件(如node v18.17+、python3.10+)。
注意:部分社区技能不提供依赖清单,这类技能需手动查阅其GitHub仓库README.md中的「Prerequisites」章节,否则极大概率执行失败。
验证本地软件是否可用
方法一:通过AionClaw内置检测工具
在客户端顶部菜单栏点击「设置」→「系统诊断」→「工具连通性测试」→ 勾选待验证的软件(如Excel、飞书、Chrome),点击「立即检测」。工具会尝试调用对应程序的命令行接口并返回响应码;若显示「Exit Code: 0」且输出含版本号,则表示可调用。
方法二:手动终端验证(Windows/macOS通用)
打开系统终端(CMD/PowerShell/Terminal),逐条执行以下命令:
where excel(Windows)或 which open -a "Microsoft Excel"(macOS)→ 检查Excel是否在PATH中;
ls /Applications/Feishu.app(macOS)或 dir "C:\Program Files\Feishu"(Windows)→ 确认飞书安装路径存在;
【关键前提】必须保证飞书已登录且主窗口至少启动过一次,否则AionClaw无法注入消息通道。
检查系统权限与运行时组件
第一步:确认辅助功能权限已开启
Windows:设置 → 蓝牙和其他设备 → 相机、麦克风、辅助功能 → 开启「允许应用控制你的设备」;
macOS:系统设置 → 隐私与安全性 → 辅助功能 → 勾选AionClaw.app。
第二步:验证Python与Node版本
在终端中运行 python --version 和 node --version;若提示“command not found”,说明未安装或未加入PATH;此时不能直接装最新版——AionClaw仅兼容Python 3.9~3.11、Node 16.14~18.20,装错版本会导致技能加载后立即崩溃。
第三步:检查模型接入状态
即使技能本身不调大模型,多数自动化流程仍需TaoToken作为统一调度中枢;进入「设置」→「模型服务」→ 查看「当前连接状态」是否为绿色「已就绪」;若为黄色「待配置」,则需补全TaoToken Base URL(https://taotoken.net/api)、API Key与Model ID,缺一不可。











