本页内容

本页内容

FAQ

FAQ

针对真实环境部署的快速回答和更深入的故障排查(本地开发、VPS、多智能体、OAuth/API 密钥、模型故障切换)。运行时诊断请参见 故障排查。完整配置参考请参见 配置。

此页是一个索引。日常 FAQ 分为十三页,每个主题一页。分诊阶梯保留在该页面上;打开与您的问题相符的页面。

页面 读它的时候
什么是OpenClaw? 您正在评估 OpenClaw,或解释它是什么以及谁资助它。
技能与自动化 您正在自定义技能,或者 cron 作业、提醒或子代理行为不当。
沙箱和内存 您正在调整沙箱,或者内存不持久。
磁盘上的内容 您需要查找、备份、移动或删除 OpenClaw 数据。
配置基础 您正在编辑配置、启用网络搜索或从 config.apply 恢复。
远程网关和节点 您在 VPS 或其他计算机上运行网关,或者您正在添加节点。
Env 变量和 .env 加载 您正在通过 env 或 .env 设置密钥,或者服务丢失它们。
会话和多个聊天 您正在管理会话、重置、上下文限制、组或多个机器人。
网关端口,已运行,远程模式 网关不会绑定,表示它已经在运行,或者您需要远程模式。
记录和调试 您需要记录日志或重新启动服务,否则永远不会收到回复。
媒体和附件 技能生成了图像或 PDF,但没有发送任何内容。
安全和访问控制 您正在将 OpenClaw 暴露给入站消息或判断插件风险。
聊天命令、中止任务和停止运行 任务不会停止,或者您正在调整斜杠命令和队列。

出问题后的前 60 秒

  • 快速状态

    bash
    openclaw status

    快速本地摘要:OS + 更新、Gateway/service 可访问性、agents/sessions、提供程序配置 + 运行时问题(当网关可访问时)。

  • 可粘贴的报告(安全共享)

    bash
    openclaw status --all

    只读诊断,附带日志尾部(令牌已脱敏)。

  • 守护进程+端口状态

    bash
    openclaw gateway status

    显示主管运行时与 RPC 可访问性、检查目标 URL 以及服务可能使用的配置。

  • 深度检查

    bash
    openclaw status --deep

    实时网关运行状况检查,包括支持时的通道检查(需要可访问的网关)。请参阅 Health。

  • 跟踪最新日志

    bash
    openclaw logs --follow

    如果 RPC 挂了,可改用:

    bash
    tail -f "/tmp/openclaw/openclaw-$(date +%F).log"# Named profile example:tail -f "/tmp/openclaw/openclaw-dev-$(date +%F).log"

    文件日志与服务日志是分开的;参见 日志记录 和 故障排除。

  • 跑医生(修理)

    bash
    openclaw doctor

    Repairs/migrates 配置和状态,然后运行运行状况检查。请参见 Doctor。

  • 网关快照(仅WS-)

    bash
    openclaw health --jsonopenclaw health --verbose   # shows the target URL + config path on errors

    向正在运行的网关请求完整快照。请参阅 Health。

  • Quick start 和首次运行设置

    首次运行问答 - 安装、载入、身份验证路由、订阅、初始故障 - 位于 首次运行 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" 表示网关在运行代理可用的 SQLite 身份验证存储中找不到 Anthropic 凭证。


    仍然无法解决?请在 Discord 中提问,或使用 GitHub issue 选择器。

    各部分移动的地方

    之前单页版本中的每个问题标题都保留在此处,因此现有链接(例如 /help/faq#where-things-live-on-disk)仍然可以解析。每个条目都指向现在包含答案的页面。

    相关内容

    本页有帮助吗?