OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Cloudflare AI Gateway

这页说明书在教我们怎么用 Cloudflare AI Gateway 这个“聪明的小门卫”。这个小门卫站在很多 AI 服务(比如 Claude)的家门口,可以帮我们数一数用了多少次、记一记回答、管一管谁能进来。当你想让 OpenClaw 通过这个小门卫去和 Claude 聊天时,就要看看这页,它会告诉你需要准备哪些“钥匙”和“地址”。

五岁小孩版解释

Cloudflare AI Gateway 就像一个站在很多 AI 服务家门口的“小门卫”。它的工作是在你的 OpenClaw 和真正的 AI(比如 Claude)之间帮忙。这个小门卫可以帮你数数用了多少次 AI、把 AI 的回答先记下来(这样下次问一样的问题就不用等啦),还可以管一管谁可以进来用。这页就是教你怎么让 OpenClaw 通过这个小门卫去找到 Claude 聊天的。

要开始之前,你需要准备几样东西。首先,你需要一个“小门卫”的地址,它长得像这样:https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic。这里的 <account_id><gateway_id> 就像是你家门牌号,需要换成你自己的。然后,你还需要一把“钥匙”,这把钥匙的名字叫 CLOUDFLARE_AI_GATEWAY_API_KEY。不过,因为我们是去找 Claude 玩,所以这把钥匙其实是 Claude 给你的那把钥匙(就是你的 Anthropic API key)。

好了,我们开始第一步吧!

  1. 告诉 OpenClaw 小门卫的钥匙在哪里。 这一步是让 OpenClaw 知道你的“钥匙”放在哪里。你需要在电脑上打开一个叫“终端”或“命令行”的窗口,然后输入这样一句话: openclaw onboard --auth-choice cloudflare-ai-gateway-api-key 输入后,OpenClaw 会问你钥匙是什么,你把它放进去就行啦。

  2. 告诉 OpenClaw 我们主要想找哪个 AI 朋友玩。 这一步是设置一个默认的 AI 模型,你可以把它想成是 OpenClaw 最常去找的“好朋友”。我们需要在一个叫 openclaw.json 的配置文件里,写上这个好朋友的名字。它的名字是:cloudflare-ai-gateway/claude-sonnet-4-5

如果你不想让 OpenClaw 一句一句地问你,想一次把所有信息都告诉它,可以这样做: 在一个命令里,把所有东西都告诉 OpenClaw。你需要准备好你的“账户ID”、“小门卫ID”和“钥匙”,然后输入一长串命令,就像这样: openclaw onboard --non-interactive --mode local --auth-choice cloudflare-ai-gateway-api-key --cloudflare-ai-gateway-account-id "你的账户ID" --cloudflare-ai-gateway-gateway-id "你的小门卫ID" --cloudflare-ai-gateway-api-key "你的钥匙"

这里有个要小心的地方! 如果你的 Cloudflare 小门卫自己还有一把锁(就是开启了 Gateway 认证),那么除了 Claude 的钥匙,你还需要多带一把“小门卫自己的钥匙”。你需要在一个叫 headers 的地方,加上这样一行信息:"cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>"。这里的 <cloudflare-ai-gateway-token> 就是小门卫给你的另一把特殊钥匙。

最后还有一个重要的提醒! 如果你的 OpenClaw 是像一个“后台小精灵”一样一直在运行的(比如用 launchd 或 systemd 启动的),你一定要确保那把叫 CLOUDFLARE_AI_GATEWAY_API_KEY 的钥匙,这个小精灵也能拿到。通常可以把钥匙放在 ~/.openclaw/.env 这个文件里,或者通过 env.shellEnv 告诉它。