提供商与托管

您当前的 Anthropic 配额/速率限制 在当前窗口内已耗尽。在 Claude CLI 上，请等待窗口重置或升级您的套餐。在 Anthropic API 密钥上， 请在 Anthropic Console 中检查使用量/计费情况，并根据需要提高限额。

如果消息具体显示为 Extra usage is required for long context requests， 则说明请求正在尝试使用 Anthropic 的 1M 上下文窗口（支持 GA 的 1M Claude 4.x 模型，或旧版 params.context1m: true 配置），而您当前的凭证不符合 长上下文计费资格。

设置一个后备模型（fallback model），以便在提供商被限流时 OpenClaw 仍能继续回复。 请参阅模型、OAuth 和 Anthropic 429 长上下文需要额外使用量。

支持的。OpenClaw 内置了 Amazon Bedrock (Converse) 提供商。当存在 AWS 环境变量 标记（AWS_ACCESS_KEY_ID、AWS_PROFILE、AWS_BEARER_TOKEN_BEDROCK）时， OpenClaw 会自动启用隐式 Bedrock 提供商进行模型发现；否则请设置 plugins.entries.amazon-bedrock.config.discovery.enabled: true 或添加手动提供商条目。 请参阅 Amazon Bedrock 和 模型提供商。 如果您更倾向于托管密钥流程，在 Bedrock 前置一个兼容 OpenAI 的代理仍然是有效的选项。

OpenClaw 通过 OAuth（ChatGPT 登录）支持 OpenAI Codex。全新的、未设置主模型的 安装会使用精确的 openai/gpt-6-astra 进行 ChatGPT/Codex 订阅认证，并配合原生 Codex 应用服务器执行。重新认证会保留现有的显式模型，包括 openai/gpt-5.5。 如果 Codex 工作区未提供 GPT-5.6，请显式选择 openai/gpt-5.5；OpenClaw 不会 静默降级。旧版 Codex 前缀的模型引用属于遗留配置，可通过 openclaw doctor --fix 修复。对于非 agent 的 OpenAI API 接口，仍可直接使用 OpenAI API 密钥访问， 并且通过有序的 openai API 密钥配置文件，也可用于 agent 模型。 请参阅模型提供商和 初始设置（CLI）。

openai 是当前 OpenAI API 密钥和 ChatGPT/Codex OAuth 的提供商及认证配置文件 ID—— OpenAI Codex 已并入其中。在旧配置和迁移警告中，您仍可能看到旧版的 openai-codex 前缀：

• openai/gpt-6-astra = 全新的 ChatGPT/Codex 订阅设置，使用原生 Codex 运行时处理 agent 轮次。
• openai/gpt-5.5 = 为现有配置或无 GPT-5.6 访问权限的账户提供的显式受支持选择。
• 旧版 openai-codex/* 模型引用 = 由 openclaw doctor --fix 修复的旧版路由。
• openai/gpt-5.5 加上有序的 openai API 密钥配置文件 = 针对 OpenAI agent 模型的 API 密钥认证。
• 旧版 openai-codex 认证配置文件 ID = 由 openclaw doctor --fix 迁移的旧版 ID。

想要直接使用 OpenAI Platform 计费？设置 OPENAI_API_KEY。想要 ChatGPT/Codex 订阅认证？运行 openclaw models auth login --provider openai。请将模型引用保留在 规范的 openai/* 提供商下。全新的订阅设置使用精确的 openai/gpt-6-astra； doctor 会修复旧版 Codex 前缀的引用，而不会升级显式的 openai/gpt-5.5 选择。

Codex OAuth 使用由 OpenAI 管理、取决于套餐的配额窗口，即使在同一账户上， 这些窗口也可能与 ChatGPT 网站/应用上的体验不同。

openclaw models status 会显示当前可见的提供商使用量/配额窗口，但不会 凭空捏造 ChatGPT 网页版的权益，也不会将其归一化为直接 API 访问。对于直接 使用 OpenAI Platform 计费/限制的路径，请使用带有 API 密钥的 openai/*。

是的，完全支持。OpenAI 明确允许在 OpenClaw 等外部工具/工作流中使用订阅 OAuth。 初始设置可以为您运行 OAuth 流程。

请参阅 OAuth、模型提供商 和 初始设置（CLI）。

OpenClaw 不提供新的 Gemini CLI OAuth 或 Antigravity OAuth 设置。 请改用 AI Studio API 密钥或 Vertex AI 连接 Google。

可选的 google-gemini-cli 运行时仍然可用于使用受支持的 Google API 密钥配置文件 的高级设置。现有的有效旧版 Gemini CLI OAuth 配置文件出于兼容性考虑仍可执行， 但 OpenClaw 无法创建或修复它们。

详情：Google、模型提供商。

通常不适合。OpenClaw 需要大上下文 + 强大的安全性；小型模型会截断上下文 并跳过提供商侧的安全过滤器。如果必须使用，请在本地运行您能运行的最大 模型构建（LM Studio）——请参阅本地模型。 较小/量化模型会增加提示注入风险——请参阅安全。

选择区域固定的端点。OpenRouter 为 MiniMax、Kimi 和 GLM 提供了美国托管的选项； 选择美国托管的变体以将数据保留在区域内。您仍然可以通过 models.mode: "merge" 将这些提供商与 Anthropic/OpenAI 并列列出，这样在尊重 您所选区域提供商的同时，后备模型仍然可用。

不需要。OpenClaw 可以在 macOS 或 Linux（Windows 通过 WSL2）上运行。Mac mini 是一种常见的常驻主机选择，但小型 VPS、家庭服务器或 Raspberry Pi 级别的设备也可以。

你只在使用仅限 macOS 的工具时才需要 Mac。对于 iMessage，请在任意已登录 Messages 的 Mac 上配合 imsg 使用 iMessage；如果 Gateway 运行在 Linux 或其他地方，请将 channels.imessage.cliPath 设置为在该 Mac 上运行 imsg 的 SSH wrapper。对于其他仅限 macOS 的工具，请在 Mac 上运行 Gateway，或配对 macOS 节点。

文档：iMessage、Nodes、Mac 远程模式。

你需要某台已登录 Messages 的 macOS 设备——不一定是 Mac mini，任何 Mac 都可以。配合 imsg 使用 iMessage；Gateway 可以运行在那台 Mac 上，也可以通过 SSH wrapper cliPath 运行在其他地方。

常见设置：

• Gateway 位于 Linux/VPS 上，channels.imessage.cliPath 设置为一个 SSH wrapper，用于在已登录 Messages 的 Mac 上运行 imsg。
• 所有内容都放在一台 Mac 上，这是最简单的单机设置。

文档：iMessage、Nodes、Mac 远程模式。

可以。Mac mini 可以运行 Gateway，而你的 MacBook Pro 作为节点（配套设备）连接。节点不运行 Gateway——它们在该设备上添加屏幕/摄像头和 system.run 等功能。Mac 节点还可以在其原生面板中展示托管的小组件。

常见模式：Gateway 运行在常驻的 Mac mini 上；MacBook Pro 运行 macOS 应用或节点主机，并与 Gateway 配对。可使用 openclaw nodes status / openclaw nodes list 检查。

文档：Nodes、Nodes CLI。

可以。Node 仍然是主要、默认且推荐的运行时，但 Bun 1.4+ 配合具有 WAL 重置安全性的 node:sqlite，可以作为显式选择来运行 CLI、Gateway 和受管节点主机。Bun 也可以运行包脚本；依赖安装请使用 pnpm install。

channels.telegram.allowFrom 指的是人类发送者的 Telegram 用户 ID（数字），而不是机器人用户名。安装向导只要求数字用户 ID；openclaw doctor --fix 可以尝试解析旧的 @username 条目。

更安全（不依赖第三方机器人）：给你的机器人发私信，运行 openclaw logs --follow，读取 from.id。

官方 Bot API：给你的机器人发私信，调用 https://api.telegram.org/bot<bot_token>/getUpdates，读取 message.from.id。

第三方（隐私性较低）：给 @userinfobot 或 @getidsbot 发私信。

参见 Telegram 访问控制。

可以，通过多代理路由。将每个发送者的 WhatsApp 私信（peer: { kind: "direct", id: "+15551234567" }）绑定到不同的 agentId，让每个人拥有自己的工作区和会话存储。回复仍然来自同一个 WhatsApp 账户；DM 访问控制（channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom）按账户全局生效。参见 Multi-Agent Routing 和 WhatsApp。

可以。使用多代理路由：为每个代理设置自己的默认模型，然后将入站路由（提供方账户或特定对端）绑定到每个代理。示例配置：Multi-Agent Routing。另请参阅 模型 和 配置。

可以，通过 Linuxbrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

通过 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。

• Hackable（git）安装：完整源码检出，可编辑，最适合贡献者。你可以在本地构建，并能修补代码/文档。
• npm 安装：全局 CLI 安装，无仓库，最适合“直接运行”。更新来自 npm dist-tags。

文档：入门、更新。

可以，在现有安装上使用 openclaw update --channel ...。这不会删除你的数据——只有 OpenClaw 代码安装会改变。状态目录（~/.openclaw）和工作区（~/.openclaw/workspace）保持不动。

从 npm 切换到 git：

openclaw update --channel dev

从 git 切换到 npm：

openclaw update --channel stable

可以先添加 --dry-run 预览计划中的模式切换。更新程序会运行 Doctor 后续检查，刷新目标渠道的插件源，并重启 gateway，除非你传入 --no-restart。

安装程序也可以强制使用任一模式：

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

想要 24/7 的可靠性？使用 VPS。想要最低的摩擦且能接受休眠/重启？在本地运行。

笔记本电脑（本地 Gateway）

• 优点： 无服务器成本，直接访问本地文件，实时浏览器窗口。
• 缺点： 休眠/网络断开会断开连接，操作系统更新/重启会中断运行，必须保持唤醒状态。

VPS / 云

• 优点： 始终在线，网络稳定，没有笔记本电脑休眠问题，更容易保持运行。
• 缺点： 通常无头（使用截图），只能远程访问文件，更新需要 SSH。

WhatsApp/Telegram/Slack/Mattermost/Discord 从 VPS 上都能正常工作——真正的权衡在于无头浏览器与可见窗口之间的选择。参见 浏览器。

默认建议：如果你之前遇到过网关断开连接，那就用 VPS；如果你正在积极使用 Mac 并希望获得本地文件访问或可见浏览器 UI 自动化，本地运行则非常合适。

不是必须的，但为了可靠性和隔离性，建议这样做。

• 专用主机（VPS/Mac mini/Raspberry Pi）： 始终在线，更少休眠/重启中断，权限更清晰，更容易保持运行。
• 共享的笔记本电脑/台式机： 适合测试和主动使用，但机器休眠或更新时会有暂停。

两全其美：将 Gateway 放在专用主机上，并将你的笔记本电脑作为 节点 配对，用于本地屏幕/摄像头/执行工具。参见 节点 和 安全。

• 绝对最低要求： 1 vCPU、1 GB 内存、约 500 MB 磁盘。
• 建议配置： 1-2 vCPU、2 GB 以上内存，以留出余量（日志、媒体、多通道）。节点工具和浏览器自动化可能消耗大量资源。

操作系统：Ubuntu LTS（或任何现代 Debian/Ubuntu）——测试最充分的 Linux 安装路径。

文档：Linux、VPS 托管。

可以。把虚拟机当作 VPS 来对待：它需要始终在线、可访问，并且有足够的内存来运行 Gateway 以及你启用的任何通道。

• 绝对最低要求： 1 vCPU、1 GB 内存。
• 建议配置： 2 GB 以上内存，用于多通道、浏览器自动化或媒体工具。
• 操作系统： Ubuntu LTS 或其他现代 Debian/Ubuntu。

在 Windows 上，使用 Windows Hub 进行桌面设置，或使用 WSL2 运行 Linux 风格的 Gateway 虚拟机，以获得广泛的工具兼容性。参见 Windows、VPS 托管。 在虚拟机中运行 macOS：参见 macOS 虚拟机。