Building Provider Plugins

Panduan ini memandu Anda membangun plugin provider yang menambahkan provider model (LLM) ke OpenClaw. Pada akhirnya Anda akan memiliki provider dengan katalog model, autentikasi API key, dan resolusi model dinamis.

Jika Anda belum pernah membangun plugin OpenClaw sebelumnya, baca Getting Started terlebih dahulu untuk struktur package dan penyiapan manifest dasar.

Panduan langkah demi langkah

Package dan manifest

{
  "name": "@myorg/openclaw-acme-ai",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "providers": ["acme-ai"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

Manifest mendeklarasikan providerAuthEnvVars agar OpenClaw dapat mendeteksi kredensial tanpa memuat runtime plugin Anda. modelSupport bersifat opsional dan memungkinkan OpenClaw memuat otomatis plugin provider Anda dari ID model singkat seperti acme-large sebelum hook runtime ada. Jika Anda memublikasikan provider di ClawHub, field openclaw.compat dan openclaw.build tersebut wajib ada di package.json.

Daftarkan provider

Provider minimal memerlukan id, label, auth, dan catalog:

index.ts

import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth";

export default definePluginEntry({
  id: "acme-ai",
  name: "Acme AI",
  description: "Acme AI model provider",
  register(api) {
    api.registerProvider({
      id: "acme-ai",
      label: "Acme AI",
      docsPath: "/providers/acme-ai",
      envVars: ["ACME_AI_API_KEY"],

      auth: [
        createProviderApiKeyAuthMethod({
          providerId: "acme-ai",
          methodId: "api-key",
          label: "Acme AI API key",
          hint: "API key from your Acme AI dashboard",
          optionKey: "acmeAiApiKey",
          flagName: "--acme-ai-api-key",
          envVar: "ACME_AI_API_KEY",
          promptMessage: "Enter your Acme AI API key",
          defaultModel: "acme-ai/acme-large",
        }),
      ],

      catalog: {
        order: "simple",
        run: async (ctx) => {
          const apiKey =
            ctx.resolveProviderApiKey("acme-ai").apiKey;
          if (!apiKey) return null;
          return {
            provider: {
              baseUrl: "https://api.acme-ai.com/v1",
              apiKey,
              api: "openai-completions",
              models: [
                {
                  id: "acme-large",
                  name: "Acme Large",
                  reasoning: true,
                  input: ["text", "image"],
                  cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
                  contextWindow: 200000,
                  maxTokens: 32768,
                },
                {
                  id: "acme-small",
                  name: "Acme Small",
                  reasoning: false,
                  input: ["text"],
                  cost: { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
                  contextWindow: 128000,
                  maxTokens: 8192,
                },
              ],
            },
          };
        },
      },
    });
  },
});

Itu adalah provider yang berfungsi. Pengguna sekarang dapat openclaw onboard --acme-ai-api-key <key> dan memilih acme-ai/acme-large sebagai model mereka.Untuk provider bawaan yang hanya mendaftarkan satu provider teks dengan autentikasi API key plus satu runtime berbasis katalog, gunakan helper yang lebih sempit defineSingleProviderPluginEntry(...):

import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";

export default defineSingleProviderPluginEntry({
  id: "acme-ai",
  name: "Acme AI",
  description: "Acme AI model provider",
  provider: {
    label: "Acme AI",
    docsPath: "/providers/acme-ai",
    auth: [
      {
        methodId: "api-key",
        label: "Acme AI API key",
        hint: "API key from your Acme AI dashboard",
        optionKey: "acmeAiApiKey",
        flagName: "--acme-ai-api-key",
        envVar: "ACME_AI_API_KEY",
        promptMessage: "Enter your Acme AI API key",
        defaultModel: "acme-ai/acme-large",
      },
    ],
    catalog: {
      buildProvider: () => ({
        api: "openai-completions",
        baseUrl: "https://api.acme-ai.com/v1",
        models: [{ id: "acme-large", name: "Acme Large" }],
      }),
    },
  },
});

Jika alur autentikasi Anda juga perlu mem-patch models.providers.*, alias, dan model default agen selama onboarding, gunakan helper preset dari openclaw/plugin-sdk/provider-onboard. Helper yang paling sempit adalah createDefaultModelPresetAppliers(...), createDefaultModelsPresetAppliers(...), dan createModelCatalogPresetAppliers(...).Saat endpoint native provider mendukung blok penggunaan streaming pada transport openai-completions normal, utamakan helper katalog bersama di openclaw/plugin-sdk/provider-catalog-shared alih-alih meng-hardcode pemeriksaan provider-id. supportsNativeStreamingUsageCompat(...) dan applyProviderNativeStreamingUsageCompat(...) mendeteksi dukungan dari peta kapabilitas endpoint, sehingga endpoint native gaya Moonshot/DashScope tetap ikut serta bahkan saat plugin menggunakan provider id kustom.

Tambahkan resolusi model dinamis

Jika provider Anda menerima ID model arbitrer (seperti proxy atau router), tambahkan resolveDynamicModel:

api.registerProvider({
  // ... id, label, auth, catalog dari atas

  resolveDynamicModel: (ctx) => ({
    id: ctx.modelId,
    name: ctx.modelId,
    provider: "acme-ai",
    api: "openai-completions",
    baseUrl: "https://api.acme-ai.com/v1",
    reasoning: false,
    input: ["text"],
    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
    contextWindow: 128000,
    maxTokens: 8192,
  }),
});

Jika resolusi memerlukan panggilan jaringan, gunakan prepareDynamicModel untuk warm-up async — resolveDynamicModel dijalankan lagi setelah itu selesai.

Tambahkan hook runtime (sesuai kebutuhan)

Sebagian besar provider hanya memerlukan catalog + resolveDynamicModel. Tambahkan hook secara bertahap sesuai kebutuhan provider Anda.Builder helper bersama kini mencakup keluarga replay/tool-compat yang paling umum, jadi plugin biasanya tidak perlu merangkai tiap hook satu per satu secara manual:

import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-model-shared";
import { buildProviderStreamFamilyHooks } from "openclaw/plugin-sdk/provider-stream";
import { buildProviderToolCompatFamilyHooks } from "openclaw/plugin-sdk/provider-tools";

const GOOGLE_FAMILY_HOOKS = {
  ...buildProviderReplayFamilyHooks({ family: "google-gemini" }),
  ...buildProviderStreamFamilyHooks("google-thinking"),
  ...buildProviderToolCompatFamilyHooks("gemini"),
};

api.registerProvider({
  id: "acme-gemini-compatible",
  // ...
  ...GOOGLE_FAMILY_HOOKS,
});

Keluarga replay yang tersedia saat ini:

Family	Yang dirangkai
`openai-compatible`	Kebijakan replay bergaya OpenAI bersama untuk transport yang kompatibel dengan OpenAI, termasuk sanitasi tool-call-id, perbaikan urutan assistant-first, dan validasi turn Gemini generik saat transport membutuhkannya
`anthropic-by-model`	Kebijakan replay yang sadar Claude dipilih berdasarkan `modelId`, sehingga transport pesan Anthropic hanya mendapatkan pembersihan thinking-block khusus Claude saat model yang di-resolve benar-benar ID Claude
`google-gemini`	Kebijakan replay Gemini native plus sanitasi replay bootstrap dan mode output reasoning bertag
`passthrough-gemini`	Sanitasi thought-signature Gemini untuk model Gemini yang berjalan melalui transport proxy yang kompatibel dengan OpenAI; tidak mengaktifkan validasi replay Gemini native atau penulisan ulang bootstrap
`hybrid-anthropic-openai`	Kebijakan hibrida untuk provider yang mencampur permukaan model pesan Anthropic dan yang kompatibel dengan OpenAI dalam satu plugin; pembuangan thinking-block opsional khusus Claude tetap terbatas pada sisi Anthropic

Contoh bawaan nyata:

google dan google-gemini-cli: google-gemini
openrouter, kilocode, opencode, dan opencode-go: passthrough-gemini
amazon-bedrock dan anthropic-vertex: anthropic-by-model
minimax: hybrid-anthropic-openai
moonshot, ollama, xai, dan zai: openai-compatible

Keluarga stream yang tersedia saat ini:

Family	Yang dirangkai
`google-thinking`	Normalisasi payload thinking Gemini pada path stream bersama
`kilocode-thinking`	Wrapper reasoning Kilo pada path stream proxy bersama, dengan `kilo/auto` dan ID reasoning proxy yang tidak didukung melewati thinking yang disuntikkan
`moonshot-thinking`	Pemetaan payload native-thinking biner Moonshot dari konfigurasi + level `/think`
`minimax-fast-mode`	Penulisan ulang model fast-mode MiniMax pada path stream bersama
`openai-responses-defaults`	Wrapper Responses OpenAI/Codex native bersama: header atribusi, `/fast`/`serviceTier`, verbositas teks, web search Codex native, pembentukan payload reasoning-compat, dan manajemen konteks Responses
`openrouter-thinking`	Wrapper reasoning OpenRouter untuk rute proxy, dengan lompatan model yang tidak didukung/`auto` ditangani secara terpusat
`tool-stream-default-on`	Wrapper `tool_stream` default aktif untuk provider seperti Z.AI yang menginginkan tool streaming kecuali dinonaktifkan secara eksplisit

Contoh bawaan nyata:

google dan google-gemini-cli: google-thinking
kilocode: kilocode-thinking
moonshot: moonshot-thinking
minimax dan minimax-portal: minimax-fast-mode
openai dan openai-codex: openai-responses-defaults
openrouter: openrouter-thinking
zai: tool-stream-default-on

openclaw/plugin-sdk/provider-model-shared juga mengekspor enum replay-family plus helper bersama yang menjadi dasar keluarga tersebut. Ekspor publik umum mencakup:

ProviderReplayFamily
buildProviderReplayFamilyHooks(...)
builder replay bersama seperti buildOpenAICompatibleReplayPolicy(...), buildAnthropicReplayPolicyForModel(...), buildGoogleGeminiReplayPolicy(...), dan buildHybridAnthropicOrOpenAIReplayPolicy(...)
helper replay Gemini seperti sanitizeGoogleGeminiReplayHistory(...) dan resolveTaggedReasoningOutputMode()
helper endpoint/model seperti resolveProviderEndpoint(...), normalizeProviderId(...), normalizeGooglePreviewModelId(...), dan normalizeNativeXaiModelId(...)

openclaw/plugin-sdk/provider-stream mengekspos builder keluarga dan helper wrapper publik yang digunakan kembali oleh keluarga tersebut. Ekspor publik umum mencakup:

ProviderStreamFamily
buildProviderStreamFamilyHooks(...)
composeProviderStreamWrappers(...)
wrapper OpenAI/Codex bersama seperti createOpenAIAttributionHeadersWrapper(...), createOpenAIFastModeWrapper(...), createOpenAIServiceTierWrapper(...), createOpenAIResponsesContextManagementWrapper(...), dan createCodexNativeWebSearchWrapper(...)
wrapper proxy/provider bersama seperti createOpenRouterWrapper(...), createToolStreamWrapper(...), dan createMinimaxFastModeWrapper(...)

Beberapa helper stream sengaja tetap lokal pada provider. Contoh bawaan saat ini: @openclaw/anthropic-provider mengekspor wrapAnthropicProviderStream, resolveAnthropicBetas, resolveAnthropicFastMode, resolveAnthropicServiceTier, dan builder wrapper Anthropic tingkat lebih rendah dari seam publik api.ts / contract-api.ts. Helper tersebut tetap khusus Anthropic karena juga mengenkode penanganan beta Claude OAuth dan gating context1m.Provider bawaan lain juga menjaga wrapper khusus transport tetap lokal saat perilakunya tidak dapat dibagikan dengan rapi antar keluarga. Contoh saat ini: plugin xAI bawaan menyimpan pembentukan Responses xAI native di wrapStreamFn miliknya sendiri, termasuk penulisan ulang alias /fast, default tool_stream, pembersihan strict-tool yang tidak didukung, dan penghapusan payload reasoning khusus xAI.openclaw/plugin-sdk/provider-tools saat ini mengekspos satu keluarga tool-schema bersama plus helper schema/compat bersama:

ProviderToolCompatFamily mendokumentasikan inventaris keluarga bersama saat ini.
buildProviderToolCompatFamilyHooks("gemini") merangkai pembersihan schema Gemini
- diagnostik untuk provider yang memerlukan tool schema yang aman untuk Gemini.
normalizeGeminiToolSchemas(...) dan inspectGeminiToolSchemas(...) adalah helper schema Gemini publik yang mendasarinya.
resolveXaiModelCompatPatch() mengembalikan patch compat xAI bawaan: toolSchemaProfile: "xai", keyword schema yang tidak didukung, dukungan native web_search, dan decoding argumen tool-call HTML-entity.
applyXaiModelCompat(model) menerapkan patch compat xAI yang sama itu ke model yang di-resolve sebelum mencapai runner.

Contoh bawaan nyata: plugin xAI menggunakan normalizeResolvedModel plus contributeResolvedModelCompat agar metadata compat tersebut tetap dimiliki oleh provider alih-alih meng-hardcode aturan xAI di core.Pola root package yang sama juga mendasari provider bawaan lainnya:

@openclaw/openai-provider: api.ts mengekspor builder provider, helper model default, dan builder provider realtime
@openclaw/openrouter-provider: api.ts mengekspor builder provider plus helper onboarding/konfigurasi

Pertukaran token
Header kustom
Identitas transport native
Penggunaan dan penagihan

Untuk provider yang memerlukan pertukaran token sebelum setiap panggilan inferensi:

prepareRuntimeAuth: async (ctx) => {
  const exchanged = await exchangeToken(ctx.apiKey);
  return {
    apiKey: exchanged.token,
    baseUrl: exchanged.baseUrl,
    expiresAt: exchanged.expiresAt,
  };
},

Untuk provider yang memerlukan header request kustom atau modifikasi body:

// wrapStreamFn mengembalikan StreamFn yang diturunkan dari ctx.streamFn
wrapStreamFn: (ctx) => {
  if (!ctx.streamFn) return undefined;
  const inner = ctx.streamFn;
  return async (params) => {
    params.headers = {
      ...params.headers,
      "X-Acme-Version": "2",
    };
    return inner(params);
  };
},

Untuk provider yang memerlukan header atau metadata request/sesi native pada transport HTTP atau WebSocket generik:

resolveTransportTurnState: (ctx) => ({
  headers: {
    "x-request-id": ctx.turnId,
  },
  metadata: {
    session_id: ctx.sessionId ?? "",
    turn_id: ctx.turnId,
  },
}),
resolveWebSocketSessionPolicy: (ctx) => ({
  headers: {
    "x-session-id": ctx.sessionId ?? "",
  },
  degradeCooldownMs: 60_000,
}),

Untuk provider yang mengekspos data penggunaan/penagihan:

resolveUsageAuth: async (ctx) => {
  const auth = await ctx.resolveOAuthToken();
  return auth ? { token: auth.token } : null;
},
fetchUsageSnapshot: async (ctx) => {
  return await fetchAcmeUsage(ctx.token, ctx.timeoutMs);
},

Semua hook provider yang tersedia

OpenClaw memanggil hook dalam urutan ini. Sebagian besar provider hanya menggunakan 2-3:

#	Hook	Kapan digunakan
1	`catalog`	Katalog model atau default `baseUrl`
2	`applyConfigDefaults`	Default global milik provider selama materialisasi konfigurasi
3	`normalizeModelId`	Pembersihan alias model-id lama/pratinjau sebelum lookup
4	`normalizeTransport`	Pembersihan `api` / `baseUrl` keluarga provider sebelum perakitan model generik
5	`normalizeConfig`	Normalisasi konfigurasi `models.providers.<id>`
6	`applyNativeStreamingUsageCompat`	Penulisan ulang compat streaming-usage native untuk provider konfigurasi
7	`resolveConfigApiKey`	Resolusi autentikasi env-marker milik provider
8	`resolveSyntheticAuth`	Auth sintetis lokal/self-hosted atau berbasis konfigurasi
9	`shouldDeferSyntheticProfileAuth`	Menurunkan prioritas placeholder stored-profile sintetis di bawah auth env/config
10	`resolveDynamicModel`	Menerima ID model upstream arbitrer
11	`prepareDynamicModel`	Pengambilan metadata async sebelum resolve
12	`normalizeResolvedModel`	Penulisan ulang transport sebelum runner

Catatan fallback runtime:

normalizeConfig memeriksa provider yang cocok terlebih dahulu, lalu plugin provider lain yang mendukung hook hingga ada yang benar-benar mengubah konfigurasi. Jika tidak ada hook provider yang menulis ulang entri konfigurasi keluarga Google yang didukung, normalizer konfigurasi Google bawaan tetap diterapkan.
resolveConfigApiKey menggunakan hook provider saat tersedia. Jalur amazon-bedrock bawaan juga memiliki resolver env-marker AWS bawaan di sini, meskipun auth runtime Bedrock sendiri masih menggunakan rantai default AWS SDK. | 13 | contributeResolvedModelCompat | Flag compat untuk model vendor di balik transport kompatibel lain | | 14 | capabilities | Kumpulan kapabilitas statis lama; hanya untuk kompatibilitas | | 15 | normalizeToolSchemas | Pembersihan tool-schema milik provider sebelum registrasi | | 16 | inspectToolSchemas | Diagnostik tool-schema milik provider | | 17 | resolveReasoningOutputMode | Kontrak output reasoning bertag vs native | | 18 | prepareExtraParams | Parameter request default | | 19 | createStreamFn | Transport StreamFn kustom sepenuhnya | | 20 | wrapStreamFn | Wrapper header/body kustom pada path stream normal | | 21 | resolveTransportTurnState | Header/metadata native per turn | | 22 | resolveWebSocketSessionPolicy | Header session native WS / cool-down | | 23 | formatApiKey | Bentuk token runtime kustom | | 24 | refreshOAuth | Refresh OAuth kustom | | 25 | buildAuthDoctorHint | Panduan perbaikan auth | | 26 | matchesContextOverflowError | Deteksi overflow milik provider | | 27 | classifyFailoverReason | Klasifikasi rate-limit/overload milik provider | | 28 | isCacheTtlEligible | Gating TTL prompt cache | | 29 | buildMissingAuthMessage | Petunjuk custom missing-auth | | 30 | suppressBuiltInModel | Sembunyikan baris upstream yang kedaluwarsa | | 31 | augmentModelCatalog | Baris forward-compat sintetis | | 32 | isBinaryThinking | Thinking biner aktif/nonaktif | | 33 | supportsXHighThinking | Dukungan reasoning xhigh | | 34 | resolveDefaultThinkingLevel | Kebijakan default /think | | 35 | isModernModelRef | Pencocokan model live/smoke | | 36 | prepareRuntimeAuth | Pertukaran token sebelum inferensi | | 37 | resolveUsageAuth | Parsing kredensial penggunaan kustom | | 38 | fetchUsageSnapshot | Endpoint penggunaan kustom | | 39 | createEmbeddingProvider | Adapter embedding milik provider untuk memori/pencarian | | 40 | buildReplayPolicy | Kebijakan replay/pemadatan transkrip kustom | | 41 | sanitizeReplayHistory | Penulisan ulang replay khusus provider setelah pembersihan generik | | 42 | validateReplayTurns | Validasi replay-turn ketat sebelum embedded runner | | 43 | onModelSelected | Callback pasca-pemilihan (misalnya telemetri) |

Catatan penyetelan prompt:

resolveSystemPromptContribution memungkinkan provider menyuntikkan panduan system-prompt yang sadar cache untuk keluarga model. Utamakan ini daripada before_prompt_build saat perilakunya milik satu keluarga provider/model dan harus mempertahankan pemisahan cache stabil/dinamis.

Untuk deskripsi mendetail dan contoh dunia nyata, lihat Internals: Provider Runtime Hooks.

Tambahkan kemampuan ekstra (opsional)

Plugin provider dapat mendaftarkan speech, transkripsi realtime, suara realtime, pemahaman media, generasi gambar, generasi video, web fetch, dan web search di samping inferensi teks:

register(api) {
  api.registerProvider({ id: "acme-ai", /* ... */ });

  api.registerSpeechProvider({
    id: "acme-ai",
    label: "Acme Speech",
    isConfigured: ({ config }) => Boolean(config.messages?.tts),
    synthesize: async (req) => ({
      audioBuffer: Buffer.from(/* PCM data */),
      outputFormat: "mp3",
      fileExtension: ".mp3",
      voiceCompatible: false,
    }),
  });

  api.registerRealtimeTranscriptionProvider({
    id: "acme-ai",
    label: "Acme Realtime Transcription",
    isConfigured: () => true,
    createSession: (req) => ({
      connect: async () => {},
      sendAudio: () => {},
      close: () => {},
      isConnected: () => true,
    }),
  });

  api.registerRealtimeVoiceProvider({
    id: "acme-ai",
    label: "Acme Realtime Voice",
    isConfigured: ({ providerConfig }) => Boolean(providerConfig.apiKey),
    createBridge: (req) => ({
      connect: async () => {},
      sendAudio: () => {},
      setMediaTimestamp: () => {},
      submitToolResult: () => {},
      acknowledgeMark: () => {},
      close: () => {},
      isConnected: () => true,
    }),
  });

  api.registerMediaUnderstandingProvider({
    id: "acme-ai",
    capabilities: ["image", "audio"],
    describeImage: async (req) => ({ text: "A photo of..." }),
    transcribeAudio: async (req) => ({ text: "Transcript..." }),
  });

  api.registerImageGenerationProvider({
    id: "acme-ai",
    label: "Acme Images",
    generate: async (req) => ({ /* image result */ }),
  });

  api.registerVideoGenerationProvider({
    id: "acme-ai",
    label: "Acme Video",
    capabilities: {
      maxVideos: 1,
      maxDurationSeconds: 10,
      supportsResolution: true,
    },
    generateVideo: async (req) => ({ videos: [] }),
  });

  api.registerWebFetchProvider({
    id: "acme-ai-fetch",
    label: "Acme Fetch",
    hint: "Fetch pages through Acme's rendering backend.",
    envVars: ["ACME_FETCH_API_KEY"],
    placeholder: "acme-...",
    signupUrl: "https://acme.example.com/fetch",
    credentialPath: "plugins.entries.acme.config.webFetch.apiKey",
    getCredentialValue: (fetchConfig) => fetchConfig?.acme?.apiKey,
    setCredentialValue: (fetchConfigTarget, value) => {
      const acme = (fetchConfigTarget.acme ??= {});
      acme.apiKey = value;
    },
    createTool: () => ({
      description: "Fetch a page through Acme Fetch.",
      parameters: {},
      execute: async (args) => ({ content: [] }),
    }),
  });

  api.registerWebSearchProvider({
    id: "acme-ai-search",
    label: "Acme Search",
    search: async (req) => ({ content: [] }),
  });
}

OpenClaw mengklasifikasikan ini sebagai plugin hybrid-capability. Ini adalah pola yang direkomendasikan untuk plugin perusahaan (satu plugin per vendor). Lihat Internals: Capability Ownership.

Uji

src/provider.test.ts

import { describe, it, expect } from "vitest";
// Ekspor objek konfigurasi provider Anda dari index.ts atau file khusus
import { acmeProvider } from "./provider.js";

describe("acme-ai provider", () => {
  it("resolves dynamic models", () => {
    const model = acmeProvider.resolveDynamicModel!({
      modelId: "acme-beta-v3",
    } as any);
    expect(model.id).toBe("acme-beta-v3");
    expect(model.provider).toBe("acme-ai");
  });

  it("returns catalog when key is available", async () => {
    const result = await acmeProvider.catalog!.run({
      resolveProviderApiKey: () => ({ apiKey: "test-key" }),
    } as any);
    expect(result?.provider?.models).toHaveLength(2);
  });

  it("returns null catalog when no key", async () => {
    const result = await acmeProvider.catalog!.run({
      resolveProviderApiKey: () => ({ apiKey: undefined }),
    } as any);
    expect(result).toBeNull();
  });
});

Publikasikan ke ClawHub

Plugin provider dipublikasikan dengan cara yang sama seperti plugin kode eksternal lainnya:

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin

Jangan gunakan alias publish lama yang khusus untuk skill di sini; package plugin harus menggunakan clawhub package publish.

Struktur file

<bundled-plugin-root>/acme-ai/
├── package.json              # metadata openclaw.providers
├── openclaw.plugin.json      # Manifest dengan providerAuthEnvVars
├── index.ts                  # definePluginEntry + registerProvider
└── src/
    ├── provider.test.ts      # Test
    └── usage.ts              # Endpoint penggunaan (opsional)

Referensi urutan katalog

catalog.order mengontrol kapan katalog Anda digabungkan relatif terhadap provider bawaan:

Order	Kapan	Kasus penggunaan
`simple`	Lintasan awal	Provider API key biasa
`profile`	Setelah simple	Provider yang bergantung pada profile auth
`paired`	Setelah profile	Menyintesis beberapa entri yang berkaitan
`late`	Lintasan akhir	Menimpa provider yang ada (menang saat tabrakan)

Langkah berikutnya

Channel Plugins — jika plugin Anda juga menyediakan channel
SDK Runtime — helper api.runtime (TTS, pencarian, subagen)
SDK Overview — referensi impor subpath lengkap
Plugin Internals — detail hook dan contoh bawaan

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

Building Provider Plugins

Building Provider Plugins

Panduan langkah demi langkah

Publikasikan ke ClawHub

Struktur file

Referensi urutan katalog

Langkah berikutnya

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

​Building Provider Plugins

​Panduan langkah demi langkah

​Publikasikan ke ClawHub

​Struktur file

​Referensi urutan katalog

​Langkah berikutnya

Building Provider Plugins

Panduan langkah demi langkah

Publikasikan ke ClawHub

Struktur file

Referensi urutan katalog

Langkah berikutnya