首次运行 FAQ

快速入门和首次运行常见问题。日常操作、模型、身份验证、会话和故障排除请参阅主 FAQ。

本页是一个索引。首次运行的常见问题记录在两个页面上，每个读者任务对应一个页面。请打开与你任务匹配的页面。

各章节迁移位置¶

旧单页版本中的每个锚点都会在此处保留其目标，因此诸如 /help/faq-first-run#why-am-i-seeing-http-429-ratelimiterror-from-anthropic 之类的现有链接仍然有效。每个条目都指向当前承载相应内容的页面。

• 快速入门与首次运行设置
• 我卡住了
• 为什么我会看到来自 Anthropic 的 HTTP 429 rate_limit_error 错误？
• 推荐安装和设置 OpenClaw 的方式
• 我卡住了，最快脱困方式
• 初始化后如何打开仪表板？
• 如何在本地主机与远程上对仪表板进行身份验证？
• 心跳一直跳过。跳过原因是什么意思？
• 为什么聊天审批有两个 exec 审批配置？
• 我需要什么运行时？
• 它能在 Raspberry Pi 上运行吗？
• Raspberry Pi 安装有什么技巧吗？
• 它卡在“叫醒我的朋友”/初始化无法完成。现在该怎么办？
• 我可以将我的设置迁移到新机器而无需重新初始化吗？
• 我在哪里可以看到最新版本的新内容？
• 无法访问 docs.openclaw.ai（SSL 错误）
• 稳定版与 Beta 版的区别
• 如何安装 Beta 版？Beta 版和开发版之间有什么区别？
• 如何试用最新的开发版本？
• 安装和初始化通常需要多长时间？
• 安装程序卡住了？如何获取更多反馈？
• Windows 安装提示找不到 git 或无法识别 openclaw
• Windows exec 输出显示乱码中文，我该怎么办？
• 文档没有回答我的问题，如何获得更好的答案？
• 如何在 Linux 上安装 OpenClaw？
• 如何在 VPS 上安装 OpenClaw？
• 云/VPS 安装指南在哪里？
• 我可以让 OpenClaw 自行更新吗？
• 初始化实际上做了什么？
• 运行此软件需要 Claude 或 OpenAI 订阅吗？
• 我可以在没有 API 密钥的情况下使用 Claude Max 订阅吗？
• 你们支持 Claude 订阅身份验证（Claude Pro 或 Max）吗？
• 为什么我会看到来自 Anthropic 的 HTTP 429 rate_limit_error 错误？
• 支持 AWS Bedrock 吗？
• Codex 身份验证如何工作？
• 为什么 OpenClaw 仍会提到旧版 OpenAI Codex 前缀？
• 为什么 Codex OAuth 限制会与 ChatGPT 网页版不同？
• 你们支持 OpenAI 订阅身份验证（Codex OAuth）吗？
• 我可以使用 Gemini CLI 或 Antigravity OAuth 吗？
• 本地模型用于随意聊天可以吗？
• 如何将托管模型流量保持在特定区域？
• 我必须购买 Mac mini 才能安装它吗？
• 我需要 Mac mini 才能支持 iMessage 吗？
• 如果我购买 Mac mini 来运行 OpenClaw，能否将其连接到我的 MacBook Pro？
• 我可以使用 Bun 吗？
• Telegram：allowFrom 中应该填写什么？
• 多个人可以共用一个 WhatsApp 号码但使用不同的 OpenClaw 实例吗？
• 我可以运行一个“快速聊天”代理和一个“专用于编码的 Opus”代理吗？
• Homebrew 在 Linux 上能用吗？
• 可修改的 git 安装与 npm 安装之间的区别
• 以后可以在 npm 和 git 安装之间切换吗？
• 我应该在笔记本电脑还是 VPS 上运行 Gateway？
• 在专用机器上运行 OpenClaw 有多重要？
• 最低 VPS 要求是什么？推荐的操作系统是什么？
• 我可以在虚拟机中运行 OpenClaw 吗？要求是什么？

相关¶

• FAQ - 主 FAQ（模型、会话、网关、安全性等）
• Models FAQ - 模型默认值、选择、别名、切换、故障转移及认证配置文件
• Install overview
• Getting started
• Troubleshooting