常见问题

快速解答以及针对真实世界设置的更深入故障排除（本地开发、VPS、多代理、OAuth/API 密钥、模型故障转移）。有关运行时诊断，请参阅故障排除。有关完整配置参考，请参阅配置?

目录

• [快速开始和首次运行设置]
  • 我卡住了 - 获得帮助的最快方法是什么？
  • 安装和设?OpenClaw 的推荐方法是什么？
  • 入职后如何打开仪表板？
  • 如何在本地主机与远程之间验证仪表板令牌？
  • 我需要什么运行时？
  • 它能在树莓派上运行吗？
  • 树莓派安装有什么提示？
  • 它卡?唤醒我的朋友”/入职无法孵化。怎么解决？
  • 我可以迁移我的设置到新机器（Mac mini）而不重做入职吗？
  • 我如何查看最新版本中的新内容？
  • 我无法访?docs.openclaw.ai（SSL 错误）。怎么解决？
  • 稳定版和测试版有什么区别？
  • 如何安装测试版，测试版和开发版有什么区别？
  • 如何尝试最新版本？
  • 安装和入职通常需要多长时间？
  • 安装程序卡住了？如何获得更多反馈？
  • Windows 安装显示 git 未找到或 openclaw 未识别
  • 文档没有回答我的问题 - 如何获得更好的答案？
  • 如何?Linux 上安?OpenClaw？
  • 如何?VPS 上安?OpenClaw？
  • ?VPS 安装指南在哪里？
  • 我可以要?OpenClaw 更新自己吗？
  • 入职向导实际上做什么？
  • 我需?Claude ?OpenAI 订阅才能运行这个吗？
  • 我可以在没有 API 密钥的情况下使用 Claude Max 订阅吗
  • Anthropic “setup-token” 认证如何工作？
  • 我在哪里可以找到 Anthropic setup-token？
  • 你们支持 Claude 订阅认证（Claude Pro ?Max）吗？
  • 为什么我看到来自 Anthropic ?HTTP 429: rate_limit_error？
  • 支持 AWS Bedrock 吗？
  • Codex 认证如何工作？
  • 你们支持 OpenAI 订阅认证（Codex OAuth）吗？
  • 如何设置 Gemini CLI OAuth
  • 本地模型可以用于休闲聊天吗？
  • 如何将托管模型流量保持在特定区域？
  • 我必须购?Mac Mini 来安装这个吗？
  • 我需?Mac mini 来支?iMessage 吗？
  • 如果我购?Mac mini 来运?OpenClaw，我可以连接到我?MacBook Pro 吗？
  • 我可以使?Bun 吗？
  • Telegram：allowFrom 中放什么？
  • 多个人可以使用同一?WhatsApp 号码配合不同?OpenClaw 实例吗？
  • 我可以运?快速聊?代理?Opus 编码”代理吗？
  • Homebrew ?Linux 上工作吗？
  • 可黑（git）安装和 npm 安装有什么区别？
  • 我以后可以在 npm ?git 安装之间切换吗？
  • 我应该在笔记本电脑还?VPS 上运行网关？
  • 在专用机器上运行 OpenClaw 有多重要？
  • 最?VPS 要求和推荐操作系统是什么？
  • 我可以在 VM 中运?OpenClaw 吗，有什么要求
• 什么是 OpenClaw？
  • 一句话概括什么是 OpenClaw？
  • 价值主张是什么？
  • 我刚设置好，首先应该做什么
  • OpenClaw 的五大日常用例是什么
  • OpenClaw 可以帮助 SaaS 的潜在客户生成、推广和博客吗？
  • ?Claude Code 相比有什么优势用?Web 开发？
• 技能和自动化
  • 如何在不弄脏仓库的情况下自定义技能？
  • 我可以从一个自定义文件夹加载技能吗？
  • 我如何为不同任务使用不同的模型？
  • 机器人在做繁重工作时冻结。我如何卸载那个？
  • 定时任务或提醒不触发。我应该检查什么？
  • 如何?Linux 上安装技能？
  • OpenClaw 可以按计划或连续在后台运行任务吗？
  • 我可以从 Linux 运行?macOS 的技能吗？
  • 你们?Notion ?HeyGen 集成吗？
  • 如何安装 Chrome 扩展以进行浏览器接管？
• 沙盒和内存
  • 有专门的沙盒文档吗？
  • 如何将主机文件夹绑定到沙盒？
  • 内存如何工作？
  • 内存一直忘记事情。我如何让它记住？
  • 内存会永远持续吗？有什么限制？
  • 语义内存搜索需?OpenAI API 密钥吗？
• 东西在磁盘上的位置
  • 使用 OpenClaw 的所有数据都保存在本地吗？
  • OpenClaw 在哪里存储其数据？
  • AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该放在哪里？
  • 推荐的备份策略是什么？
  • 如何完全卸载 OpenClaw？
  • 代理可以在工作区外工作吗？
  • 我在远程模式 - 会话存储在哪里？
• 配置基础
  • 配置是什么格式？在哪里？
  • 我设置了 gateway.bind: "lan"（或 "tailnet"）现在没有监?UI 显示未授权
  • 为什么我现在在本地主机上需要令牌？
  • 更改配置后必须重启吗？
  • 如何启用网络搜索（和网络获取）？
  • config.apply 擦除了我的配置。如何恢复并避免这个？
  • 如何运行具有跨设备专门工作进程的中央网关？
  • OpenClaw 浏览器可以无头运行吗？
  • 我如何使?Brave 进行浏览器控制？
• 远程网关和节点
  • 命令如何?Telegram、网关和节点之间传播？
  • 如果网关托管在远程，我的代理如何访问我的计算机？
  • Tailscale 已连接但没有回复。怎么解决？
  • 两个 OpenClaw 实例可以相互通信（本?+ VPS）吗？
  • 多代理需要单独的 VPS 吗？
  • 使用我个人笔记本电脑上的节点而不是从 VPS SSH 有好处吗？
  • 节点运行网关服务吗？
  • ?API / RPC 方式应用配置吗？
  • 首次安装的最?正常”配置是什么？
  • 如何?VPS 上设?Tailscale 并从我的 Mac 连接？
  • 如何?Mac 节点连接到远程网关（Tailscale Serve）？
  • 我应该安装在第二台笔记本电脑上还是只添加一个节点？
• 环境变量.env 加载
  • OpenClaw 如何加载环境变量？
  • “我通过服务启动网关，我的环境变量消失了?怎么解决？
  • 我设置了 COPILOT_GITHUB_TOKEN，但模型状态显?Shell env: off”。为什么？
• 会话和多个聊天
  • 如何开始新对话？
  • 如果我从不发?/new，会话会自动重置吗？
  • 我可以让一?OpenClaw 实例成为一?CEO 和许多代理吗？
  • 为什么上下文在任务中途被截断？我如何防止它？
  • 如何完全重置 OpenClaw 但保持安装？
  • 我收?上下文太?错误 - 如何重置或压缩？
  • 为什么我看到”LLM 请求被拒绝：messages.content.tool_use.input 字段必需”？
  • 为什么我?30 分钟收到一次心跳消息？
  • 我需要在 WhatsApp 群组中添?机器人账?吗？
  • 如何获取 WhatsApp 群组?JID？
  • OpenClaw 为什么不在群组中回复？
  • 群组/线程是否?DM 共享上下文？
  • 我可以创建多少个工作区和代理？
  • 我可以同时运行多个机器人或聊天（Slack），应该如何设置？
• 模型：默认值、选择、别名、切换
  • “默认模型”是什么？
  • 你推荐什么模型？
  • 如何在不擦除配置的情况下切换模型？
  • 我可以使用自托管模型（llama.cpp、vLLM、Ollama）吗？
  • OpenClaw、Flawd ?Krill 使用什么模型？
  • 如何即时切换模型（无需重启）？
  • 我可以将 GPT 5.2 用于日常任务，Codex 5.3 用于编码吗？
  • 为什么我看到”模型…不允?然后没有回复？
  • 为什么我看到”未知模型：minimax/MiniMax-M2.1”？
  • 我可以使?MiniMax 作为默认值，OpenAI 用于复杂任务吗？
  • opus / sonnet / gpt 是内置快捷方式吗？
  • 如何定义/覆盖模型快捷方式（别名）？
  • 如何从其他提供商添加模型，如 OpenRouter ?Z.AI？
• 模型故障转移?所有模型都失败”
  • 故障转移如何工作？
  • 这个错误是什么意思？
  • No credentials found for profile "anthropic:default" 的修复检查清单
  • 为什么它也尝?Google Gemini 并失败了？
• Auth profile：是什么以及如何管理
  • 什么是 auth profile？
  • 典型?profile ID 是什么？
  • 我可以控制尝试哪?auth profile 优先吗？
  • OAuth vs API 密钥：有什么区别？
• 网关：端口?已运?和远程模式
  • 网关使用什么端口？
  • 为什?openclaw gateway status 显示 Runtime: running ?RPC probe: failed？
  • 为什?openclaw gateway status 显示 Config (cli) ?Config (service) 不同？
  • “另一个网关实例已在监?是什么意思？
  • 如何以远程模式运?OpenClaw（客户端连接到其他地方的网关）？
  • 控制 UI 显示”未授?（或不断重新连接）。怎么解决？
  • 我设置了 gateway.bind: "tailnet" 但它无法绑定/没有监听
  • 我可以在同一主机上运行多个网关吗？
  • “无效握手”/代码 1008 是什么意思？
• 日志和调试
  • 日志在哪里？
  • 如何启动/停止/重启网关服务？
  • 我在 Windows 上关闭了终端 - 如何重启 OpenClaw？
  • 网关已启动但回复永远不到。我应该检查什么？
  • “与网关断开连接：无原因” - 怎么解决？
  • Telegram setMyCommands 因网络错误失败。我应该检查什么？
  • TUI 没有输出。我应该检查什么？
  • 如何完全停止然后启动网关？
  • ELI5：openclaw gateway restart vs openclaw gateway
  • 当某些东西失败时，获得更多细节的最快方法是什么？
• 媒体和附件
  • 我的技能生成了图像/PDF，但没有发送
• 安全和访问控制
  • 向入?DM 公开 OpenClaw 安全吗？
  • 提示注入只是公共机器人的问题吗？
  • 我的机器人应该有自己的电子邮?GitHub 账户或电话号码吗？
  • 我可以给它对我的短信的自主权，这安全吗？
  • 我可以为个人助理任务使用更便宜的模型吗？
  • 我在 Telegram 中运行了 /start 但没有收到配对码
  • WhatsApp：它会给我的联系人发消息吗？配对如何工作？
• 聊天命令、终止任务和”它停不下?
  • 如何阻止内部系统消息显示在聊天中
  • 如何停止/取消运行中的任务？
  • 如何?Telegram 发?Discord 消息？（“跨上下文消息被拒?）
  • 为什么感觉机器人”忽略”快速连续的消息？

如果东西坏了的前 60 ?

1. 快速状态（首先检查）

   openclaw status

   快速本地摘要：OS + 更新、网?服务可达性、代?会话、提供商配置 + 运行时问题（当网关可达时）?

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

   openclaw status --all

   带有日志尾部的只读诊断（令牌已脱敏）?

3. *守护进程 + 端口状?

   openclaw gateway status

   显示监督运行?vs RPC 可达性、探测目?URL，以及服务可能使用了哪个配置?

4. 深度探测

   openclaw status --deep

   运行网关健康检?+ 提供商探测（需要可达的网关）。请参阅健康?

5. *跟踪最新日?

   openclaw logs --follow

   如果 RPC 关闭，回退到：

   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

   文件日志与服务日志分开；请参阅日志和故障排除?

6. 运行 doctor（修复）

   openclaw doctor

   修复/迁移配置/状?+ 运行健康检查。请参阅Doctor?

7. 网关快照

   openclaw health --json
   openclaw health --verbose   # 在错误时显示目标 URL + 配置路径

   向运行中的网关请求完整快照（?WS）。请参阅健康?

快速开始和首次运行设置

我卡住了 - 获得帮助的最快方法是什么？

使用一个可?看到您的机器的本?AI 代理。这比在 Discord 中询问要有效得多，因为大多数”我卡住了”的情况是本地配置或环境问?，远程帮助者无法检查?

• Claude Code：https://www.anthropic.com/claude-code/
• OpenAI Codex：https://openai.com/codex/

这些工具可以读取仓库、运行命令、检查日志，并帮助修复您的机器级设置（PATH、服务、权限、认证文件）。通过可黑（git）安装给他们**完整源代码检?*?

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

这从 git 检出安?OpenClaw，因此代理可以读取代?+ 文档，并对您正在运行的精确版本进行推理。您以后总是可以通过不带 --install-method git 重新运行安装程序切回稳定版?

提示：要求代?*计划并监?*修复（逐步），然后只执行必要的命令。这使更改保持小规模且更容易审计?

如果您发现真正的错误或修复，请提?GitHub issue 或发?PR? https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls

从这些命令开始（询问帮助时分享输出）?

openclaw status
openclaw models status
openclaw doctor

它们的作用：

• openclaw status：网?代理健康 + 基本配置的快速快照?
• openclaw models status：检查提供商认证 + 模型可用性?
• openclaw doctor：验证并修复常见配置/状态问题?

其他有用?CLI 检查：openclaw status --all、openclaw logs --follow、openclaw gateway status、openclaw health --verbose?

快速调试循环：如果东西坏了的前 60 秒? 安装文档：安装、安装程序标志、更新?

安装和设?OpenClaw 的推荐方法是什么？

仓库推荐从源代码运行并使用入职向导：

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

向导也可以自动构?UI 资源。入职后，您通常在端?18789 上运行网关?

从源代码（贡献?开发者）?

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # 首次运行时自动安?UI 依赖
openclaw onboard

如果您还没有全局安装，通过 pnpm openclaw onboard 运行它?

入职后如何打开仪表板？

向导在入职后立即使用干净的（非令牌化）仪表板 URL 打开您的浏览器，同时在摘要中打印链接。保持该标签页打开；如果没有启动，复制/粘贴同机器上打印?URL?

如何在本地主机与远程之间验证仪表板令牌？

本地主机（同机器）：

• 打开 http://127.0.0.1:18789/?
• 如果要求认证，将 gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）中的令牌粘贴到控制 UI 设置中?
• 从网关主机获取：openclaw config get gateway.auth.token（或生成一个：openclaw doctor --generate-gateway-token）?

不在本地主机上：

• Tailscale Serve（推荐）：保持绑?loopback，运?openclaw gateway --tailscale serve，打开 https://<magicdns>/。如?gateway.auth.allowTailscale ?true，身?header 满足控制 UI/WebSocket 认证（无令牌，假设可信网关主机）；HTTP API 仍然需要令?密码?
• Tailnet 绑定：运?openclaw gateway --bind tailnet --token "<token>"，打开 http://<tailscale-ip>:18789/，在仪表板设置中粘贴令牌?
• SSH 隧道：ssh -N -L 18789:127.0.0.1:18789 user@host 然后打开 http://127.0.0.1:18789/ 并在控制 UI 设置中粘贴令牌?

请参阅仪表板和Web 界面以了解绑定模式和认证详情?

我需要什么运行时?

需?Node >= 22。推?pnpm?不推? Bun 用于网关?

它能在树莓派上运行吗?

是的。网关很轻量 —?文档列出 512MB-1GB RAM?*1 ?*和约 500MB 磁盘作为个人使用就足够，并指?树莓?4 可以运行??

如果您想要额外余量（日志、媒体、其他服务）?推荐 2GB*，但这不是硬性要求?

提示：小 Pi/VPS 可以托管网关，您可以配对笔记本电?手机上的节点以进行本地屏?相机/画布或命令执行。请参阅节点?

树莓派安装有什么提示？

简而言之：它能工作，但预计有粗糙边缘?

• 使用 **64 ?*操作系统并保?Node >= 22?
• 首?*可黑（git）安?*以便您可以快速查看日志和更新?
• 从无渠道/技能开始，然后逐个添加?
• 如果遇到奇怪的二进制问题，通常?**ARM 兼容性问?*?

文档：Linux、安装?

它卡?唤醒我的朋友”/入职无法孵化。怎么解决?

该屏幕依赖于网关可达并已认证。TUI 也在首次孵化时自动发?Wake up, my friend!”。如果您看到该行?*没有回复**且令牌停留在 0，代理从未运行?

1. 重启网关?

openclaw gateway restart

2. 检查状?+ 认证?

openclaw status
openclaw models status
openclaw logs --follow

3. 如果仍然挂起，运行：

openclaw doctor

如果网关是远程的，确保隧?Tailscale 连接已启动且 UI 指向正确的网关。请参阅远程访问?

我可以迁移我的设置到新机器（Mac mini）而不重做入职吗？

是的。复?状态目??工作?，然后运行一?Doctor。这使您的机器人”完全一?（内存、会话历史、认证和渠道状态），只要您复制两个位置?

1. 在新机器上安?OpenClaw?
2. 从旧机器复制 $OPENCLAW_STATE_DIR（默认：~/.openclaw）?
3. 复制您的工作区（默认：~/.openclaw/workspace）?
4. 运行 openclaw doctor 并重启网关服务?

这保留了配置、认证资料、WhatsApp 凭据、会话和内存。如果您在远程模式，记住网关主机拥有会话存储和工作区?

重要?*如果您只将工作区提交/推送到 GitHub，您正在备份内存 + 引导文件**，但不是会话历史或认证。那些在 ~/.openclaw/ 下（例如 ~/.openclaw/agents/<agentId>/sessions/）?

相关：迁移、数据存储位置、代理工作区、Doctor、远程模式?

我如何查看最新版本中的新内容?

检?GitHub 变更日志? https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

最新条目在顶部。如果顶部部分标记为 Unreleased，下一个带日期的部分是最新发布的版本。条目按 Highlights?Changes* ?Fixes 分组（需要时加上 docs/其他部分）?

我无法访?docs.openclaw.ai（SSL 错误）。怎么解决?

某些 Comcast/Xfinity 连接错误地通过 Xfinity Advanced Security 阻止 docs.openclaw.ai。禁用它或将其列入白名单，然后重试。更多详情：故障排除? 请帮助我们解除阻止：在此处报告：https://spa.xfinity.com/check_url_status?

如果您仍然无法访问该站点，文档在 GitHub 上有镜像? https://github.com/openclaw/openclaw/tree/main/docs

稳定版和测试版有什么区别？

**稳定?*?测试??npm dist-tags，不是单独的代码行：

• latest = 稳定?
• beta = 用于测试的早期构?

我们将构建发送到 beta，测试它们，一旦构建稳定，我们将同一版本提升?latest。这就是为什?beta 和稳定版可以指向同一版本?

查看变化? https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

如何安装测试版，测试版和开发版有什么区别？

Beta ?npm dist-tag beta（可能匹?latest）? Dev ?main 的移动头（git）；发布时，它使?npm dist-tag dev?

一行命令（macOS/Linux）：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Windows 安装程序（PowerShell）： https://openclaw.ai/install.ps1

更多详情：开发渠道和安装程序标志?

安装和入职通常需要多长时间？

粗略指南?

• *安装? 2-5 分钟
• *入职? 5-15 分钟，取决于您配置多少渠?模型

如果挂起，使用安装程序卡住和我卡住了中的快速调试循环?

如何尝试最新版本？

一行命令（macOS/Linux）：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

这会?git 主分支检出并构建?

安装程序卡住了？如何获得更多反馈?

使用 --verbose 标志运行安装程序?

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

或直接查看安装程序脚本以了解它在做什么：

curl -fsSL https://openclaw.ai/install.sh | less

Windows 安装显示 git 未找到或 openclaw 未识?

确保 git 在您?PATH 中。如果通过 winget ?Chocolatey 安装，它应该可以工作?

如果显示”openclaw 未识?，您可能需?重启终端*?*打开新的命令提示?*以使 PATH 更改生效?

文档没有回答我的问题 - 如何获得更好的答案？

请在 GitHub 上打开 discussion ?issue? https://github.com/openclaw/openclaw/discussions https://github.com/openclaw/openclaw/issues

如何?Linux 上安?OpenClaw?

请参阅Linux 安装指南?

如何?VPS 上安?OpenClaw?

请参?VPS 托管 了解通用 VPS 设置?

?VPS 安装指南在哪里？

• VPS 托管中心
• Fly.io
• Hetzner（Docker）
• GCP（计算引擎）
• exe.dev（VM + HTTPS 代理）

我可以要?OpenClaw 更新自己吗？

目前不支持自动更新。您需要手动更新：

# 如果通过 npm 安装
npm update -g openclaw

# 如果通过 git 安装
cd /path/to/openclaw
git pull
pnpm install
pnpm build

入职向导实际上做什么？

入职向导?

1. 检查您的系统环境（Node 版本、git 等）
2. 要求您选择要配置的渠道（Telegram、Discord、WhatsApp 等）
3. 为每个渠道收集认证（API 密钥、机器人令牌等）
4. 配置模型提供者和 API 密钥
5. 创建初始代理配置
6. 启动网关服务

我需?Claude ?OpenAI 订阅才能运行这个吗？

不需要！OpenClaw 支持多种模型提供商，包括免费选项。您可以使用?

• 本地模型（Ollama、LM Studio 等）
• OpenRouter（聚合多个提供商，包括免费选项?
• 任何 OpenAI 兼容 API

Anthropic “setup-token” 认证如何工作?

setup-token ?Claude Code CLI 使用的认证方式。您可以?Claude Code 设置中获取它，或?Anthropic 控制面板生成一个?

我在哪里可以找到 Anthropic setup-token?

?Claude Code 中运行：

claude auth status

你们支持 Claude 订阅认证（Claude Pro ?Max）吗?

是的！请参阅 Anthropic 认证?

为什么我看到来自 Anthropic ?HTTP 429: rate_limit_error?

这意味着您已达到 API 速率限制。您可以?

1. 等待一段时间后重试
2. 升级您的订阅计划
3. 添加备用模型提供?

支持 AWS Bedrock 吗？

目前不支?AWS Bedrock。这是一个计划中的功能?

Codex 认证如何工作?

Codex（OpenAI 的编程模型）使用 OAuth 认证。请参阅 OpenAI Codex 设置?

你们支持 OpenAI 订阅认证（Codex OAuth）吗?

是的！请参阅 OpenAI Codex OAuth 设置?

如何设置 Gemini CLI OAuth

请参?Google Gemini CLI 认证?

本地模型可以用于休闲聊天吗？

是的！请参阅本地模型?

如何将托管模型流量保持在特定区域?

一些提供商允许您通过设置 API 基础 URL 来指定区域。请查看您的提供商文档?

我必须购?Mac Mini 来安装这个吗?

不是！OpenClaw 可以在任何支?Node.js 的机器上运行，包括：

• 树莓?
• Linux 服务?VPS
• Windows 机器（通过 WSL2?

我需?Mac mini 来支?iMessage 吗？

是的！iMessage 只能?macOS 上运行，因此您需要一?Mac（Mac mini 是一个很好的选择，因为它安静且经济）?

如果我购?Mac mini 来运?OpenClaw，我可以连接到我?MacBook Pro 吗？

是的！通过远程网关功能，您可以从其他机器控制您?OpenClaw 实例?

我可以使?Bun 吗？

**不推?*。Bun 可能会导致一些兼容性问题。请使用 Node.js?= 22）?

Telegram：allowFrom 中放什么？

对于 Telegram，您可以使用?

• 用户 ID：123456789
• 用户名：@username
• 群组 ID：-100123456789

多个人可以使用同一?WhatsApp 号码配合不同?OpenClaw 实例吗？

不可以。WhatsApp 号码一次只能在一个设备上使用?

我可以运?快速聊?代理?Opus 编码”代理吗？

是的！请参阅多代理配置?

Homebrew ?Linux 上工作吗?

是的！Homebrew ?Linux 上工作?

可黑（git）安装和 npm 安装有什么区别？

• npm 安装：更简单，但更难定?
• git 安装：可以读取源代码，便于调试和贡献

我以后可以在 npm ?git 安装之间切换吗？

是的，但可能需要手动重新配置?

我应该在笔记本电脑还?VPS 上运行网关？

取决于您的用例：

• **本地（笔记本电脑?*：更好的延迟，可以访问本地资源（屏幕、文件等?
• VPS?4/7 运行，无需保持电脑开?

在专用机器上运行 OpenClaw 有多重要?

不是必需的，但建议用于生产环境?

最?VPS 要求和推荐操作系统是什么？

• RAM?GB+
• CPU? ?
• 磁盘?0GB+
• 操作系统：Ubuntu 22.04+ ?Debian 11+

我可以在 VM 中运?OpenClaw 吗，有什么要?

是的！只?VM 可以运行 Node.js 22+?

什么是 OpenClaw?

一句话概括什么是 OpenClaw?

OpenClaw 是一个开源的个人 AI 助手平台，支持多渠道消息集成（WhatsApp、Telegram、Discord 等），可以自托管并完全控制您的数据?

价值主张是什么？

• 隐私：您的数据保留在您自己的机器?
• **灵活?*：支持多种渠道和模型
• **可扩展?*：可以添加自定义技能和工作?
• **开?*：透明且可定制

我刚设置好，首先应该做什?

1. 查看仪表?
2. 尝试发送消息到您配置的渠道
3. 查看可用命令列表

OpenClaw 的五大日常用例是什?

1. 个人助理：管理日程、发送提?
2. 自动化工作流：定时任务、数据处?
3. **开发工?*：代码审查、调试辅?
4. 客户服务：自动回复常见问?
5. 内容创作：写作、翻译、总结

?Claude Code 相比有什么优势用?Web 开发？

OpenClaw 更专注于聊天/消息渠道集成，?Claude Code 更专注于 IDE 集成?

技能和自动?

如何在不弄脏仓库的情况下自定义技能？

使用自定义技能目录。请参阅技能配置?

我可以从一个自定义文件夹加载技能吗?

是的！请参阅技能配置?

我如何为不同任务使用不同的模型？

使用 /model 命令或配置多代理?

机器人在做繁重工作时冻结。我如何卸载那个?

使用后台执行或工作进程?

定时任务或提醒不触发。我应该检查什么？

检?cron 服务是否正在运行，以及您的时区设置?

如何?Linux 上安装技能？

与在其他平台上相同。请参阅技能安装?

OpenClaw 可以按计划或连续在后台运行任务吗?

是的！请参阅cron 任务和心跳?

我可以从 Linux 运行?macOS 的技能吗?

不可以。macOS 特定技能需?macOS?

你们?Notion ?HeyGen 集成吗？

目前没有，但可以通过自定义技能添加?

如何安装 Chrome 扩展以进行浏览器接管?

请参阅浏览器扩展?

沙盒和内?

有专门的沙盒文档吗？

是的！请参阅沙盒化?

如何将主机文件夹绑定到沙盒？

使用 agents.defaults.sandbox.docker.binds 配置?

内存如何工作?

请参阅内存系统?

内存一直忘记事情。我如何让它记住?

确保使用正确的记忆命令并定期保存?

内存会永远持续吗？有什么限制？

有存储限制。请参阅内存限制?

语义内存搜索需?OpenAI API 密钥吗？

是的，因为语义搜索使用嵌入模型?

东西在磁盘上的位?

使用 OpenClaw 的所有数据都保存在本地吗?

是的！OpenClaw 不会将您的数据发送到任何外部服务器?

OpenClaw 在哪里存储其数据?

默认?~/.openclaw/?

AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该放在哪里?

在工作区根目录（默认 ~/.openclaw/workspace）?

推荐的备份策略是什么？

复制整个 ~/.openclaw 目录?

如何完全卸载 OpenClaw?

请参阅卸载指南?

代理可以在工作区外工作吗?

不推荐。工作区是代理的主要工作目录?

我在远程模式 - 会话存储在哪里？

在网关主机上?

配置基础

配置是什么格式？在哪里？

JSON5 格式，位?~/.openclaw/openclaw.json?

我设置了 gateway.bind: "lan"（或 "tailnet"）现在没有监?UI 显示未授?

确保?

1. 防火墙允许该端口
2. 令牌已正确配?

为什么我现在在本地主机上需要令牌？

您可能在配置中启用了认证?

更改配置后必须重启吗?

是的，需要重启网关?

如何启用网络搜索（和网络获取）？

在配置中启用搜索提供商?

config.apply 擦除了我的配置。如何恢复并避免这个?

使用 openclaw config backup 在更改前备份?

如何运行具有跨设备专门工作进程的中央网关?

请参阅分布式网关?

OpenClaw 浏览器可以无头运行吗?

是的，请参阅无头浏览器?

我如何使?Brave 进行浏览器控制？

在配置中设置 browser.type: "brave"?

远程网关和节?

命令如何?Telegram、网关和节点之间传播?

通过 WebSocket ?RPC?

如果网关托管在远程，我的代理如何访问我的计算机？

使用节点。请参阅节点?

Tailscale 已连接但没有回复。怎么解决?

检?Tailscale 配置和防火墙设置?

两个 OpenClaw 实例可以相互通信（本?+ VPS）吗?

是的，请参阅远程网关?

多代理需要单独的 VPS 吗？

不一定。您可以在同一 VPS 上运行多个代理?

使用我个人笔记本电脑上的节点而不是从 VPS SSH 有好处吗?

是的，延迟更低，可以访问本地资源?

节点运行网关服务吗？

不。节点是网关的轻量级客户端?

?API / RPC 方式应用配置吗？

是的，请参阅 RPC API?

首次安装的最?正常”配置是什么？

请参阅配置示例?

如何?VPS 上设?Tailscale 并从我的 Mac 连接?

请参?Tailscale 设置?

如何?Mac 节点连接到远程网关（Tailscale Serve）？

请参阅远程访问?

我应该安装在第二台笔记本电脑上还是只添加一个节点？

添加节点更简单，因为它不需要完整的 OpenClaw 安装?

环境变量.env 加载

OpenClaw 如何加载环境变量?

请参阅环境变量?

”我通过服务启动网关，我的环境变量消失了?怎么解决?

请确保服务配置正确加载环境变量?

我设置了 COPILOT_GITHUB_TOKEN，但模型状态显?Shell env: off”。为什么？

确保在配置中启用?shellEnv?

会话和多个聊?

如何开始新对话?

使用 /new 命令?

如果我从不发?/new，会话会自动重置吗？

不会。会话持续直到您明确重置?

我可以让一?OpenClaw 实例成为一?CEO 和许多代理吗?

是的，请参阅多代理配置?

为什么上下文在任务中途被截断？我如何防止它？

使用摘要或压缩功能?

如何完全重置 OpenClaw 但保持安装？

使用 openclaw reset 命令?

我收?上下文太?错误 - 如何重置或压缩？

使用 /compact 命令或手动重置?

为什么我看到”LLM 请求被拒绝：messages.content.tool_use.input 字段必需”?

这通常是模型或 API 配置问题?

为什么我?30 分钟收到一次心跳消息？

这是正常的心跳功能。请参阅心跳配置?

我需要在 WhatsApp 群组中添?机器人账?吗？

是的，WhatsApp 要求机器人是群组成员?

如何获取 WhatsApp 群组?JID?

在群组中使用机器人发送消息，然后从日志中获取 JID?

OpenClaw 为什么不在群组中回复?

检查群组策略设置?

群组/线程是否?DM 共享上下文？

默认不共享?

我可以创建多少个工作区和代理?

没有硬性限制?

我可以同时运行多个机器人或聊天（Slack），应该如何设置?

在配置中定义多个渠道和代理?

模型：默认值、选择、别名、切?

”默认模型”是什么？

在配置中指定的默认模型?

你推荐什么模型？

对于一般任务：claude-sonnet-4-5 对于编码：claude-opus-4-6

如何在不擦除配置的情况下切换模型?

使用 /model 命令?

我可以使用自托管模型（llama.cpp、vLLM、Ollama）吗?

是的！请参阅本地模型?

OpenClaw、Flawd ?Krill 使用什么模型？

请参?OpenClaw 文档?

如何即时切换模型（无需重启）？

使用 /model 命令?

我可以将 GPT 5.2 用于日常任务，Codex 5.3 用于编码吗？

是的，在配置中设置多个模型并使用 /model 切换?

为什么我看到”模型…不允?然后没有回复?

检查模型是否在允许列表中?

为什么我看到”未知模型：minimax/MiniMax-M2.1”?

确保提供商已正确配置?

我可以使?MiniMax 作为默认值，OpenAI 用于复杂任务吗？

是的，在配置中设置多个提供商?

opus / sonnet / gpt 是内置快捷方式吗?

是的?

如何定义/覆盖模型快捷方式（别名）?

在配置中使用 models.aliases?

如何从其他提供商添加模型，如 OpenRouter ?Z.AI?

在配置中添加提供商并指定模型?

模型故障转移?所有模型都失败”

故障转移如何工作?

请参阅模型故障转移?

这个错误是什么意思？

检查错误消息并搜索相关文档?

No credentials found for profile "anthropic:default" 的修复检查清?

1. 确保 API 密钥已设?
2. 检查认证资料配?

为什么它也尝?Google Gemini 并失败了?

这是故障转移的正常行为?

Auth profile：是什么以及如何管?

什么是 auth profile?

用于存储 API 密钥和认证信息的配置对象?

典型?profile ID 是什么？

anthropic:default、openai:default 等?

我可以控制尝试哪?auth profile 优先吗？

是的，在配置中设?profile 顺序?

OAuth vs API 密钥：有什么区别？

• API 密钥：直接使用密?
• OAuth：需要用户授权流?

网关：端口?已运?和远程模?

网关使用什么端口？

默认 18789?

为什?openclaw gateway status 显示 Runtime: running ?RPC probe: failed?

网关可能正在启动或配置有问题?

为什?openclaw gateway status 显示 Config (cli) ?Config (service) 不同?

CLI 和服务可能使用不同的配置文件?

”另一个网关实例已在监?是什么意思？

已经有网关在运行?

如何以远程模式运?OpenClaw（客户端连接到其他地方的网关）？

请参阅远程模式?

控制 UI 显示”未授?（或不断重新连接）。怎么解决?

检查令牌配置?

我设置了 gateway.bind: "tailnet" 但它无法绑定/没有监听

确保 Tailscale 正在运行?

我可以在同一主机上运行多个网关吗?

是的，使用不同端口?

”无效握手”/代码 1008 是什么意思？

认证失败?

日志和调?

日志在哪里？

~/.openclaw/logs/?

如何启动/停止/重启网关服务?

使用 openclaw gateway start/stop/restart?

我在 Windows 上关闭了终端 - 如何重启 OpenClaw?

使用服务管理器或重新运行启动命令?

网关已启动但回复永远不到。我应该检查什么？

检查网络连接和防火墙设置?

”与网关断开连接：无原因” - 怎么解决?

检查网络稳定性?

Telegram setMyCommands 因网络错误失败。我应该检查什么？

检?Telegram bot 令牌是否有效?

TUI 没有输出。我应该检查什么？

检查终端设置?

如何完全停止然后启动网关?

使用 openclaw gateway stop 然后 start?

ELI5：openclaw gateway restart vs openclaw gateway

• restart：先停止再启?
• gateway：直接启动（如果已在运行会失败）

当某些东西失败时，获得更多细节的最快方法是什么？

使用 openclaw logs --follow?

媒体和附?

我的技能生成了图像/PDF，但没有发?

检查文件路径和权限?

安全和访问控?

向入?DM 公开 OpenClaw 安全吗？

是的，但请确保配置正确的认证?

提示注入只是公共机器人的问题吗？

不是，私有机器人也可能受到影响?

我的机器人应该有自己的电子邮?GitHub 账户或电话号码吗?

建议用于生产环境?

我可以给它对我的短信的自主权，这安全吗？

这取决于您的信任级别和配置?

我可以为个人助理任务使用更便宜的模型吗？

是的?

我在 Telegram 中运行了 /start 但没有收到配对码

检?bot 配置?

WhatsApp：它会给我的联系人发消息吗？配对如何工作?

请参?WhatsApp 配对?

聊天命令、终止任务和”它停不下?

如何阻止内部系统消息显示在聊天中

在配置中设置 messages.showInternal: false?

如何停止/取消运行中的任务?

使用 /cancel ?/kill?

如何?Telegram 发?Discord 消息？（“跨上下文消息被拒??

跨渠道消息不被支持?

为什么感觉机器人”忽略”快速连续的消息?

这是防止垃圾消息的保护机制?