跳转至

提供商与托管

提供商身份验证、模型、硬件和托管问答。有关安装、入门和 首次运行故障,请参阅 FAQ:快速入门和首次运行设置。

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

当前时间窗口内,您的 Anthropic 配额/速率限制 已用尽。在 Claude CLI 中,请等待窗口重置或升级您的套餐。如果使用 Anthropic API key, 请在 Anthropic Console 中检查用量/账单,并根据需要提高限制。

如果消息具体为 Extra usage is required for long context requests, 则请求正在尝试使用 Anthropic 的 1M 上下文窗口(一个支持 GA 的 1M Claude 4.x 模型,或旧版 params.context1m: true 配置),而您当前的凭据不符合 长上下文计费条件。

设置一个 回退模型,以便在提供商受到速率限制时 OpenClaw 仍能继续回复。 参见 模型、OAuth 以及 Anthropic 429 长上下文需要额外用量。

是否支持 AWS Bedrock?

支持。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 兼容代理仍然是一个有效选项。

Codex 身份验证如何工作?

OpenClaw 通过 OAuth(ChatGPT 登录)支持 OpenAI Codex。全新 设置且没有主模型时,会使用精确的 openai/gpt-6-astra 进行 ChatGPT/Codex 订阅身份验证,并配合原生 Codex app-server 执行。 重新身份验证会保留现有的显式模型,包括 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 配置文件,也可用于代理 模型。参见 模型提供商 和 入门(CLI)。

为什么 OpenClaw 仍然提到旧版 OpenAI Codex 前缀?

openai 是当前用于 OpenAI API keys 和 ChatGPT/Codex OAuth 的提供商和身份验证配置文件 id - OpenAI Codex 已并入其中。您仍可能在旧配置和迁移警告中看到旧版 openai-codex 前缀:

  • openai/gpt-6-astra = 使用原生 Codex 运行时进行代理轮次的全新 ChatGPT/Codex 订阅设置。
  • openai/gpt-5.5 = 现有配置或没有 GPT-5.6 访问权限的账户的显式受支持选择。
  • 旧版 openai-codex/* 模型引用 = 由 openclaw doctor --fix 修复的旧版路由。
  • openai/gpt-5.5 加上有序的 openai API-key 配置文件 = 用于 OpenAI 代理模型的 API-key 身份验证。
  • 旧版 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 限制可能与 ChatGPT 网页版不同?

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

openclaw models status 显示当前可见的提供商用量/配额窗口,但 不会凭空生成或将 ChatGPT 网页版权益规范化为直接 API 访问。对于 直接 OpenAI Platform 计费/限制路径,请使用带 API key 的 openai/*。

是否支持 OpenAI 订阅身份验证(Codex OAuth)?

是的,完全支持。OpenAI 明确允许在外部 工具/工作流(如 OpenClaw)中使用订阅 OAuth。入门流程可以为您运行 OAuth 流程。

参见 OAuth、模型提供商 以及 入门(CLI)。

我可以使用 Gemini CLI 或 Antigravity OAuth 吗?

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

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

详情:Google、模型提供商。

本地模型适合随意聊天吗?

通常不适合。OpenClaw 需要大上下文 + 强安全性;小型显卡会截断上下文 并跳过提供商端安全过滤器。如果必须,请在本地运行您能运行的最大模型构建 (LM Studio)- 参见 本地模型。更小/量化 模型会增加提示注入风险 - 参见 安全。

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

选择区域固定端点。OpenRouter 为 MiniMax、Kimi、 和 GLM 提供美国托管选项;选择美国托管变体可将数据保留在区域内。您仍可以 使用 models.mode: "merge" 将这些与 Anthropic/OpenAI 一起列出,以便在尊重您选择的区域化提供商的同时保持回退可用。

我必须买一台 Mac Mini 才能安装这个吗?

不需要。OpenClaw 可在 macOS 或 Linux(Windows 通过 WSL2)上运行。Mac mini 是常见的 常开主机选择,但小型 VPS、家用服务器或树莓派级别的设备也可以。

你只需要一台 Mac 用于仅限 macOS 的工具。对于 iMessage,可在任何已登录 Messages 的 Mac 上配合 imsg 使用 iMessage;如果 Gateway 运行在 Linux 或其他地方, 请将 channels.imessage.cliPath 设置为在该 Mac 上运行 imsg 的 SSH 包装器。对于其他 仅限 macOS 的工具,请在 Mac 上运行 Gateway,或配对 macOS 节点。

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

我需要 Mac mini 才能支持 iMessage 吗?

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

常见设置:

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

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

如果我买一台 Mac mini 来运行 OpenClaw,能把它连接到我的 MacBook Pro 吗?

可以。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。

我可以使用 Bun 吗?

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

Telegram:allowFrom 里应该填什么?

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 号码配合不同的 OpenClaw 实例?

可以,通过多智能体路由。将每个发送者的 WhatsApp 私信(peer: { kind: "direct", id: "+15551234567" })绑定到不同的 agentId,让每个人拥有自己的工作区和会话存储。回复仍然来自同一个 WhatsApp 账号;私信访问控制(channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom)是按账号全局的。参见 多智能体路由 和 WhatsApp。

我可以同时运行一个“快速聊天”智能体和一个“用于编码的 Opus”智能体吗?

可以。使用多智能体路由:为每个智能体配置自己的默认模型,然后将入站 路由(提供商账号或特定对端)绑定到每个智能体。示例配置: 多智能体路由。另请参阅 模型 和 配置。

Homebrew 在 Linux 上能用吗?

可以,通过 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 时优先使用。

可自由修改的 git 安装与 npm 安装的区别
  • 可自由修改(git)安装: 完整的源码检出,可编辑,最适合贡献者。你在本地构建,并且可以修补代码/文档。
  • npm 安装: 全局 CLI 安装,没有仓库,最适合“直接运行”。更新来自 npm dist-tags。

文档:快速入门、更新。

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

可以,在现有安装上使用 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

备份提示:磁盘上数据所在位置。

我应该在笔记本电脑还是 VPS 上运行 Gateway?

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

笔记本电脑(本地 Gateway)

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

VPS / 云

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

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

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

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

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

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

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

VPS 的最低要求和建议操作系统是什么?
  • 绝对最低要求: 1 vCPU、1 GB 内存、约 500 MB 磁盘。
  • 建议配置: 1-2 vCPU、2 GB 以上内存,以留出余量(日志、媒体、多通道)。节点工具和浏览器自动化可能消耗大量资源。

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

文档:Linux、VPS 托管。

我可以在虚拟机中运行 OpenClaw 吗?有什么要求?

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

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

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

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw