OpenClaw Plugin

Install

$openclaw plugins install @captain-sdk/openclaw-captain

Configure

Add your Captain API key and organization ID to your OpenClaw config:

1{
2 plugins: {
3 entries: {
4 captain: {
5 apiKey: "cap_...",
6 organizationId: "019a..."
7 }
8 }
9 }
10}

Get your API key at runcaptain.com/studio.

Tools

Search (always available)

ToolDescription
captain_searchSearch any collection with natural language — text, images, video, and audio. Returns ranked chunks with source citations.
captain_list_collectionsList all collections with file counts

Collections & Documents (optional)

ToolDescription
captain_create_collectionCreate a new collection
captain_delete_collectionDelete a collection and all its data
captain_list_documentsList documents with file names and chunk counts
captain_delete_documentDelete a specific document by ID
captain_wipe_documentsDelete all documents (keeps the collection)

Jobs (optional)

ToolDescription
captain_job_statusCheck indexing job progress and stage
captain_cancel_jobCancel a running indexing job

Indexing (optional)

ToolSource
captain_index_urlPublic URLs, web pages, hosted documents
captain_index_youtubeYouTube video transcripts (up to 20)
captain_index_textRaw text content (notes, transcripts)
captain_index_s3Amazon S3 bucket, directory, or file
captain_index_gcsGoogle Cloud Storage bucket, directory, or file
captain_index_azureAzure Blob Storage container, directory, or file
captain_index_r2Cloudflare R2 bucket, directory, or file

Enable all optional tools:

1{
2 tools: {
3 allow: [
4 "captain_create_collection",
5 "captain_delete_collection",
6 "captain_list_documents",
7 "captain_delete_document",
8 "captain_wipe_documents",
9 "captain_job_status",
10 "captain_cancel_job",
11 "captain_index_url",
12 "captain_index_youtube",
13 "captain_index_text",
14 "captain_index_s3",
15 "captain_index_gcs",
16 "captain_index_azure",
17 "captain_index_r2"
18 ]
19 }
20}

Search Examples

Text search:

Search my-docs for "quarterly revenue trends"

Image search:

Search product-catalog for "red sneakers with white sole"

Audio search:

Search call-recordings for "customer complaints about billing errors"

Video search:

Search training-videos for "how to configure SSO settings"

Indexing Examples

Index a URL:

Index https://example.com/report.pdf into my-docs

Index a YouTube video:

Index this YouTube video into training-videos: https://youtube.com/watch?v=abc123

Index from S3:

Index my S3 bucket "company-data" directory "reports/2026" into financial-docs

captain_search Parameters

ParameterTypeRequiredDefaultDescription
collectionstringYesCollection name to search
querystringYesNatural language search query
top_knumberNo10Number of results to return
rerankbooleanNotrueEnable cross-modal reranking (required for multimodal)

Supported File Types

CategoryFormats
DocumentsPDF, DOCX, DOC, TXT, MD, JSON, YAML, CSV, XLSX
ImagesPNG, JPEG, GIF, BMP, TIFF, WEBP
VideoMP4, MOV, AVI, MKV, WEBM
AudioMP3, WAV, AAC, FLAC, M4A, OGG