OpenClaw
AiCookie 开发者文档
OpenClaw
使用 OpenAI、Claude 或 Gemini 模型将 OpenClaw 接入 AiCookie
先完成安装和基础设置,再从 OpenAI、Claude、Gemini 中选择一种接入方式,即可通过 OpenClaw Dashboard 使用 AiCookie。
1. 安装并进入配置向导
如果还没有安装 OpenClaw,根据系统运行官方安装命令。安装完成后会自动进入配置向导。
在 PowerShell 中运行:
在 Cmd 中运行:
在终端中运行:
如果已经安装 OpenClaw,运行下面的命令重新进入配置向导:
2. 完成基础设置
进入配置向导后,按下面的方式选择:
-
Continue? 选择 Yes。
-
Help make OpenClaw better? 选择 No thanks。
-
Setup mode 选择 QuickStart。
-
Agent 名称保持默认的 main,直接按 Enter。
-
Model/auth provider 选择 Skip for now。
-
Default model 选择 Keep current。这里显示的模型名称不同也没关系,后面会重新写入 AiCookie 配置。
-
Select channel 选择 Skip for now。
-
Search provider 选择 Skip for now。
-
Install missing skill dependencies 选择 Skip for now。这是多选页面,需要先按 Space 选中,再按 Enter 提交。
其余设置保持默认,或选择 Skip for now。
AiCookie 是自定义 Provider,因此先跳过内置模型配置,下一步再写入 AiCookie 的 Key 和请求地址。
下面三种接入方式使用不同的 Provider 名称。你可以只配置一种,也可以继续配置其他模型;后续配置不会覆盖已经添加的模型。
3. OpenAI 接入
-
前往 AiCookie API Key 页面,选择 Codex(可外接) 分组并创建 API Key。
-
根据你的系统选择对应命令,把其中的 sk-your-api-key 换成刚创建的 API Key,再将整段命令复制到终端运行。
4. Claude 接入
-
前往 AiCookie API Key 页面,选择 Claude Code(可外接) 分组并创建 API Key。
-
根据你的系统选择对应命令,把其中的 sk-your-api-key 换成刚创建的 API Key,再将整段命令复制到终端运行。
5. Gemini 接入
-
前往 AiCookie API Key 页面,选择 Gemini 分组并创建 API Key。
-
根据你的系统选择对应命令,把其中的 sk-your-api-key 换成刚创建的 API Key,再将整段命令复制到终端运行。
6. 检查配置
完成任意一种接入配置后,运行下面的命令检查配置:
看到 Config valid,并且第二条命令显示刚配置的模型,即表示配置已经写入:
- OpenAI:aicookie-openai/gpt-6-astra
- Claude:aicookie-claude/claude-sonnet-5
- Gemini:aicookie-gemini/gemini-3.8-flash
7. 打开 Dashboard 验证
重新启动 Gateway,再打开 Dashboard:
浏览器打开后:
- 新建一个会话。
- 点击输入框下方的模型名称,选择刚配置的模型。
- 发送一条消息。
最后配置的模型会成为新会话的默认模型;已有会话可能继续使用此前选中的模型,因此验证时需要新建会话或手动切换。
OpenClaw 能正常回复,并且 AiCookie 的用量记录中出现了对应模型的请求,即表示接入成功。
如果请求返回 401、403、429,请查看 错误码。如果模型不可用,请确认 API Key 来自对应分组,并检查 Key 和请求地址。