跳转至

FAQ

真实场景（本地开发、VPS、多智能体、OAuth/API 密钥、模型故障转移）的快速解答与更深入的故障排查。运行时诊断，请参阅 故障排查。完整配置参考，请参阅 配置。

本页是索引。日常 FAQ 分为十三个页面，每个主题一页。排查阶梯保留在本页；请打开与您问题匹配的页面。

页面 何时阅读
什么是 OpenClaw？ 您正在评估 OpenClaw，或需要解释它是什么以及由谁资助。
技能与自动化 您正在自定义技能，或者 cron 任务、提醒或子智能体出现异常。
沙箱与内存 您正在调整沙箱，或内存无法持久化。
磁盘上的文件位置 您需要查找、备份、移动或删除 OpenClaw 数据。
配置基础 您正在编辑配置、启用网络搜索，或从 config.apply 中恢复。
远程网关与节点 您在 VPS 或其他机器上运行 Gateway，或要添加节点。
环境变量与 .env 加载 您通过环境变量或 .env 设置密钥，或服务丢失了密钥。
会话与多聊天 您正在管理会话、重置、上下文限制、群组或多个机器人。
网关端口、已在运行与远程模式 网关无法绑定端口、提示已在运行，或您想要远程模式。
日志与调试 您需要日志或重启服务，或回复始终未到达。
媒体与附件 某个技能生成了图片或 PDF，但没有发送任何内容。
安全与访问控制 您正在将 OpenClaw 暴露给入站消息，或评估插件风险。
聊天命令、中止任务与停止运行 任务无法停止，或您正在调整斜杠命令与队列。

如果出了问题：前 60 秒

1. 快速状态

openclaw status
快速本地摘要：操作系统 + 更新、Gateway/服务可达性、智能体/会话、提供商配置 + 运行时问题（当 Gateway 可达时）。

2. 可粘贴的报告（可安全分享）

openclaw status --all
只读诊断，附带日志尾部（令牌已遮蔽）。

3. 守护进程 + 端口状态

openclaw gateway status
显示监督者运行时与 RPC 可达性的对比、探测目标 URL，以及服务可能使用的配置。

4. 深度探测

openclaw status --deep
实时 Gateway 健康探测，包括受支持时的通道探测（需要可达的 Gateway）。请参阅 Health。

5. 查看最新日志尾部

openclaw logs --follow
如果 RPC 不可用，请回退到： 
tail -f "/tmp/openclaw/openclaw-$(date +%F).log"
# Named profile example:
tail -f "/tmp/openclaw/openclaw-dev-$(date +%F).log"
文件日志独立于服务日志；请参阅 日志 和 故障排查。

6. 运行 doctor（修复）

openclaw doctor
修复/迁移配置与状态，然后运行健康检查。请参阅 Doctor。

7. Gateway 快照（仅 WS）

openclaw health --json
openclaw health --verbose   # 出错时显示目标 URL + 配置路径
向正在运行的 Gateway 请求完整快照。请参阅 Health。

快速入门与首次运行设置

首次运行问答——安装、上手、认证路由、订阅、初始故障——请参阅 首次运行 FAQ。

模型、故障转移与认证配置文件

模型问答——默认值、选择、别名、切换、故障转移、认证配置文件——请参阅 模型 FAQ。

杂项

使用 API 密钥时，Anthropic 的默认模型是什么？

凭证与模型选择是分开的。设置 ANTHROPIC_API_KEY（或在认证配置文件中存储 Anthropic API 密钥）会启用认证，但实际的默认模型是您在 agents.defaults.model.primary 中配置的内容（例如 anthropic/claude-sonnet-4-6 或 anthropic/claude-opus-4-6）。No credentials found for profile "anthropic:default" 表示 Gateway 在运行智能体可用的 SQLite 认证存储中找不到 Anthropic 凭证。

仍然卡住？请在 Discord 中提问，或使用 GitHub issue 选择器。

各章节迁移到了哪里

旧版单页版本中的每个问题标题都在此处保留其锚点，因此现有链接（如 /help/faq#where-things-live-on-disk）仍然有效。每个条目都指向当前包含答案的页面。

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