本页内容
本页内容
FAQ
FAQ
针对真实环境部署的快速回答和更深入的故障排查(本地开发、VPS、多智能体、OAuth/API 密钥、模型故障切换)。运行时诊断请参见 故障排查。完整配置参考请参见 配置。
此页是一个索引。日常 FAQ 分为十三页,每个主题一页。分诊阶梯保留在该页面上;打开与您的问题相符的页面。
| 页面 | 读它的时候 |
|---|---|
| 什么是OpenClaw? | 您正在评估 OpenClaw,或解释它是什么以及谁资助它。 |
| 技能与自动化 | 您正在自定义技能,或者 cron 作业、提醒或子代理行为不当。 |
| 沙箱和内存 | 您正在调整沙箱,或者内存不持久。 |
| 磁盘上的内容 | 您需要查找、备份、移动或删除 OpenClaw 数据。 |
| 配置基础 | 您正在编辑配置、启用网络搜索或从 config.apply 恢复。 |
| 远程网关和节点 | 您在 VPS 或其他计算机上运行网关,或者您正在添加节点。 |
| Env 变量和 .env 加载 | 您正在通过 env 或 .env 设置密钥,或者服务丢失它们。 |
| 会话和多个聊天 | 您正在管理会话、重置、上下文限制、组或多个机器人。 |
| 网关端口,已运行,远程模式 | 网关不会绑定,表示它已经在运行,或者您需要远程模式。 |
| 记录和调试 | 您需要记录日志或重新启动服务,否则永远不会收到回复。 |
| 媒体和附件 | 技能生成了图像或 PDF,但没有发送任何内容。 |
| 安全和访问控制 | 您正在将 OpenClaw 暴露给入站消息或判断插件风险。 |
| 聊天命令、中止任务和停止运行 | 任务不会停止,或者您正在调整斜杠命令和队列。 |
出问题后的前 60 秒
快速状态
快速本地摘要:OS + 更新、Gateway/service 可访问性、agents/sessions、提供程序配置 + 运行时问题(当网关可访问时)。
可粘贴的报告(安全共享)
只读诊断,附带日志尾部(令牌已脱敏)。
守护进程+端口状态
显示主管运行时与 RPC 可访问性、检查目标 URL 以及服务可能使用的配置。
深度检查
实时网关运行状况检查,包括支持时的通道检查(需要可访问的网关)。请参阅 Health。
跟踪最新日志
如果 RPC 挂了,可改用:
跑医生(修理)
Repairs/migrates 配置和状态,然后运行运行状况检查。请参见 Doctor。
网关快照(仅WS-)
向正在运行的网关请求完整快照。请参阅 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)仍然可以解析。每个条目都指向现在包含答案的页面。
- 什么是OpenClaw?
- OpenClaw 是什么?
- 我的团队可以共用一个OpenClaw吗?
- 价值主张
- I 只是设置 - 我应该先做什么?
- OpenClaw 的前五个日常用例是什么?
- OpenClaw 可以为 SaaS 提供潜在客户开发、外展、广告和博客方面的帮助吗?
- OpenClaw是OpenAI拥有的吗?
- OpenClaw 向基金会发送什么?
- OpenClaw 的资金来源如何,比较如何?
- Web开发与Claude Code相比有什么优势?
- 技能与自动化
- 如何在不弄脏仓库的情况下自定义技能?
- 我可以从自定义文件夹加载技能吗?
- 如何针对不同的任务使用不同的模型或设置?
- 机器人在执行繁重工作时冻结。我如何卸载它?
- 线程绑定子代理会话如何在 Discord 上工作?
- A 子代理已完成,但完成更新去了错误的地方或从未发布。我应该检查什么?
- Cron 或提醒不会触发。我应该检查什么?
- Cron 已触发,但没有任何内容发送到通道。为什么?
- 为什么隔离的cron运行切换模型或重试一次?
- 如何在Linux上安装技能?
- OpenClaw可以在后台定时或连续运行任务吗?
- 我可以运行Apple macOS-仅来自Linux的技能吗?
- 您有 Notion 或 HeyGen 集成吗?
- 如何将现有登录的 Chrome 与 OpenClaw 一起使用?
- 沙箱和内存
- 有专用的沙箱文档吗?
- Docker 感觉有限 - 如何启用全部功能?
- 我可以将 DM 保持为私人状态,但可以使用一名代理进行群组 public/sandboxed 吗?
- 如何将主机文件夹绑定到沙箱中?
- 内存是如何工作的?
- 记忆总是忘记事情。如何让它粘住?
- 记忆会永远存在吗?有什么限制?
- 语义记忆搜索是否需要 OpenAI API 密钥?
- 磁盘上的内容
- OpenClaw使用的所有数据都保存在本地吗?
- OpenClaw 在哪里存储其数据?
- AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该住在哪里?
- 我可以把SOUL.md做大吗?
- 推荐备份策略
- 如何彻底卸载OpenClaw?
- 客服人员可以在工作区之外工作吗?
- 远程模式:会话存储在哪里?
- 配置基础
- 配置是什么格式?在哪里?
- I 设置 gateway.bind:“lan”(或“tailnet”),现在没有任何声音/UI 说未经授权的
- 为什么我现在需要本地主机上的令牌?
- 更改配置后是否需要重新启动?
- 如何启用网络搜索(和网络获取)?
- config.apply 擦除了我的配置。如何恢复并避免这种情况?
- 如何跨设备运行具有专门工作人员的中央网关?
- OpenClaw浏览器可以无头运行吗?
- 如何使用Brave进行浏览器控制?
- 远程网关和节点
- 命令如何在Telegram、网关和节点之间传播?
- 如果网关是远程托管的,我的代理如何访问我的计算机?
- Tailscale 已连接,但我没有收到回复。现在怎么办?
- 两个 OpenClaw 实例能否相互通信(本地 + VPS)?
- 我是否需要为多个代理提供单独的 VPS?
- 在我的个人笔记本电脑上使用节点而不是 VPS 中的 SSH 有好处吗?
- 节点是否运行网关服务?
- 是否有 API / RPC 方式来应用配置?
- 首次安装的最小合理配置
- 如何在 VPS 上设置 Tailscale 并从我的 Mac 进行连接?
- 如何将Mac节点连接到远程网关(Tailscale服务)?
- 我应该安装在第二台笔记本电脑上还是只添加一个节点?
- EEnv 变量和 .env 加载
- OpenClaw如何加载环境变量?
- I 通过服务启动网关,我的环境变量消失了。现在怎么办?
- I 设置为 COPILOT_GITHUB_TOKEN,但模型状态显示“Shell env:关闭”。为什么?
- 会话和多个聊天
- 我如何开始新的对话?
- 如果我从不发送/new,会话会自动重置吗?
- 有没有办法让 OpenClaw 实例组成一个团队(一个 CEO 和多个代理)?
- 为什么上下文在任务中被截断?如何预防?
- 如何完全重置OpenClaw但保持安装状态?
- I 收到“上下文太大”错误 - 如何重置或压缩?
- 为什么我会看到“LLM 请求被拒绝:messages.content.tool_use.input 字段必填”?
- 为什么我每 30 分钟就会收到一次心跳消息?
- 我需要向WhatsApp组添加“机器人帐户”吗?
- 如何获取WhatsApp组的JID?
- 为什么OpenClaw在群里不回复?
- groups/threads是否与DM共享上下文?
- 我可以创建多少个工作区和代理?
- 我可以同时运行多个机器人或聊天吗(Slack),我应该如何设置?
- 网关:端口、“已运行”和远程模式
- 网关使用什么端口?
- 为什么openclaw网关状态报告正在运行进程但连接失败?
- 为什么openclaw网关状态显示“Config(cli)”和“Config(service)”不同?
- “另一个网关实例已在侦听”是什么意思?
- 如何在远程模式下运行OpenClaw(客户端连接到其他地方的网关)?
- Control UI 表示“未经授权”(或不断重新连接)。现在怎么办?
- I 设置 gateway.bind tailnet,但它仅侦听环回
- 我可以在同一主机上运行多个网关吗?
- “无效握手”/代码1008是什么意思?
- 日志记录和调试
- 日志在哪里?
- start/stop/restart 如何使用网关服务?
- I 在 Windows 上关闭了我的终端 - 如何重新启动 OpenClaw?
- 网关已启动,但回复从未到达。我应该检查什么?
- “与网关断开连接:无原因”-现在怎么办?
- Telegram setMyCommands 失败。我应该检查什么?
- TUI 显示无输出。我应该检查什么?
- 如何完全停止然后启动网关?
- ELI5:openclaw网关重启与openclaw网关
- 出现故障时获取更多详细信息的最快方法
- 媒体和附件
- 我的技能生成了image/PDF,但没有发送任何内容
- 安全和访问控制
- 将 OpenClaw 暴露给入站 DM 是否安全?
- 即时注入只是公共机器人的问题吗?
- OpenClaw 是否不太安全,因为它使用 TypeScript/Node 而不是 Rust/WASM?
- I 看到有关暴露的 OpenClaw 实例的报告。我应该检查什么?
- ClawHub技能和第三方插件可以安全安装吗?
- 我的机器人应该有自己的电子邮件、GitHub 帐户或电话号码吗?
- 我可以赋予它对我的短信的自主权吗?这样安全吗?
- 我可以使用更便宜的模型来执行个人助理任务吗?
- I 在 Telegram 中运行 /start 但没有获得配对码
- WhatsApp:它会向我的联系人发送消息吗?配对如何进行?
- 聊天命令、中止任务和“它不会停止”
- 如何阻止内部系统消息在聊天中显示?
- stop/cancel 如何运行任务?
- 如何从Telegram发送Discord消息? (“跨上下文消息传递被拒绝”)
- 为什么感觉机器人“忽略”快速消息?