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. 快速状态
快速本地概要:OS + 更新、Gateway/服务可达性、agents/sessions、provider 配置 + 运行时问题(当 Gateway 可达时)。2. 可粘贴的报告(可安全分享)
只读诊断,附带日志末尾(tokens 已隐去)。3. 守护进程(daemon)+ 端口状态
显示 supervisor 运行时与 RPC 可达性、检查目标 URL,以及服务可能使用的配置。4. 深度检查
实时 Gateway 健康检查,支持时还会包含渠道检查(需要 Gateway 可达)。参见 健康检查。5. 查看最新日志尾部
如果 RPC 不可用,请改用:tail -f "/tmp/openclaw/openclaw-$(date +%F).log"
# Named profile example:
tail -f "/tmp/openclaw/openclaw-dev-$(date +%F).log"
6. 运行 doctor(修复)
修复/迁移配置和状态,然后运行健康检查。参见 Doctor。7. Gateway 快照(仅 WS)
向正在运行的 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 这样的既有链接仍能正常解析。每个条目都指向当前包含该答案的页面。
- 什么是 OpenClaw?
- 用一段话来说,OpenClaw 是什么?
- 我的团队可以共用一个 OpenClaw 吗?
- 价值主张
- 我刚完成设置——首先应该做什么?
- OpenClaw 最常用的五个日常使用场景是什么?
- OpenClaw 能否为 SaaS 提供线索生成、外联、广告和博客方面的帮助?
- OpenClaw 是 OpenAI 旗下的吗?
- OpenClaw 会向 Foundation 发送什么?
- OpenClaw 如何获得资金支持?与其他方式相比如何?
- 与 Claude Code 相比,OpenClaw 在 Web 开发方面有哪些优势?
- 技能与自动化
- 如何自定义技能而又不让仓库变得杂乱?
- 我可以从自定义文件夹加载技能吗?
- 如何为不同任务使用不同的模型或设置?
- bot 在处理繁重任务时会卡住。如何分流该任务?
- 在 Discord 上,绑定线程的 subagent 会话是如何工作的?
- subagent 已完成,但完成更新被发送到错误位置或从未发布。我应该检查什么?
- cron 或提醒没有触发。我应该检查什么?
- cron 已触发,但没有任何内容发送到渠道。为什么?
- 为什么一次独立的 cron 运行会切换模型或重试一次?
- 如何在 Linux 上安装技能?
- OpenClaw 能否按计划或在后台持续运行任务?
- 我能在 Linux 上运行仅限 Apple macOS 的技能吗?
- 你们有 Notion 或 HeyGen 集成吗?
- 如何使用已登录的 Chrome 与 OpenClaw 配合?
- 沙箱与记忆
- 有专门的沙箱文档吗?
- Docker 感觉受限——如何启用完整功能?
- 我能否让 DM 保持私密,同时用同一个 agent 让群组公开/沙箱化?
- 如何将主机文件夹绑定到沙箱?
- 记忆是如何工作的?
- 语义记忆搜索需要 OpenAI API 密钥吗?
- 数据在磁盘上的存放位置
- OpenClaw 使用的所有数据是否都保存在本地?
- OpenClaw 将数据存储在哪里?
- AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该放在哪里?
- 我可以让 SOUL.md 更大吗?
- 推荐的备份策略
- 如何完全卸载 OpenClaw?
- 智能体可以在工作区之外工作吗?
- 远程模式:会话存储在哪里?
- 配置基础
- 配置文件是什么格式?它在哪里?
- 我设置了 gateway.bind: "lan"(或 "tailnet"),但现在没有服务在监听 / UI 显示未授权
- 为什么现在在 localhost 上需要令牌?
- 更改配置后必须重启吗?
- 如何启用网络搜索(以及网络抓取)?
- config.apply 清空了我的配置。如何恢复并避免这种情况?
- 如何跨设备运行带有专用工作节点的中央 Gateway?
- OpenClaw 浏览器可以无头运行吗?
- 如何将 Brave 用于浏览器控制?
- 远程 Gateway 与节点
- 命令如何在 Telegram、Gateway 和节点之间传播?
- 如果 Gateway 托管在远程,我的智能体如何访问我的电脑?
- Tailscale 已连接但我没有收到回复。怎么办?
- 两个 OpenClaw 实例可以互相通信吗(本地 + VPS)?
- 多个智能体需要单独的 VPS 吗?
- 在我的个人笔记本电脑上使用节点,而不是从 VPS 通过 SSH 连接,有什么好处吗?
- 节点会运行 Gateway 服务吗?
- 有没有通过 API / RPC 应用配置的方法?
- 首次安装的最低合理配置
- 如何在 VPS 上设置 Tailscale 并从 Mac 连接?
- 如何将 Mac 节点连接到远程 Gateway(Tailscale Serve)?
- 我应该在第二台笔记本电脑上安装,还是只添加一个节点?
- 环境变量与 .env 加载
- OpenClaw 如何加载环境变量?
- 我通过服务启动了 Gateway,但环境变量消失了。怎么办?
- 我设置了 COPILOT_GITHUB_TOKEN,但模型状态显示 "Shell env: off"。为什么?
- 会话与多聊天
- 如何开始新的对话?
- 如果我从不发送 /new,会话会自动重置吗?
- 有没有办法组建一个 OpenClaw 实例团队(一个 CEO 和多个智能体)?
- 为什么上下文会在任务中途被截断?如何防止这种情况?
- 如何彻底重置 OpenClaw 但保留安装?
- 我遇到 "context too large" 错误——如何重置或压缩?
- 为什么我会看到 "LLM request rejected: messages.content.tool_use.input field required"?
- 为什么我每 30 分钟会收到心跳消息?
- 我需要将"机器人账户"添加到 WhatsApp 群组吗?
- 如何获取 WhatsApp 群组的 JID?
- 为什么 OpenClaw 在群组中不回复?
- 群组/线程与私信共享上下文吗?
- 我可以创建多少个工作区和智能体?
- 我可以同时运行多个机器人或聊天(Slack)吗?应该如何设置?
- Gateway:端口、"已在运行"与远程模式
- Gateway 使用哪个端口?
- 为什么 openclaw gateway status 报告进程正在运行但连接失败?
- 为什么 openclaw gateway status 显示的 "Config (cli)" 和 "Config (service)" 不同?
- "another gateway instance is already listening" 是什么意思?
- 如何以远程模式运行 OpenClaw(客户端连接到其他位置的 Gateway)?
- Control UI 显示 "unauthorized"(或一直重新连接)。怎么办?
- “invalid handshake” / 代码 1008 是什么意思?
- 日志与调试
- 日志在哪里?
- 如何启动/停止/重启 Gateway 服务?
- 我在 Windows 上关闭了终端,如何重启 OpenClaw?
- Gateway 已启动但回复始终未到达。我应该检查什么?
- “Disconnected from gateway: no reason” - 现在怎么办?
- Telegram setMyCommands 失败。我应该检查什么?
- TUI 没有输出。我应该检查什么?
- 如何完全停止然后启动 Gateway?
- ELI5:openclaw gateway restart 与 openclaw gateway 的区别
- 当出现问题时获取更多详细信息的最快方式
- 媒体和附件
- 我的技能生成了图像/PDF,但没有发送任何内容
- 安全与访问控制
- 将 OpenClaw 暴露给入站私信是否安全?
- prompt injection 是否只是公共机器人的问题?
- 因为 OpenClaw 使用 TypeScript/Node 而不是 Rust/WASM,它是否更不安全?
- 我看到有关暴露的 OpenClaw 实例的报告。我应该检查什么?
- 安装 ClawHub 技能和第三方插件是否安全?
- 我的机器人是否应该有自己独立的电子邮件、GitHub 账户或电话号码?
- 我可以让它自主处理我的文本消息吗?这样安全吗?
- 我可以使用更便宜的模型来执行个人助理任务吗?
- 我在 Telegram 中运行了 /start,但没有收到配对代码
- WhatsApp:它会给我的联系人发消息吗?配对是如何工作的?
- 聊天命令、中止任务以及“它不会停止”
- 如何阻止内部系统消息在聊天中显示?
- 如何停止/取消正在运行的任务?
- 如何从 Telegram 发送 Discord 消息?(“Cross-context messaging denied”)
- 为什么感觉机器人“忽略”了快速连续发送的消息?
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw