4.5 doctor命令

CLI命令行CLI命令行

openclaw doctor 命令用于对网关和渠道基础设施执行健康检查和快速修复。

命令概述

该命令帮助您诊断和修复 OpenClaw 环境中的常见问题。它可以检查网关连接、渠道配置和其他关键组件的状态。

可用命令

# 运行标准健康检查
openclaw doctor

# 执行修复并备份配置
openclaw doctor --repair

# 执行全面诊断
openclaw doctor --deep

命令选项说明

  • 标准检查：运行基本的健康检查，报告问题但不进行修改
  • --repair：尝试自动修复发现的问题，并在修复前备份配置
  • --deep：执行更全面的诊断，检查更多潜在问题

行为说明

交互式修复（如钥匙串访问、OAuth 授权）仅在终端已连接且未指定 --non-interactive 时才会激活。在自动化环境（如 cron 任务）中，会完全跳过提示。

--repair 参数会在 ~/.openclaw/openclaw.json.bak 创建备份，并删除无法识别的配置键，同时报告每次删除操作。

macOS 特定问题：launchctl 覆盖

之前通过 launchctl setenv 设置的 OPENCLAW_GATEWAY_TOKEN 或 OPENCLAW_GATEWAY_PASSWORD 环境变量可能会持续存在，并覆盖配置文件中的设置，导致认证失败。

解决步骤
  1. 检查当前值：launchctl getenv OPENCLAW_GATEWAY_TOKEN
  2. 清除覆盖：launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
  3. 对 OPENCLAW_GATEWAY_PASSWORD 重复上述步骤

相关资源

提示
在遇到连接或认证问题时，首先运行 openclaw doctor 是一个很好的起点。