日志与调试

日志与调试¶

日志在哪里？

文件日志（结构化）：默认配置文件为 /tmp/openclaw/openclaw-YYYY-MM-DD.log，命名配置文件为 /tmp/openclaw/openclaw-<profile>-YYYY-MM-DD.log。可通过 logging.file 设置固定路径；logging.level 设置文件日志级别；--verbose 和 logging.consoleLevel 控制控制台输出详细程度。

最快的日志跟踪方式：

openclaw logs --follow

服务/守护进程日志（当网关通过 launchd/systemd 运行时）：

macOS launchd 标准输出和标准错误：~/Library/Logs/openclaw/gateway.log（配置文件使用 gateway-<profile>.log；两个流共享此文件，因此日志记录器启动前发生的启动失败也会记录在此）。
Linux：journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager。
Windows：schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST。

更多信息请参阅故障排除。

如何启动/停止/重启 Gateway 服务？

openclaw gateway status
openclaw gateway restart

如果你手动运行 Gateway，openclaw gateway --force 可以重新占用端口。参见Gateway。

我在 Windows 上关闭了终端——如何重新启动 OpenClaw？

Windows 有三种安装模式：

1) Windows Hub 本地设置：原生应用管理一个由应用拥有的本地 WSL Gateway。从开始菜单或系统托盘打开 OpenClaw Companion，然后使用 Gateway Setup 或 Connections 标签页。

2) 手动 WSL2 Gateway：Gateway 在 Linux 内运行。

wsl
openclaw gateway status
openclaw gateway restart

如果你从未安装该服务，可从前台启动它：openclaw gateway run。

3) 原生 Windows CLI/Gateway：直接在 Windows 中运行。

openclaw gateway status
openclaw gateway restart

如果你手动运行（无服务）：openclaw gateway run。

文档：Windows、Gateway 服务手册。

Gateway 已启动但没有回复到达。我应该检查什么？

快速健康检查：

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

常见原因：模型认证未在 gateway 主机 上加载（检查 models status）；频道配对/允许列表阻止了回复（检查频道配置和日志）；或 WebChat/Dashboard 未使用正确的 token 打开。如果是远程环境，请确认隧道/Tailscale 连接正常，且 Gateway WebSocket 可访问。

文档：Channels、故障排除、远程访问。

“Disconnected from gateway: no reason”——接下来怎么办？

通常意味着 UI 失去了 WebSocket 连接。检查：Gateway 是否在运行（openclaw gateway status）？是否健康（openclaw status）？UI 是否具有正确的 token（openclaw dashbboard）？如果是远程，隧道/Tailscale 链路是否正常？

然后跟踪日志：

openclaw logs --follow

文档：仪表盘、远程访问、故障排除。

Telegram 的 setMyCommands 失败。我应该检查什么？

openclaw channels status
openclaw channels logs --channel telegram

然后匹配错误：

BOT_COMMANDS_TOO_MUCH：Telegram 菜单中的条目过多。OpenClaw 已将其裁剪到 Telegram 限制并重试使用较少的命令，但仍可能丢弃某些菜单条目。减少插件/技能/自定义命令，或者如果你不需要菜单，请禁用 channels.telegram.commands.native。
TypeError: fetch failed、Network request for 'setMyCommands' failed! 或类似的网络错误：在 VPS 上或代理后面，请确认允许出站 HTTPS，并且 DNS 可解析 api.telegram.org。

如果 Gateway 是远程的，请在 Gateway 主机上检查日志。

文档：Telegram、频道故障排除。

TUI 没有显示输出。我应该检查什么？

openclaw status
openclaw models status
openclaw logs --follow

在 TUI 中，使用 /status 查看当前状态。如果你期望在聊天频道中收到回复，请确认投递已启用（/deliver on）。

文档：TUI、斜杠命令。

如何彻底停止然后再启动 Gateway？

如果你安装了该服务（macOS 上的 launchd、Linux 上的 systemd）：

openclaw gateway stop
openclaw gateway start

在前台运行时，按 Ctrl-C 停止，然后运行 openclaw gateway run。

文档：Gateway 服务手册。

ELI5：openclaw gateway restart 与 openclaw gateway 的区别

openclaw gateway restart 重新启动后台服务（launchd/systemd）。openclaw gateway 在此终端会话中在前台运行网关。如果你已安装服务，请使用 gateway 子命令；如果是临时使用，请使用不带子命令的前台运行方式。

遇到故障时获取更多详细信息的最快方法

使用 --verbose 启动 Gateway 以获取更多控制台详细信息，然后检查日志文件中的频道认证、模型路由和 RPC 错误。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw