openclaw默认不实时显示工具调用日志,需启动时加--debug参数才能记录详细信息;日志存于logs/目录下,按时间戳命名;每条记录含时间戳、工具名、输入参数(json)、返回摘要(长度或异常)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw运行时工具调用日志默认不实时显示,需主动启用调试模式并定位日志输出路径才能查看具体执行了哪些工具、传入参数是否正确、返回结果是否异常。
启动OpenClaw时开启调试日志
在终端中进入OpenClaw项目根目录,执行命令:python main.py --debug。该参数会触发日志级别提升,使工具调用过程被记录到文件而非仅控制台输出。
若跳过此步直接运行,默认只输出简略状态信息,【工具调用细节将完全丢失】,后续无法排查参数错误或超时问题。
查找日志文件位置
日志默认写入 logs/ 子目录,文件名形如 tool_calls_20241105_142301.log(含日期与启动时间戳)。
注意:每次重新启动OpenClaw都会生成新日志文件,旧文件不会自动覆盖或合并。若需持续追踪,建议启动前先清空logs目录避免混淆。
OpenClaw专家 — 用于任何OpenClaw问题或需求,包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
使用命令 ls -t logs/ | head -n 1 可快速定位最新日志文件。
解析日志中的关键字段
打开日志文件后,每条工具调用记录包含四段核心内容:
① 时间戳(精确到毫秒)→ ② 工具名称(如 web_search 或 file_reader)→ ③ 输入参数(JSON格式,注意检查是否含敏感信息未脱敏)→ ④ 返回摘要(成功时为结果长度,失败时为异常类型和消息)。
例如:[15:22:38.412] tool=web_search input={"query":"Python list comprehension"} → output_len=2473。这表示调用成功且返回约2.4KB文本。
若看到 exception=TimeoutError 或 status=failed,说明该工具执行中断,需检查网络、API密钥或输入合法性。









