ChromeClaw 配置多模型 API 完整指南

2026年3月13日

ChromeClaw 是一款运行在 Chrome 浏览器中的 AI Agent 扩展，它无需服务器，直接通过浏览器侧边栏即可与各种大语言模型对话。本文将详细介绍如何在 ChromeClaw 中配置不同的 LLM API，提供多种接入方案，并重点推荐高性价比的 Defapi 平台。

简介

ChromeClaw 基于 OpenClaw 项目设计，采用现代浏览器沙箱技术，在保障安全性的同时提供了强大的 AI 对话能力。与传统需要部署服务器的 AI 应用不同，ChromeClaw 只需安装 Chrome 扩展程序，配置好 API Key 即可使用。

ChromeClaw 支持的主流 LLM 提供商包括 OpenAI、Anthropic、Google，以及聚合平台 OpenRouter。更重要的是，它支持自定义 OpenAI 兼容端点，这意味着你可以接入任何遵循标准协议的第三方 AI 服务，包括本文推荐的 Defapi 平台。

官方 API 接入方法

OpenAI 配置

在 ChromeClaw 的 Options 页面中，进入 Models 面板，点击 Add Model 进行配置：

  • Provider: 选择 openai
  • Model ID: 输入 gpt-4o（或其他你需要的模型）
  • API Key: 填入你的 OpenAI API Key
  • Base URL: 保持默认的 https://api.openai.com/v1

Anthropic Claude 配置

Anthropic 的 Claude 系列模型以其出色的推理能力和长上下文处理著称：

  • Provider: 选择 anthropic
  • Model ID: 输入 claude-sonnet-4-5-20250929（推荐）或 claude-opus-4.5
  • API Key: 填入你的 Anthropic API Key
  • Base URL: 保持默认的 https://api.anthropic.com

Google Gemini 配置

Google 的 Gemini 系列提供出色的多模态能力：

  • Provider: 选择 google
  • Model ID: 输入 gemini-2.0-flash（推荐）或 gemini-1.5-pro
  • API Key: 填入你的 Google AI Studio API Key
  • Base URL: 保持默认的 https://generativelanguage.googleapis.com

OpenRouter 聚合平台

OpenRouter 是一个模型聚合平台，它汇集了众多 AI 模型的 API 接口，通过统一的 API 提供访问。使用 OpenRouter 的优势在于可以通过一个端点访问多个提供商的模型，并且支持灵活的计费方式。

配置方法：

  • Provider: 选择 openrouter
  • Model ID: 输入如 openai/gpt-4o 或 anthropic/claude-3.5-sonnet
  • API Key: 填入 OpenRouter API Key
  • Base URL: 保持 https://openrouter.ai/api/v1

Defapi 平台接入（推荐）

Defapi 平台提供官方半价的 AI API 服务，兼容主流的 OpenAI、Anthropic 和 Google Gemini 协议。对于希望控制成本的用户来说，这是一个极具性价比的选择。

Defapi 核心优势

  1. 价格优势: 仅为官方价格的 50%，大幅降低使用成本
  2. 多协议支持: 全面支持 v1/chat/completions、v1/messages、v1beta 等接口
  3. 模型丰富: 覆盖 OpenAI、Anthropic、Google 等主流模型
  4. 稳定可靠: 提供与官方 API 兼容的接口

使用 v1/chat/completions 接口

这是最通用的接入方式，适用于大多数支持 OpenAI 兼容协议的模型：

  • Provider: 选择 custom
  • Model ID: 如 openai/gpt-4o 或 google/gemini-2.0-flash
  • API Key: 填入你的 Defapi API Key
  • Base URL: https://api.defapi.org/v1
  • API Format: 选择 openai-completions

使用 v1/messages 接口

如果需要使用 Anthropic Claude 模型，可以通过自定义端点配置：

  • Provider: 选择 custom
  • Model ID: 如 anthropic/claude-sonnet-4-5-20250929
  • API Key: 填入你的 Defapi API Key
  • Base URL: https://api.defapi.org/v1
  • API Format: 选择 openai-completions

使用 v1beta 接口

对于 Google Gemini 模型，Defapi 提供了专门的接口：

  • Provider: 选择 custom
  • Model ID: 如 google/gemini-2.0-flash
  • API Key: 填入你的 Defapi API Key
  • Base URL: https://api.defapi.org
  • API Format: 选择 openai-completions

验证配置

完成配置后，ChromeClaw 提供了连接测试功能。在模型配置对话框中，点击 "Test Connection" 按钮，系统会向 API 端点发送测试请求并返回结果。

如果测试成功，你会看到绿色勾选图标；如果是失败，会显示红色叉号并给出错误信息。常见的错误包括：

  • 401 Unauthorized: API Key 无效或过期
  • 404 Not Found: Base URL 配置错误或模型 ID 不存在
  • Connection Failed: 网络问题或 Base URL 不可达

ChromeClaw 的内部机制

ChromeClaw 的模型接入核心逻辑位于 model-adapter.ts 文件中。当用户发起对话请求时，系统会通过 chatModelToPiModel 函数将配置转换成 pi-mono 库所需的格式。这个转换过程会根据不同的 provider 类型设置相应的 API 端点和认证头。

值得注意的是，ChromeClaw 使用流式响应（Streaming）来提供实时对话体验。当模型开始生成回复时，UI 会逐步显示内容，而不是等待完整响应。这不仅提升了用户体验，也让你能够尽早看到模型的思考过程。

ChromeClaw 还支持工具调用（Tool Calling）功能，这意味着模型可以主动调用你配置的外部工具来完成任务。要启用此功能，只需在模型配置中勾选 "supportsTools" 选项即可。

常见应用场景

1. 代码审查与优化

结合 ChromeClaw 的浏览器自动化工具，你可以让它分析当前网页的代码结构，提出优化建议。这对于前端开发者来说是一个实时的代码助手。

2. 内容创作辅助

无论是撰写博客文章、生成营销文案，还是翻译多语言内容，配置好支持长上下文的模型后，ChromeClaw 可以成为你的创作伙伴。

3. 智能客服系统

ChromeClaw 支持 WhatsApp 和 Telegram 频道接入，你可以将其配置为自动回复客服机器人，处理常见问题解答。

4. 数据分析与可视化

通过浏览器自动化工具，ChromeClaw 可以抓取网页数据并进行初步分析，帮助你快速获取信息洞察。

5. 深度研究任务

ChromeClaw 内置了 Deep Research 工具，可以进行多步骤自主研究，自动搜索、获取和综合信息，适合需要深入了解某个主题的场景。

本地模型选项

如果你对隐私有特殊要求，或者希望完全不依赖外部 API，ChromeClaw 也支持本地模型运行。通过 WebGPU 加速，可以在浏览器中直接运行轻量级的本地模型，如 Qwen3-0.6B 等。

要启用本地模型，需要在项目配置中设置 CEB_ENABLE_WEBGPU_MODELS=true 环境变量。本地模型的优势是完全离线可用，但受限于浏览器性能和模型大小，能力相对云端模型较弱。

Updated 2026年3月13日