提供商与托管
提供商身份验证、模型、硬件和托管问答。有关安装、入门和 首次运行故障,请参阅 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加上有序的openaiAPI-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 流程。
我可以使用 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
无法创建或修复它们。
本地模型适合随意聊天吗?
通常不适合。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 节点。
我需要 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 上,这是最简单的单机设置。
如果我买一台 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 查看。
我可以使用 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:
git 切换至 npm:
先加上 --dry-run 预览计划中的模式切换。更新程序会运行 Doctor
后续检查,刷新目标渠道的插件源,并重启 gateway,
除非你传入 --no-restart。
安装程序也可以强制进入任一模式:
备份提示:磁盘上数据所在位置。
我应该在笔记本电脑还是 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 安装路径。
我可以在虚拟机中运行 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