跳转至

FAQ

面向真实使用场景(本地开发、VPS、多 agent、OAuth/API 密钥、模型故障转移)的快速解答与更深层的故障排查。运行时诊断请参阅 故障排查。完整配置参考请参阅 配置参考。

本页是一个索引。日常 FAQ 按主题拆分为十三个页面,每个主题一页。问题排查路径仍保留在本页;请打开与你的问题匹配的页面。

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

出问题后的头 60 秒

1. 快速状态

openclaw status
快速本地概要:OS + 更新、Gateway/服务可达性、agents/sessions、provider 配置 + 运行时问题(当 Gateway 可达时)。

2. 可粘贴的报告(可安全分享)

openclaw status --all
只读诊断,附带日志末尾(tokens 已隐去)。

3. 守护进程(daemon)+ 端口状态

openclaw gateway status
显示 supervisor 运行时与 RPC 可达性、检查目标 URL,以及服务可能使用的配置。

4. 深度检查

openclaw status --deep
实时 Gateway 健康检查,支持时还会包含渠道检查(需要 Gateway 可达)。参见 健康检查。

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   # shows the target URL + config path on errors
向正在运行的 Gateway 请求完整快照。参见 健康检查。

快速开始与首次运行设置

首次运行问答——安装、引导、认证路径、订阅、初始失败——请见 首次运行 FAQ。

模型、故障转移与认证配置(auth profiles)

模型问答——默认值、选择、别名、切换、故障转移、认证配置(auth profiles)——请见 模型 FAQ。

杂项

使用 API key 时,Anthropic 的默认模型是什么?

凭据与模型选择是分开的。设置 ANTHROPIC_API_KEY(或在 auth profiles 中存储 Anthropic API key)可启用认证,但实际的默认模型由你在 agents.defaults.model.primary 中配置的内容决定(例如 anthropic/claude-sonnet-4-6 或 anthropic/claude-opus-4-6)。No credentials found for profile "anthropic:default" 表示 Gateway 在运行中的 agent 可用的 SQLite auth 存储中找不到 Anthropic 凭据。


仍然卡住了?请在 Discord 中提问,或使用 GitHub issue 选择器。

各章节迁移到了哪里

旧版单页版本中的每个问题标题都在这里保留了锚点,因此像 /help/faq#where-things-live-on-disk 这样的既有链接仍能正常解析。每个条目都指向当前包含该答案的页面。

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