需升级至aionclaw v2.3.0+并启用config/logging.yaml中handlers.file.enabled为true、path设为logs/backend.log，再通过backend_log_level=debug启动或修改loggers.backend.level为debug，配合tail -f logs/backend.log实时查看后端debug日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在AionClaw中让后端服务（如API网关、任务调度器、工具执行引擎）输出可追踪、可定位问题的详细运行日志，但默认启动后只看到少量控制台输出，logs/目录下也没有结构化日志文件。
确认AionClaw日志配置生效路径
进入AionClaw安装目录，执行ls -d config/确认配置目录存在；再运行ls config/settings.yaml config/logging.yaml，优先检查logging.yaml是否存在——这是AionClaw 2026.8+版本起接管日志行为的核心配置文件，【若该文件不存在，说明你使用的是旧版AionClaw，需先升级到v2.3.0或更高】。
打开config/logging.yaml，确认handlers.file.enabled值为true，且handlers.file.path指向logs/backend.log（而非默认的openclaw.log）。
启用后端专属DEBUG级别日志
方法一：启动时注入环境变量（推荐，即时生效）
在终端中进入AionClaw根目录，执行：
BACKEND_LOG_LEVEL=DEBUG ./aionclaw --no-gui
这会强制后端模块（包括task-scheduler、tool-runner、api-gateway）将INFO及以上日志全部输出到控制台，并同步写入logs/backend.log。
方法二：修改config/logging.yaml中loggers.backend.level字段
将原值INFO改为DEBUG，保存后重启服务。注意：此方式必须完整重启AionClaw进程，仅重载配置无效。
实时捕获并验证后端日志流
第一步：新开一个终端窗口，cd进入AionClaw安装目录
第二步：执行mkdir -p logs && touch logs/backend.log
第三步：运行tail -f logs/backend.log
第四步：在另一个终端中启动AionClaw后端服务（如上文方法一命令）
此时第一个终端将立即滚动显示类似[backend][task-scheduler] Loaded 12 cron jobs from user_tasks.json、[backend][tool-runner] Executing 'excel_summarize' with args: {'path': '/Users/xxx/report.xlsx'}等原始执行痕迹。【若tail命令报No such file or directory，请等待3秒再执行，因日志文件由后端模块首次写入时创建】
