FAQ
FAQ：提供商、硬件和托管
提供商身份验证、模型、硬件和托管问答。有关安装、载入和首次运行失败的信息，请参阅 FAQ：快速启动和首次运行设置。
为什么我从 Anthropic 看到 HTTP 429 rate_limit_error？
您的 Anthropic quota/rate 限制 在当前窗口中已用完。在 Claude CLI 上，等待窗口重置或升级您的计划。在 Anthropic API key 上，检查 Anthropic 控制台中的 usage/billing 并根据需要提高限制。
如果消息具体为 Extra usage is required for long context requests，则请求正在尝试使用 Anthropic 的 1M 上下文窗口（GA- 功能的 1M Claude 4.x 模型或旧版 params.context1m: true 配置），并且您当前的凭据不符合长上下文计费条件。
设置 后备模型 ，以便 OpenClaw 在提供程序受到速率限制时保持回复。请参阅 Models、OAuth 和 长上下文所需的 Anthropic 429 额外使用 。
是否支持 AWS 基岩版？
是的。 OpenClaw 具有捆绑的 Amazon Bedrock （Converse） 提供商。存在 AWS env 标记（AWS_ACCESS_KEY_ID、AWS_PROFILE、AWS_BEARER_TOKEN_BEDROCK）时，OpenClaw 自动启用隐式 Bedrock 提供程序以进行模型发现；否则设置 plugins.entries.amazon-bedrock.config.discovery.enabled: true 或添加手动提供程序条目。请参阅 Amazon Bedrock 和 模型提供商。如果您更喜欢托管密钥流，则 Bedrock 前面的 OpenAI- 兼容代理仍然是一个有效的选择。
Codex 身份验证如何工作？
OpenClaw 通过 OAuth 支持 OpenAI Codex（ChatGPT 登录）。没有主要模型的全新设置使用精确的 openai/gpt-6-astra 进行 ChatGPT/Codex 订阅身份验证以及本机 Codex 应用程序服务器执行。重新验证会保留现有的显式模型，包括 openai/gpt-5.5。如果 Codex 工作区未公开 GPT-5.6，则显式选择 openai/gpt-5.5； OpenClaw不会默默降级。旧版 Codex- 前缀模型参考是由 openclaw doctor --fix 修复的旧版配置。直接 OpenAI API-key 访问仍然可用于非代理 OpenAI API 表面，并且通过订购的 openai API-key 配置文件也可用于代理模型。请参阅 模型提供商 和 Onboarding （CLI）。
为什么 OpenClaw 仍然提到旧版 OpenAI Codex 前缀？
openai 是 OpenAI API 密钥和 ChatGPT/Codex OAuth 的当前提供商和身份验证配置文件 ID - OpenAI Codex 已折叠到其中。您可能仍会在旧配置和迁移警告中看到旧版 openai-codex 前缀：
openai/gpt-6-astra= 全新的 ChatGPT/Codex 订阅设置，具有用于代理轮流的本机 Codex 运行时。openai/gpt-5.5= 明确支持对没有 GPT-5.6 访问权限的现有配置或帐户的选择。- Legacy
openai-codex/*模型参考 = 由openclaw doctor --fix修复的旧路线。 openai/gpt-5.5加上有序的openaiAPI-key 配置文件 = 用于 OpenAI 代理模型的 API-key 身份验证。- Legacy
openai-codex身份验证配置文件 ID = 由openclaw doctor --fix迁移的旧 ID。
想要直接OpenAI平台计费吗？设置 OPENAI_API_KEY。想要ChatGPT/Codex订阅授权吗？运行 openclaw models auth login --provider openai。将模型参考保留在标准 openai/* 提供程序下。新的订阅设置使用精确的 openai/gpt-6-astra； doctor 修复了遗留的 Codex- 前缀引用，而不升级显式的 openai/gpt-5.5 选择。
为什么 Codex OAuth 限制与 ChatGPT Web 不同？
Codex OAuth 使用 OpenAI- 管理的、与计划相关的配额窗口，该窗口可能与 ChatGPT website/app 体验不同，即使在同一账户上也是如此。
openclaw models status 显示当前可见的提供者 usage/quota 窗口，但不会将 ChatGPT-web 权利发明或标准化为直接 API 访问。对于直接 OpenAI 平台 billing/limit 路径，请使用带有 API 密钥的 openai/*。
是否支持OpenAI订阅认证（Codex OAuth）？
我可以使用 Gemini CLI 或反重力 OAuth 吗？
本地模型OK适合休闲聊天吗？
如何将托管模型流量保留在特定区域？
选择区域固定的端点。 OpenRouter 公开了 MiniMax、Kimi 和 GLM 的 US- 托管选项；选择 US-hosted 变体将数据保留在区域内。您仍然可以将 Anthropic/OpenAI 与 models.mode: "merge" 一起列出，以便在尊重您选择的区域提供商的同时保留可用的备用方案。
我必须购买 Mac Mini 才能安装此软件吗？
否。OpenClaw 在 macOS 或 Linux 上运行（Windows 通过 WSL2）。 Mac mini 是一种流行的始终在线主机选择，但小型 VPS、家庭服务器或 Raspberry Pi-class 盒子也可以使用。
您只需要一台 Mac 用于 macOS- 的工具。对于 iMessage，请在登录消息的任何 Mac 上使用 iMessage 和 imsg - 如果网关在 Linux 或其他地方运行，请将 channels.imessage.cliPath 设置为运行 imsg 的 SSH 包装器在那台Mac上。对于其他 macOS-only 工具，请在 Mac 上运行网关或配对 macOS 节点。
我需要 Mac mini 才能支持 iMessage 吗？
如果我购买 Mac mini 来运行 OpenClaw，我可以将其连接到我的 MacBook Pro 吗？
我可以使用Bun吗？
是的。 Node 仍然是主要、默认和推荐的运行时，但 Bun 1.4.3+ 和 WAL- 重置安全 node:sqlite 可以作为显式选择运行 CLI、网关和受管节点主机。 Bun 还可以运行包脚本；使用 pnpm install 进行依赖安装。
Telegram：allowFrom 里面有什么？
channels.telegram.allowFrom 是 human 发送者的 Telegram 用户 ID（数字），而不是机器人用户名。安装程序仅要求提供数字用户 ID； openclaw doctor --fix 可以尝试解析旧版 @username 条目。
更安全（无需第三方机器人）：给你的机器人发 DM，运行 openclaw logs --follow，读取 from.id。
官方机器人 API：DM 您的机器人，调用 https://api.telegram.org/bot<bot_token>/getUpdates，读取 message.from.id。
第三方（不太私密）：DM @userinfobot 或 @getidsbot。
参见电报访问控制。
多个人可以将一个 WhatsApp 号码用于不同的 OpenClaw 实例吗？
是，通过 多代理路由。将每个发送者的 WhatsApp DM （peer: { kind: "direct", id: "+15551234567" }） 绑定到不同的 agentId，为每个人提供自己的工作区和会话存储。回复仍然来自同一个WhatsApp账户； DM 访问控制 （channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom） 对于每个帐户都是全局的。请参阅 多代理 Routing 和 WhatsApp。
我可以运行“快速聊天”代理和“Opus 用于编码”代理吗？
是的。使用多代理路由：为每个代理提供自己的默认模型，然后将入站路由（提供者帐户或特定对等点）绑定到每个代理。配置示例： 多代理 Routing。另请参见 Models 和 Configuration。
Homebrew 是否适用于 Linux？
是的，通过 Linuxbrew：
通过 systemd 运行 OpenClaw：确保服务 PATH 包含 /home/linuxbrew/.linuxbrew/bin （或您的 brew 前缀），以便 brew- 安装的工具在非登录 shell 中解析。最近的版本还在 Linux systemd 服务上预置常见用户 bin 目录（例如 ~/.local/bin、~/.npm-global/bin、~/.local/share/pnpm、~/.bun/bin）并尊重 PNPM_HOME、NPM_CONFIG_PREFIX、设置时为 BUN_INSTALL、VOLTA_HOME、ASDF_DATA_DIR、NVM_DIR 和 FNM_DIR。
可破解的 git 安装和 npm 安装之间的区别
我可以稍后在 npm 和 git 安装之间切换吗？
是的，与openclaw update --channel ...在现有安装上。这确实不删除您的数据- 只有OpenClaw代码安装更改。状态 （~/.openclaw）和工作区（~/.openclaw/workspace）保持原样。
npm 到 git：
git 到 npm：
添加--dry-run，先预览规划的模式切换。更新程序运行 Doctor 后续操作，刷新目标通道的插件源，并重新启动网关，除非您通过 --no-restart。
安装器也可以强制任一模式：
备份提示： 磁盘上的内容。
我应该在笔记本电脑还是 VPS 上运行网关？
想要 24/7 的可靠性吗？使用 VPS。想要最低的摩擦力，而您是 OK 和 sleep/restarts 吗？在本地运行它。
笔记本（本地 Gateway）
- **优点：**无服务器成本，直接访问本地文件，实时浏览器窗口。
- 缺点： sleep/network 断开它，OS updates/reboots 中断它，必须保持清醒。
VPS / 云
- **优点：**始终在线，网络稳定，没有笔记本电脑睡眠问题，更容易保持运行。
- **缺点：**经常无头（使用屏幕截图），仅远程文件访问，SSH需要更新。
WhatsApp/Telegram/Slack/Mattermost/Discord 在 VPS 上都可以正常工作 - 真正的权衡是无头浏览器与可见窗口。请参阅 Browser。
如果之前有过网关断开的情况，默认推荐：VPS；当您经常使用 Mac 并希望本地文件访问或可见浏览器 UI 自动化时，local 非常有用。