日志记录和调试

文件日志（结构化）：默认配置文件为 /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

Service/supervisor日志（当网关通过launchd/systemd运行时）：

• macOS launchd stdout 和 stderr：~/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.

更多内容参见 故障排除。

openclaw gateway statusopenclaw gateway restart

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

三种 Windows 安装模式：

1） Windows 集线器本地设置：本机应用程序管理本地应用程序拥有的 WSL 网关。从“开始”菜单或托盘中打开 OpenClaw Companion，然后使用 Gateway Setup 或“连接”选项卡。

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

wslopenclaw gateway statusopenclaw gateway restart

如果你从未安装过服务，请在前台启动：openclaw gateway run。

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

openclaw gateway statusopenclaw gateway restart

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

文档：Windows、Gateway 服务运行手册。

快速健康检查：

openclaw statusopenclaw models statusopenclaw channels statusopenclaw logs --follow

常见原因：网关主机上未加载模型身份验证（检查models status）、通道pairing/allowlist阻止回复（检查通道配置和日志）或WebChat/Dashboard在没有正确令牌的情况下打开。如果是远程，请确认 tunnel/Tailscale 连接已建立并且网关 WebSocket 可达。

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

通常意味着 UI 丢失了 WebSocket 连接。检查：网关是否正在运行（openclaw gateway status）？健康吗（openclaw status）？ UI 是否具有正确的令牌 （openclaw dashboard）？如果是远程，tunnel/Tailscale 是否已链接？

然后尾随日志：

openclaw logs --follow

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

openclaw channels statusopenclaw channels logs --channel telegram

然后匹配错误：

• BOT_COMMANDS_TOO_MUCH：Telegram 菜单条目过多。 OpenClaw 已调整至 Telegram 限制并使用更少的命令重试，但某些菜单项可能仍会被删除。减少 plugin/skill/custom 命令，或者如果不需要菜单则禁用 channels.telegram.commands.native。
• TypeError: fetch failed、Network request for 'setMyCommands' failed!，或类似的网络错误：在 VPS 上或代理之后，请确认允许外发 HTTPS，并且 api.telegram.org 的 DNS 正常工作。

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

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

openclaw statusopenclaw models statusopenclaw logs --follow

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

文档：TUI、斜杠命令。

如果您安装了该服务（launchd 位于 macOS 上，systemd 位于 Linux 上）：

openclaw gateway stopopenclaw gateway start

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

文档：Gateway 服务运行手册。

openclaw gateway restart 重新启动 后台服务 （launchd/systemd）。 openclaw gateway 在该终端会话的前台 中运行网关。如果您安装了该服务，请使用 gateway 子命令；一次性使用裸露的前台运行。

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