doctor

openclaw doctor 是一个帮你检查和修复程序问题的小工具。你可以把它想成是玩具的“体检医生”，它会看看程序的各个部分（比如网关和频道）是不是工作正常。

怎么使用这个小医生呢？ 很简单，你只需要在电脑的终端（一个可以打字给电脑下命令的窗口）里，输入下面这些“咒语”：

1. 做个快速检查：输入 openclaw doctor。这就像医生用听诊器听听心跳，看看表面有没有问题。
2. 检查并尝试修理：输入 openclaw doctor --repair。这个命令会让医生不仅检查，还会试着修好它发现的小毛病。你也可以写成 openclaw doctor --fix，意思是一样的。
3. 做个深度大检查：输入 openclaw doctor --deep。这就像医生给你拍个X光片，检查得更仔细、更深入。

使用的时候要注意几件重要的事情哦：

• 这个小医生很聪明，有些修理需要你点头同意。它只会在你能直接和它对话（比如直接在终端里运行）的时候问你问题。如果你让电脑自己偷偷运行它（比如用cron计划任务），它就不会提问，直接跳过那些需要你同意的修理步骤。
• 当医生使用 --repair 或 --fix 来修理时，它会非常小心。修理前，它会先把你的旧设置文件复制一份，存为 ~/.openclaw/openclaw.json.bak，这样万一修坏了，我们还能找回来。修理时，它可能会扔掉一些它不认识的设置，并且会告诉你它扔掉了什么。
• 医生还会帮你检查有没有“孤儿文件”。这就像看看你的玩具箱里，有没有一些找不到主人的小零件（比如会话产生的临时文件），如果有，医生可以把它们安全地收拾到一边（加上 .deleted.<时间戳> 的名字），这样就能腾出更多空间。
• 如果医生发现你缺少一些重要的“钥匙”（比如嵌入模型的凭证），它会建议你去运行另一个命令 openclaw configure --section model 来配好。
• 如果你的玩具设置了要在“沙箱”（一个隔离的安全小房子）里玩，但电脑里没有安装 Docker（沙箱的建造工具），医生会大声提醒你，并告诉你怎么做：要么安装 Docker，要么去关掉沙箱模式（用命令 openclaw config set agents.defaults.sandbox.mode off）。

特别给用苹果电脑（macOS）的小朋友： 如果你以前用过 launchctl setenv 这样的命令设置过环境变量（比如 OPENCLAW_GATEWAY_TOKEN），这就像你给玩具贴了一个永久标签，这个标签会盖过玩具自己的设置，可能导致一直出现“没有权限”的错误。 想知道有没有这样的标签，可以输入： launchctl getenv OPENCLAW_GATEWAY_TOKEN launchctl getenv OPENCLAW_GATEWAY_PASSWORD 如果想撕掉这些标签，让玩具用自己的设置，就输入： launchctl unsetenv OPENCLAW_GATEWAY_TOKEN launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD