龙虾API接入教程 — 3步让龙虾（OpenClaw）变聪明

什么是 OpenClaw（龙虾）？

开源 AI Agent 平台，让 AI 不只是聊天，而是真正能做事

OpenClaw 是一个开源 AI Agent 平台，中文社区亲切地称它为"龙虾"。它能让 AI 真正操作你的电脑：读写文件、执行命令、搜索网页、发送消息、控制浏览器 — 不再是只会聊天的玩具，而是一个能帮你干活的智能助手。

无论你是想自动化日常工作，还是搭建复杂的 AI 工作流，OpenClaw 都是目前最灵活、最强大的开源方案之一。

开发者运维工程师产品经理创业团队自由职业者

为什么需要 ClawBrain？

单模型方案经常出错，ClawBrain 用多模型智能调度解决问题

单模型问题

~60%

成功率

单一模型 tool calling 经常失败：参数格式错误、工具选择不当、多步骤任务中途崩溃

ClawBrain 解决

95%

成功率

智能适配、错误恢复、提问优化、任务链保护，自动以最优策略处理每个任务

效果

10+

模型智能调度

Qwen、DeepSeek、MiniMax、Kimi、GLM 等 10+ 模型协同工作，每个任务自动分配最强模型

推荐：一键安装 Skill

安装 ClawBrain Boost，自动完成全部配置，无需手动编辑文件

🚀

ClawBrain Boost

四档模型自动切换 · 记忆不丢失 · 垂直场景加持 · 响应更快更准

            $ clawhub install clawbrain-boost
          

安装后自动配置：智能适配 · SOUL 优化 · 记忆压缩 · 垂直规则注入

Flash 0.5 Cr

Pro 1 Cr

Max 3 Cr

Auto 推荐

不想用 Skill？也可以手动配置（下方步骤 2）

3 步接入

整个过程不到 5 分钟，无需修改 OpenClaw 任何源码

1

注册获取 API Key

前往 ClawBrain 控制台注册账号，免费获取 API Key。每天有 50 Credits 免费额度，足够体验和开发使用。

前往控制台注册 →

2

配置 OpenClaw

编辑 ~/.openclaw/openclaw.json，把下面这段配置加进去，把 API Key 换成你的：

{
  "models": {
    "providers": {
      "clawbrain": {
        "baseUrl": "https://api.clawbrain.dev/v1",
        "apiKey": "你的 API Key",
        "api": "openai-completions",
        "models": [{
          "id": "clawbrain-auto",
          "name": "ClawBrain Auto",
          "input": ["text", "image"],
          "contextWindow": 128000,
          "maxTokens": 32768
        }, {
          "id": "clawbrain-pro",
          "name": "ClawBrain Pro",
          "input": ["text", "image"],
          "contextWindow": 64000,
          "maxTokens": 16384
        }, {
          "id": "clawbrain-max",
          "name": "ClawBrain Max",
          "input": ["text", "image"],
          "contextWindow": 128000,
          "maxTokens": 32768
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "clawbrain/clawbrain-auto"
      }
    }
  }
}

视觉理解已开启：配置中 "input": ["text", "image"] 表示支持图片输入。接入后可以直接给龙虾发图片，它会自动识别内容。

四个模型可选： clawbrain-auto 推荐，智能分发，简单任务秒回，复杂任务自动深度思考； clawbrain-flash 极速半价（0.5 Credits/次），简单任务秒回，省钱首选； clawbrain-pro 快速稳定，适合日常任务； clawbrain-max 深度思考，适合复杂任务和模糊指令。在 OpenClaw 中可随时切换。

3

重启验证

运行以下命令重启 OpenClaw gateway：

openclaw gateway restart

验证方法：在 OpenClaw 中执行一个简单任务，比如"帮我查看当前目录下的文件"。如果返回结果正常，说明接入成功。你也可以在控制台查看 API 调用记录确认。

✓

搞定！你的龙虾现在更聪明了。

SDK 快速开始

兼容 OpenAI SDK，一行代码即可调用 ClawBrain API

Py

Python 示例

使用 OpenAI 官方 SDK，只需修改 base_url 和 api_key：

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://api.clawbrain.dev/v1"
)

response = client.chat.completions.create(
    model="clawbrain-auto",  # 推荐：自动选择最优模型
    messages=[{"role": "user", "content": "帮我分析这段代码的性能问题"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

cURL

curl 示例

直接用命令行测试，快速验证 API 是否通畅：

curl https://api.clawbrain.dev/v1/chat/completions \
  -H "Authorization: Bearer 你的API-Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"clawbrain-auto","messages":[{"role":"user","content":"你好"}]}'

IDE 接入

除了 OpenClaw，ClawBrain 还可以接入主流 IDE，作为你的编码助手

1

Continue（VS Code / JetBrains）

最推荐的方案，支持 VS Code 和 IntelliJ / WebStorm / PyCharm 等全系列 JetBrains IDE。

安装：在 IDE 插件市场搜索 "Continue" 安装

配置：编辑 ~/.continue/config.json

{
  "models": [{
    "title": "ClawBrain Auto",
    "provider": "openai",
    "model": "clawbrain-auto",
    "apiBase": "https://api.clawbrain.dev/v1",
    "apiKey": "你的 API Key"
  }, {
    "title": "ClawBrain Max",
    "provider": "openai",
    "model": "clawbrain-max",
    "apiBase": "https://api.clawbrain.dev/v1",
    "apiKey": "你的 API Key"
  }]
}

2

CodeGPT（IntelliJ 系列）

JetBrains 专用插件，配置更简单。

安装：Settings → Plugins → 搜索 "CodeGPT" 安装

配置：Settings → Tools → CodeGPT

1. Provider 选择 Custom OpenAI

2. API URL: https://api.clawbrain.dev/v1/chat/completions

3. API Key: ct-你的key

4. Model: clawbrain-auto

3

Claude Code（终端 AI 编程助手）

Anthropic 官方 CLI 工具，ClawBrain 已兼容 Anthropic Messages API 格式。

配置：编辑 ~/.claude/settings.json，添加环境变量：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.clawbrain.dev",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_MODEL": "clawbrain-pro"
  }
}

模型选择：

clawbrain-pro — 日常编码，快速稳定

clawbrain-max — 复杂重构、架构设计

clawbrain-auto — 自动判断，推荐

4

Cline / Cursor（VS Code）

Cline：Settings → 选择 "OpenAI Compatible" → 填入 Base URL 和 API Key

Cursor：Settings → Models → Add Model → 选 OpenAI API

Base URL: https://api.clawbrain.dev/v1

API Key: ct-你的key

Model: clawbrain-auto（推荐）或 clawbrain-max（深度推理）

所有 IDE 通用：ClawBrain 同时兼容 OpenAI API 和 Anthropic Messages API 两种格式。OpenAI 兼容工具（Continue / Cursor / Cline）Base URL 填 https://api.clawbrain.dev/v1；Anthropic 兼容工具（Claude Code）Base URL 填 https://api.clawbrain.dev。模型推荐 clawbrain-auto。

接入后你能做什么

ClawBrain 让你的 AI Agent 能力大幅提升，适用于各种场景

微信/飞书机器人

接入企业微信、飞书等平台，打造智能聊天机器人，自动回复消息、处理指令

服务器监控

自动监控服务器状态，CPU 异常自动排查，日志分析，告警通知一条龙

文档生成

自动读取代码生成 API 文档、README、周报、技术方案，省去重复劳动

数据分析

自动抓取数据、清洗转换、统计分析、生成可视化图表，数据流水线全自动

团队协作

自动化站会流程、任务跟踪、进度报告，让团队协作更高效

智能客服

自动理解用户问题、查询知识库、生成回复、创建工单，客服自动化

视觉理解

发送图片给龙虾，自动识别内容：截图文字提取、图表数据分析、照片内容描述

v0.9 新能力亮点

更智能、更安全、更持久的 AI 体验

智能记忆

三层记忆自动积累（用户画像 + 知识库 + 对话摘要），虚拟标签按场景精准注入，越用越懂你。

输出验证

独立模型对复杂任务的输出进行二次校验——准确性、完整性、逻辑性、格式四维评分，不合格自动重新生成。

智能容错

空回复自动换模型重试、后端超时熔断秒级切换、压缩失败安全兜底。10 个模型动态健康监控，你感知不到后端波动。

超长对话

三层压缩 + 质量保底 + 失败硬截断兜底。v0.9 新增压缩摘要标签清洗和 200 字质量下限，关键信息不丢失。

模型选择指南

不确定选哪个模型？参考以下场景推荐

场景	推荐模型	Credits
日常对话、简单问答	`clawbrain-flash`	0.5
代码编写、文件操作、搜索	`clawbrain-pro`	1
复杂推理、多步规划、深度分析	`clawbrain-max`	3
不确定？交给 AI 判断	`clawbrain-auto`（推荐）	动态

常见问题

快速了解接入细节

需要修改 OpenClaw 源码吗？

不需要。ClawBrain 完全兼容 OpenAI API 格式，你只需要修改 OpenClaw 的配置文件（openclaw.json），把模型指向 ClawBrain 的 API 地址即可。零代码改动，无侵入式接入。

支持哪些模型？

ClawBrain 会自动为每个任务选择最优的响应策略。你不需要关心底层实现，ClawBrain 自动适配任务类型，给出最佳回答。

免费额度够用吗？

免费方案每天 50 Credits，适合个人开发和体验。如果需要更多 Credits，可以升级到 Pro 方案（99 元/月起），享受更多 Credits 和高级功能。

准备好让你的龙虾更聪明了吗？

免费注册，5 分钟完成接入

免费开始使用

让你的龙虾更聪明 — 3 步接入 ClawBrain