AionClaw计划异常时需人工干预:检查plan.yaml中active: true、验证aionctl plan list --verbose状态、修复YAML语法及字段兼容性(如max_retry→retry_limit),强制重载后确认日志触发记录;支持throttle降频、disable熔断、override参数覆盖;重建计划须先export再remove最后import,确保GPU内存等资源显式声明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当AionClaw执行计划不合理导致任务卡顿、响应延迟或技能调用失败时,需立即干预调整,不能依赖默认调度逻辑硬扛——它不会自动重平衡资源分配,也不会识别你本地GPU显存已满却还在排队启动第7个Agent。
确认当前执行计划是否被实际加载
打开AionClaw安装目录下的config/plan.yaml,用文本编辑器查看最后一行是否为active: true。若为active: false或该字段缺失,所有计划将被跳过,此时无论你怎么修改参数都无效。
终端中执行aionctl plan list --verbose,观察输出中status列是否全为loaded。若出现parse_failed或schema_mismatch,说明YAML语法有误或字段名与v2026.9.6+新版协议不兼容——旧版写的max_retry在新版本中必须改为retry_limit,否则整条计划静默失效。
强制重载并验证计划生效路径
执行aionctl plan reload --force,等待返回✅ Reloaded 3 plans, 0 skipped。注意:若返回skipped数量大于0,说明对应计划文件存在命名冲突(如同时存在daily.yml和daily.yaml),系统只加载字典序靠前的那个,后缀不同也会被当作两个文件处理。
立刻执行aionctl log tail -n 20 | grep "plan.trigger",确认日志中出现带时间戳的触发记录,格式类似[2026-10-13T11:22:04] plan.trigger: 'backup_db' → scheduled @ 2026-10-13T11:30:00。没有这条日志,代表计划虽加载成功但未进入调度队列——常见原因是trigger.cron里写了0 0 * * *却没启用系统级cron服务,或Windows下未勾选“以最高权限运行计划任务”。
动态调整正在运行的计划节奏
方法一:临时降频
执行aionctl plan throttle backup_db --delay 300,将backup_db计划下次触发延后5分钟。这不会取消已排队任务,只影响后续周期——适合应对突发高负载,比如你刚启动了3个视频转码Agent,再让数据库备份挤进来必然OOM。
方法二:熔断单个计划
执行aionctl plan disable notify_slack,立即终止notify_slack计划的所有待执行实例和后台监听。该操作不可逆,重启AionClaw后仍保持禁用状态,除非手动enable。⚠️注意:【disable后不会自动清理已生成的临时文件】,若该计划曾写入/tmp/aion_notify_*.log,需手动清空,否则下次enable时可能因磁盘满直接崩溃。
方法三:替换运行时参数
不改YAML文件,直接覆盖关键值:执行aionctl plan override fetch_news --param max_items=10 --param timeout_sec=45。这次覆盖只对下一次执行生效,不影响配置文件,适合调试阶段快速试错。但注意,override仅支持标量类型(string/number/bool),不能传嵌套对象或数组。
重建计划避免累积偏差
第一步:导出当前生效计划aionctl plan export backup_db > backup_db.current.yaml,保存原始结构,防止重写时漏掉dependencies等隐藏依赖字段。
第二步:删除原计划aionctl plan remove backup_db。这一步会清除调度器内存中的全部上下文,包括上次执行耗时、失败计数、退避指数——别跳过,否则新计划仍按旧失败策略指数退避。
第三步:注入修正后计划aionctl plan import backup_db.fixed.yaml,确保文件里schedule字段已从every 1h改为cron: "0 */2 * * *"(每两小时整点执行),且resources节明确声明gpu_memory_mb: 2048而非留空。AionClaw v2026.9.6起,未声明GPU内存限制的计划默认抢占全部显存,极易与其他Agent冲突。


















