5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
---
|
||
read_when:
|
||
- 遇到连接/认证问题并需要引导修复
|
||
- 更新后想要进行安装完整性检查
|
||
summary: "`openclaw doctor` 的 CLI 参考（健康检查 + 引导修复）"
|
||
title: doctor
|
||
x-i18n:
|
||
generated_at: "2026-02-01T19:58:59Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 92310aa3f3d111e91a74ce1150359d5d8a8d70a856666d9419e16c60d78209f2
|
||
source_path: cli/doctor.md
|
||
workflow: 14
|
||
---
|
||
|
||
# `openclaw doctor`
|
||
|
||
Gateway网关和渠道的健康检查 + 快速修复。
|
||
|
||
相关内容：
|
||
|
||
- 故障排除：[故障排除](/gateway/troubleshooting)
|
||
- 安全审计：[安全](/gateway/security)
|
||
|
||
## 示例
|
||
|
||
```bash
|
||
openclaw doctor
|
||
openclaw doctor --repair
|
||
openclaw doctor --deep
|
||
```
|
||
|
||
备注：
|
||
|
||
- 交互式提示（如钥匙串/OAuth 修复）仅在 stdin 为 TTY 且**未**设置 `--non-interactive` 时运行。无头运行（cron、Telegram、无终端）将跳过提示。
|
||
- `--fix`（`--repair` 的别名）会将备份写入 `~/.openclaw/openclaw.json.bak`，并删除未知的配置键，同时列出每个删除项。
|
||
|
||
## macOS：`launchctl` 环境变量覆盖
|
||
|
||
如果你之前运行过 `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...`（或 `...PASSWORD`），该值会覆盖你的配置文件，并可能导致持续的"未授权"错误。
|
||
|
||
```bash
|
||
launchctl getenv OPENCLAW_GATEWAY_TOKEN
|
||
launchctl getenv OPENCLAW_GATEWAY_PASSWORD
|
||
|
||
launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
|
||
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD
|
||
```
|