deepresearch conversation

Deep Research Conversation

This skill allows OpenClaw agents to conduct in-depth research discussions with users on a given topic. The API Key is automatically loaded from the OpenClaw config — no manual setup is needed.

API Table

| name | path | description |

|------------|---------------------------------|---------------------------------------|

|DeepresearchConversation|/v2/agent/deepresearch/run|Multi-round streaming deep research conversation (via Python script)|

|ConversationCreate|/v2/agent/deepresearch/create|Create a new conversation session, returns conversation_id|

|FileUpload|/v2/agent/file/upload|Upload a file for the conversation|

|FileParseSubmit|/v2/agent/file/parse/submit|Submit an uploaded file for parsing|

|FileParseQuery|/v2/agent/file/parse/query|Query the status of a file parsing task|

Workflow

Path A: Topic discussion without files

1. Call DeepresearchConversation directly with the user's query. A new conversation is created automatically.

Path B: Topic discussion with files

1. Call ConversationCreate to get a conversation_id.

2. Call FileUpload with the conversation_id to upload files.

3. Call FileParseSubmit with the returned file_id.

4. Poll FileParseQuery every few seconds until parsing succeeds.

5. Call DeepresearchConversation with the query, conversation_id, and file_ids.

Multi-round conversation rules

• -The DeepresearchConversation API is a SSE streaming interface that returns data incrementally.
• -After the first call, you must pass conversation_id in all subsequent calls.
• -If the response contains an interrupt_id (for "demand clarification" or "outline confirmation"), the next call must include that interrupt_id.
• -If the response contains a structured_outline, present it to the user for confirmation/modification, then pass the final outline in the next call.
• -Keep calling DeepresearchConversation iteratively until the user is satisfied with the result.

APIS

ConversationCreate API

#### Parameters

no parameters

#### Execute shell

curl -X POST "https://qianfan.baidubce.com/v2/agent/deepresearch/create" \
  -H "X-Appbuilder-From: openclaw" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

FileUpload API

#### Parameters

• -agent_code: Fixed value "deepresearch" (required)
• -conversation_id: From ConversationCreate response (required)
• -file: Local file binary (mutually exclusive with file_url). Max 10 files. Supported formats:

- Text: .doc, .docx, .txt, .pdf, .ppt, .pptx (txt ≤ 10MB, pdf ≤ 100MB/3000 pages, doc/docx ≤ 100MB/2500 pages, ppt/pptx ≤ 400 pages)

- Table: .xlsx, .xls (≤ 100MB, single Sheet only)

- Image: .png, .jpg, .jpeg, .bmp (≤ 10MB each)

- Audio: .wav, .pcm (≤ 10MB)

• -file_url: Public URL of the file (mutually exclusive with file)

#### Local file upload

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/upload" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -H "X-Appbuilder-From: openclaw" \
  -F "agent_code=deepresearch" \
  -F "conversation_id=$conversation_id" \
  -F "file=@local_file_path"

#### File URL upload

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/upload" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -H "X-Appbuilder-From: openclaw" \
  -F "agent_code=deepresearch" \
  -F "conversation_id=$conversation_id" \
  -F "file_url=$file_url"

FileParseSubmit API

#### Parameters

• -file_id: From FileUpload response (required)

#### Execute shell

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/parse/submit" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Appbuilder-From: openclaw" \
  -d '{"file_id": "$file_id"}'

FileParseQuery API

#### Parameters

• -task_id: From FileParseSubmit response (required)

#### Execute shell

curl -X GET "https://qianfan.baidubce.com/v2/agent/file/parse/query?task_id=$task_id" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "X-Appbuilder-From: openclaw"

DeepresearchConversation API

#### Parameters

• -query: The user's question or research topic (required)
• -conversation_id: Optional on first call (auto-generated). Required on subsequent calls.
• -file_ids: List of parsed file IDs (optional, only when discussing files)
• -interrupt_id: Required when responding to "demand clarification" or "outline confirmation" from previous round. Found in content.text.data of the previous SSE response.
• -structured_outline: The research report outline. Required on subsequent calls if the previous round generated one. Structure:

{
    "title": "string",
    "locale": "string",
    "description": "string",
    "sub_chapters": [
        {
            "title": "string",
            "locale": "string",
            "description": "string",
            "sub_chapters": []
        }
    ]
}

• -version: "Lite" (faster, within 10 min) or "Standard" (deeper, slower). Default: "Standard".

#### Execute shell

python3 scripts/deepresearch_conversation.py '{"query": "your question here", "version": "Standard"}'

#### Example with all parameters

python3 scripts/deepresearch_conversation.py '{"query": "the question", "file_ids": ["file_id_1"], "interrupt_id": "interrupt_id", "conversation_id": "conversation_id", "structured_outline": {"title": "Report Title", "locale": "zh", "description": "desc", "sub_chapters": [{"title": "Chapter 1", "locale": "zh", "description": "chapter desc", "sub_chapters": []}]}, "version": "Standard"}'