OpenClaw日志默认输出至当前工作目录下的logs/openclaw.log；启用DEBUG级别日志需添加--log-level DEBUG参数或修改config.yaml中logging.level为DEBUG并启用file_handler，再通过tail -f实时追踪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地运行OpenClaw时实时掌握模型加载、推理、错误中断等关键过程，但找不到日志输出位置或日志被静默丢弃。
确认OpenClaw日志默认输出路径
OpenClaw启动后，默认将运行日志写入logs/子目录下的openclaw.log文件，该路径相对于你执行python main.py的当前工作目录。如果目录不存在，程序会自动创建，但不会创建父级嵌套路径——比如你在/tmp下运行却把配置指向/home/user/project/logs，日志就不会落地。
执行命令前先检查当前目录：pwd，再确认logs/是否存在：ls -d logs/。
启动时强制启用详细日志输出
方法一：添加--log-level DEBUG参数启动
这会把LLM调用、工具执行、状态切换等全部细节打印到控制台，并同步写入logs/openclaw.log。不加这个参数时，默认只输出WARNING及以上级别日志，大量调试信息会被过滤掉。
方法二：修改config.yaml中的日志配置段
【必须重启服务才生效】找到logging:区块，把level:从INFO改为DEBUG，同时确保file_handler:下的enabled:为true。
实时追踪日志流
第一步：打开终端，进入OpenClaw项目根目录
完整的工作区安全套件：检测未授权修改，扫描提示注入模式，自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
第二步：执行tail -f logs/openclaw.log
第三步：另起一个终端窗口，运行python main.py --log-level DEBUG
此时第一个终端会立即滚动显示模型加载进度、tokenizer初始化耗时、首次推理耗时等原始数据。注意：如果tail命令报No such file or directory，说明日志还没生成——等几秒再试，或检查是否因权限问题无法写入logs/目录。
这一步操作起来很简单，直接把文件拖进去就行。
排查日志未生成的常见原因
检查Python进程是否真的在运行：ps aux | grep openclaw，若无输出，说明服务根本没起来，日志自然为空。
查看logs/目录权限：ls -ld logs/，如果显示drw-r--r--（缺少w），则需执行chmod u+w logs/。
确认磁盘空间是否充足：df -h .，日志写入失败时OpenClaw通常不会报错，只会静默跳过。
【最关键前提】确保main.py中未手动禁用日志模块——某些调试分支代码里会插入logging.disable(logging.CRITICAL)，这会让所有日志彻底消失。
