OpenClaw调试模式可通过四种方式启用：一、命令行加--debug参数；二、修改config.yaml中logging.level为debug；三、设置环境变量OPENCLAW_DEBUG=1；四、HTTP服务下调用/api/v1/debug/enable端点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在OpenClaw中启用调试模式以查看详细日志、定位运行异常或验证模块行为，则需通过特定配置方式激活其内置调试功能。以下是开启并使用OpenClaw调试模式的多种方法：
一、通过命令行参数启用调试模式
OpenClaw支持在启动时直接传入调试标志，从而激活日志级别提升与内部状态输出功能。该方式无需修改配置文件，适用于临时调试场景。
1、打开终端或命令提示符，进入OpenClaw可执行文件所在目录。
2、输入以下命令启动程序：./openclaw --debug（Linux/macOS）或 openclaw.exe --debug（Windows）。
3、观察控制台输出，确认出现包含 [DEBUG] 前缀的日志行，表明调试模式已生效。
二、修改config.yaml配置文件启用调试
OpenClaw默认读取根目录下的config.yaml文件，其中可通过设置日志等级触发调试模式。该方式持久有效，适合长期开发环境使用。
1、使用文本编辑器打开OpenClaw安装目录中的 config.yaml 文件。
2、查找 logging: 区块，若不存在则在文件末尾新增该区块。
3、在 logging: 下添加或修改字段：level: debug，确保缩进为两个空格。
4、保存文件并重启OpenClaw进程，日志文件（如logs/openclaw.log）将开始记录调试级信息。
三、设置环境变量强制启用调试
OpenClaw在初始化阶段会检查特定环境变量，若检测到对应变量存在且值为真，则自动启用调试模式。该方式优先级高于配置文件，适用于容器或CI/CD环境。
1、在启动OpenClaw前，执行环境变量设置命令：export OPENCLAW_DEBUG=1（Linux/macOS）。
2、Windows系统中使用：set OPENCLAW_DEBUG=1（CMD）或 $env:OPENCLAW_DEBUG="1"（PowerShell）。
3、随后运行OpenClaw主程序，无需额外参数，控制台将立即输出调试日志。
四、通过API端点动态启用调试（仅限HTTP服务模式）
当OpenClaw以HTTP服务模式运行时，可通过发送特定HTTP请求动态切换调试状态，无需重启进程。该方式适用于已部署环境中快速启停调试输出。
1、确保OpenClaw已启用HTTP管理接口（默认监听端口为8080）。
2、使用curl工具发送POST请求：curl -X POST http://localhost:8080/api/v1/debug/enable。
3、收到HTTP 200响应后，检查日志流或调用 curl http://localhost:8080/api/v1/debug/status 确认当前状态为 enabled。
