openclaw 默认不输出控制台日志，错误写入本地 logs/ 目录：error.log（error 级异常）、agent.log（智能体调度）、gateway.log（接口问题）；云部署通过平台日志中心查看；可设 log_level=debug 启用调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 默认不将运行日志直接输出到控制台，错误信息通常写入本地日志文件，需按部署方式定位对应路径。
查看 OpenClaw 本地部署的日志文件
若你通过源码或 CLI 方式在本地运行 OpenClaw（如使用 npm start 或 python main.py），日志默认保存在项目根目录下的 logs/ 子目录中：
- error.log：记录所有 ERROR 级别异常，含堆栈、时间戳和触发模块（如 Gateway 或 Skill 执行失败）
- agent.log：聚焦智能体调度行为，包括任务分发、Memory 写入失败、Skill 调用超时等
- gateway.log：用于排查 WhatsApp/Slack 接口连接中断、Webhook 验证失败、消息解析异常等问题
建议用命令实时跟踪（以 Linux/macOS 为例）：
tail -f logs/error.log
云服务部署（阿里云/腾讯云等）的日志入口
各云厂商提供的 OpenClaw 一键部署服务已集成日志中心，无需手动找文件：
- 登录对应云平台控制台 → 进入「OpenClaw 实例」→ 点击「监控与日志」→ 选择「运行日志」或「系统日志」标签页
- 支持按时间范围筛选、关键词搜索（如输入 "PermissionDenied" 或 "Memory load failed"）
- 错误行通常带 [ERR] 前缀，并附带关联的 Skill 名称（如 skill_email_fetcher）或 Agent ID
启用调试模式获取更详细日志
若默认日志信息不足，可临时开启 DEBUG 级别输出：
- 本地部署：启动时加环境变量 LOG_LEVEL=debug（例如 LOG_LEVEL=debug npm start）
- 云部署：在实例配置页找到「高级设置」→ 开启「详细日志」开关 → 重启服务生效
- 注意：DEBUG 模式会显著增加日志体积，排查完毕后建议关闭
常见错误日志特征与初步判断
看到以下内容可快速定位方向：
- "Failed to access ~/.openclaw/config.yaml: Permission denied" → 系统权限不足，检查当前用户对配置目录的读写权限
- "Skill 'web_search' returned empty result after 3 retries" → 技能依赖的外部 API（如搜索引擎接口）不可达或配额耗尽
- "Memory store init failed: database is locked" → 多进程冲突或 SQLite 文件被其他进程占用
- "Gateway webhook verification failed for Slack" → Slack App 的 Signing Secret 配置错误或过期
