核心功能模块

openclaw AI小龙虾攻略 2026-04-09 1

OPENCLAW API 是 AI小龙虾提供的官方应用程序编程接口，允许开发者将强大的多模态大模型能力（基于深度求索公司的 DeepSeek 模型）集成到自己的应用程序、网站或服务中，它提供了对话、推理、内容生成、文件处理和联网搜索等核心功能。

核心功能模块-第1张图片-官方获取 | OpenClaw下载 - openclaw官网

对话与文本生成

多轮对话： 支持带有历史消息上下文的连贯对话，API 会智能地理解上下文并做出回应。
单次问答： 针对独立的查询提供精确的答案或执行指令。
创意写作： 生成文章、故事、诗歌、剧本、广告文案等。
代码生成与解释： 支持多种编程语言的代码编写、调试、注释和解释。
文本分析与总结： 对长文档进行要点总结、提取关键信息、分析情感或主题。
翻译： 支持多种语言之间的互译。
角色扮演与模拟： 可以设定系统提示词，让模型扮演特定角色（如客服、导师、历史人物等）进行交互。

多模态文件处理

API 支持上传多种格式的文件,并能读取其中的文字信息进行智能处理：

支持格式：
- 图像文件：.jpg, .jpeg, .png, .gif, .bmp
- 文档文件：.pdf, .docx, .pptx, .txt
- 演示文稿：.ppt, .pptx
- 电子表格：.xls, .xlsx
处理能力：
- 图像OCR： 读取图片中的文字信息,并基于文字内容进行问答或分析。
- 文档解析： 读取PDF、Word等文档中的文字内容，进行总结、问答或信息提取。
- 多文件关联分析： 可以同时上传多个文件,要求模型进行跨文件的信息整合与对比。

联网搜索（需用户手动开启）

模型本身的知识截止于特定日期。
通过在请求中传递特定参数（如 web_search: true）或调用专门的搜索端点，可以激活联网搜索功能，模型会检索实时网络信息来补充和增强其回答,并提供信息来源引用。

长文本与超大上下文

支持超长的上下文窗口（具体长度依据模型版本，128K tokens）,能够处理极其冗长的对话历史或上传的大型文档。

典型API接口与参数

一个标准的聊天补全接口调用可能如下所示：

端点： POST https://open.x-lobster.com/v1/chat/completions

请求头 Headers:

Authorization: Bearer {您的API密钥}
Content-Type: application/json

请求体 Body (JSON示例):

{
  "model": "deepseek-chat", // 指定模型，deepseek-chat, deepseek-coder 等
  "messages": [
    {"role": "system", "content": "你是一个乐于助人的AI助手。"},
    {"role": "user", "content": "请用Python写一个快速排序的代码，并加上注释。"}
  ],
  "stream": false, // 是否使用流式输出
  "max_tokens": 2048 // 控制回复的最大长度
}

文件上传请求体示例:

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "请总结一下这份PDF报告的主要结论。", "file_urls": ["https://example.com/report.pdf"]}
    // 或者通过 multipart/form-data 直接上传文件
  ]
}

启用联网搜索的请求体示例:

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "今天国际科技新闻头条有哪些？"}
  ],
  "web_search": true // 关键参数，开启联网搜索
}

返回响应格式

成功响应示例 (JSON):

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "deepseek-chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "以下是快速排序的Python实现...",
        "refs": [ // 如果启用了联网搜索，可能包含引用信息
          {"title": "某新闻标题", "url": "https://source1.com"},
          {"title": "另一来源", "url": "https://source2.com"}
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}