プラグイン

​

クイック スタート (プラグインは初めてですか?)

1. すでにロードされているものを確認します。

openclaw plugins list

2. 公式プラグインをインストールします (例: 音声通話)。

openclaw plugins install @openclaw/voice-call

3. ゲートウェイを再起動し、plugins.entries.<id>.config で設定します。

​

利用可能なプラグイン (公式)- Microsoft Teams は 2026.1.15 の時点でプラグインのみです。 Teams を使用している場合は、@openclaw/msteams をインストールします

• メモリ (コア) — バンドルされたメモリ検索プラグイン (plugins.slots.memory 経由でデフォルトで有効)
• メモリ (LanceDB) — バンドルされた長期記憶プラグイン (自動呼び出し/キャプチャ、plugins.slots.memory = "memory-lancedb" を設定)
• 音声通話 — @openclaw/voice-call
• Zalo 個人 — @openclaw/zalouser
• マトリックス — @openclaw/matrix
• Nostr — @openclaw/nostr
• ザロ — @openclaw/zalo
• Microsoft Teams — @openclaw/msteams
• Google Antigravity OAuth (プロバイダー認証) — google-antigravity-auth としてバンドルされています (デフォルトでは無効)
• Gemini CLI OAuth (プロバイダー認証) — google-gemini-cli-auth としてバンドルされています (デフォルトでは無効)
• Qwen OAuth (プロバイダー認証) — qwen-portal-auth としてバンドルされています (デフォルトでは無効)
• Copilot プロキシ (プロバイダー認証) — ローカル VS Code Copilot プロキシ ブリッジ。組み込みの github-copilot デバイス ログインとは異なります (バンドルされており、デフォルトで無効になっています)

• ゲートウェイ HTTP ルート
• エージェントツール
• CLIコマンド
• バックグラウンドサービス
• コンテキストエンジン
• オプションの構成検証
• スキル (プラグイン マニフェストに skills ディレクトリをリストすることによる)
• 自動応答コマンド (AI エージェントを呼び出さずに実行)

​

ランタイムヘルパー

const result = await api.runtime.tts.textToSpeechTelephony({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

• コア messages.tts 構成 (OpenAI または イレブンラボ) を使用します。
• PCM オーディオ バッファ + サンプル レートを返します。プラグインはプロバイダー用にリサンプリング/エンコードする必要があります。
• Edge TTS はテレフォニーではサポートされていません。

const { text } = await api.runtime.stt.transcribeAudioFile({
  filePath: "/tmp/inbound-audio.ogg",
  cfg: api.config,
  // Optional when MIME cannot be inferred reliably:
  mime: "audio/ogg",
});

• コアメディア理解オーディオ構成 (tools.media.audio) とプロバイダーのフォールバック順序を使用します。
• 文字起こし出力が生成されない場合 (スキップされた/サポートされていない入力など)、{ text: undefined } を返します。

​

ゲートウェイ HTTP ルート

api.registerHttpRoute({
  path: "/acme/webhook",
  auth: "plugin",
  match: "exact",
  handler: async (_req, res) => {
    res.statusCode = 200;
    res.end("ok");
    return true;
  },
});

• auth: 必須。通常のゲートウェイ認証を要求するには "gateway" を使用し、プラグイン管理の認証/Webhook 検証には "plugin" を使用します。
• match: オプション。 "exact" (デフォルト) または "prefix"。
• replaceExisting: オプション。同じプラグインが自身の既存のルート登録を置き換えることを許可します。
• handler: ルートがリクエストを処理したときに true を返します。

• api.registerHttpHandler(...) は廃止されました。 api.registerHttpRoute(...) を使用してください。
• プラグイン ルートは auth を明示的に宣言する必要があります。
• replaceExisting: true を除き、正確な path + match の競合は拒否され、あるプラグインが別のプラグインのルートを置き換えることはできません。
• auth レベルが異なる重複するルートは拒否されます。 exact/prefix フォールスルー チェーンは同じ認証レベルでのみ保持してください。

​

プラグイン SDK インポート パス

• openclaw/plugin-sdk/compat は、core よりも広範な共有ランタイム ヘルパーを必要とするバンドル/内部プラグイン コード用です。
• openclaw/plugin-sdk/telegram テレグラム チャネル プラグイン用。
• openclaw/plugin-sdk/discord Discord チャンネル プラグイン用。
• openclaw/plugin-sdk/slack Slack チャネル プラグイン用。
• openclaw/plugin-sdk/signal シグナルチャンネルプラグイン用。
• openclaw/plugin-sdk/imessage iMessage チャネル プラグイン用。
• openclaw/plugin-sdk/whatsapp WhatsApp チャネル プラグイン用。
• openclaw/plugin-sdk/line LINE チャネル プラグイン用。
• openclaw/plugin-sdk/msteams バンドルされた Microsoft Teams プラグイン サーフェス用。
• バンドルされた拡張機能固有のサブパスも利用できます。 openclaw/plugin-sdk/acpx、openclaw/plugin-sdk/bluebubbles、 openclaw/plugin-sdk/copilot-proxy、openclaw/plugin-sdk/device-pair、 openclaw/plugin-sdk/diagnostics-otel、openclaw/plugin-sdk/diffs、 openclaw/plugin-sdk/feishu、 openclaw/plugin-sdk/google-gemini-cli-auth、openclaw/plugin-sdk/googlechat、 openclaw/plugin-sdk/irc、openclaw/plugin-sdk/llm-task、 openclaw/plugin-sdk/lobster、openclaw/plugin-sdk/matrix、 openclaw/plugin-sdk/mattermost、openclaw/plugin-sdk/memory-core、 openclaw/plugin-sdk/memory-lancedb、 openclaw/plugin-sdk/minimax-portal-auth、 openclaw/plugin-sdk/nextcloud-talk、openclaw/plugin-sdk/nostr、 openclaw/plugin-sdk/open-prose、openclaw/plugin-sdk/phone-control、 openclaw/plugin-sdk/qwen-portal-auth、openclaw/plugin-sdk/synology-chat、 openclaw/plugin-sdk/talk-voice、openclaw/plugin-sdk/test-utils、 openclaw/plugin-sdk/thread-ownership、openclaw/plugin-sdk/tlon、 openclaw/plugin-sdk/twitch、openclaw/plugin-sdk/voice-call、 openclaw/plugin-sdk/zalo、および openclaw/plugin-sdk/zalouser。

• 新しいバンドル プラグインと移行されたバンドル プラグインは、チャネルまたは拡張機能固有のプラグインを使用する必要があります サブパス;一般的なサーフェスには core を使用し、より広い場合にのみ compat を使用します 共有ヘルパーが必要です。

​

読み取り専用チャネル検査

• resolveAccount(...) はランタイム パスです。資格情報を仮定することが許可されています は完全に実体化されており、必要なシークレットが欠落している場合はすぐに失敗する可能性があります。
• openclaw status、openclaw status --all、などの読み取り専用コマンド パス openclaw channels status、openclaw channels resolve、およびドクター/構成 修復フローでは、実行時資格情報を具体化する必要はありません。 構成を説明します。

• enabled と configured を保存します。
• 関連する場合、次のような認証情報ソース/ステータス フィールドを含めます。
  • tokenSource、tokenStatus
  • botTokenSource、botTokenStatus
  • appTokenSource、appTokenStatus
  • signingSecretSource、signingSecretStatus
• 読み取り専用をレポートするためだけに生のトークン値を返す必要はありません 可用性。 tokenStatus: "available" (および一致するソース) を返します フィールド) は、ステータス形式のコマンドには十分です。
• 資格情報が SecretRef 経由で設定されている場合は、configured_unavailable を使用しますが、 現在のコマンド パスでは使用できません。

• プラグインの検出とマニフェストのメタデータは、短いインプロセス キャッシュを使用して、 急激な起動/リロード作業。
• OPENCLAW_DISABLE_PLUGIN_DISCOVERY_CACHE=1 を設定するか、 OPENCLAW_DISABLE_PLUGIN_MANIFEST_CACHE=1 を使用してこれらのキャッシュを無効にします。
• OPENCLAW_PLUGIN_DISCOVERY_CACHE_MS を使用してキャッシュ ウィンドウを調整し、 OPENCLAW_PLUGIN_MANIFEST_CACHE_MS。

​

発見と優先順位

1. 構成パス

• plugins.load.paths (ファイルまたはディレクトリ)

2. ワークスペース拡張機能

• <workspace>/.openclaw/extensions/*.ts
• <workspace>/.openclaw/extensions/*/index.ts

3. グローバル拡張機能

• ~/.openclaw/extensions/*.ts
• ~/.openclaw/extensions/*/index.ts

4. バンドルされた拡張機能 (OpenClaw に同梱されていますが、デフォルトではほとんどが無効になっています)

• <openclaw>/extensions/*バンドルされているほとんどのプラグインは、次の方法で明示的に有効にする必要があります。 plugins.entries.<id>.enabled または openclaw plugins enable <id>。

• device-pair
• phone-control
• talk-voice
• アクティブ メモリ スロット プラグイン (デフォルト スロット: memory-core)

• plugins.allow が空で、バンドルされていないプラグインが検出可能な場合、OpenClaw はプラグイン ID とソースを含む起動警告をログに記録します。
• 候補パスは、検出許可の前に安全性がチェックされます。 OpenClaw は、次の場合に候補をブロックします。
  • 拡張エントリはプラグイン ルートの外側で解決されます (シンボリックリンク/パス トラバーサル エスケープを含む)。
  • プラグインのルート/ソース パスは誰でも書き込み可能です。
  • バンドルされていないプラグインのパスの所有権は疑わしい (POSIX 所有者は現在の uid でも root でもない)。
• インストール/ロードパスの出自を持たずにロードされたバンドルされていないプラグインは警告を発するため、信頼を固定するか (plugins.allow)、またはインストール追跡を行うことができます (plugins.installs)。

​

パッケージパック

{
  "name": "my-pack",
  "openclaw": {
    "extensions": ["./src/safety.ts", "./src/tools.ts"]
  }
}
```各エントリはプラグインになります。パックに複数の拡張機能がリストされている場合、プラグイン ID
`name/<fileBase>` になります。

プラグインが npm deps をインポートする場合は、そのディレクトリにインストールします。
`node_modules` が利用可能です (`npm install` / `pnpm install`)。

セキュリティ ガードレール: すべての `openclaw.extensions` エントリはプラグイン内に保持する必要があります
シンボリックリンク解決後のディレクトリ。パッケージディレクトリをエスケープするエントリは次のとおりです。
拒否されました。

セキュリティ上の注意: `openclaw plugins install` はプラグインの依存関係をインストールします。
`npm install --ignore-scripts` (ライフサイクル スクリプトなし)。プラグインの依存関係を維持する
ツリーは「純粋な JS/TS」であり、`postinstall` ビルドを必要とするパッケージは避けてください。

### チャンネルカタログメタデータ

チャネル プラグインは、`openclaw.channel` を介してオンボーディング メタデータをアドバタイズできます。
`openclaw.install` 経由でヒントをインストールします。これにより、コア カタログにデータが含まれない状態が保たれます。

例:

```json
{
  "name": "@openclaw/nextcloud-talk",
  "openclaw": {
    "extensions": ["./index.ts"],
    "channel": {
      "id": "nextcloud-talk",
      "label": "Nextcloud Talk",
      "selectionLabel": "Nextcloud Talk (self-hosted)",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "Self-hosted chat via Nextcloud Talk webhook bots.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "extensions/nextcloud-talk",
      "defaultChoice": "npm"
    }
  }
}

• ~/.openclaw/mpm/plugins.json
• ~/.openclaw/mpm/catalog.json
• ~/.openclaw/plugins/catalog.json

​

プラグイン ID

• パッケージ パック: package.json name
• スタンドアロン ファイル: ファイル ベース名 (~/.../voice-call.ts → voice-call)プラグインが id をエクスポートする場合、OpenClaw はそれを使用しますが、それが 設定されたID。

​

構成

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: ["untrusted-plugin"],
    load: { paths: ["~/Projects/oss/voice-call-extension"] },
    entries: {
      "voice-call": { enabled: true, config: { provider: "twilio" } },
    },
  },
}

• enabled: マスター切り替え (デフォルト: true)
• allow: 許可リスト (オプション)
• deny: 拒否リスト (オプション、拒否が優先)
• load.paths: 追加のプラグイン ファイル/ディレクトリ
• slots: memory や contextEngine などの排他的スロット セレクター
• entries.<id>: プラグインごとの切り替え + 設定

• entries、allow、deny、または slots の不明なプラグイン ID は エラーです。
• プラグイン マニフェストで宣言されていない限り、不明な channels.<id> キーは エラー チャンネルID。
• プラグイン設定は、に埋め込まれた JSON スキーマを使用して検証されます。 openclaw.plugin.json (configSchema)。
• プラグインが無効になっている場合、その構成は保存され、警告が発行されます。

​

プラグイン スロット (排他的なカテゴリ)

{
  plugins: {
    slots: {
      memory: "memory-core", // or "none" to disable memory plugins
      contextEngine: "legacy", // or a plugin id such as "lossless-claw"
    },
  },
}

• memory: アクティブなメモリ プラグイン ("none" はメモリ プラグインを無効にします)
• contextEngine: アクティブなコンテキスト エンジン プラグイン ("legacy" は組み込みのデフォルトです)複数のプラグインが kind: "memory" または kind: "context-engine" を宣言している場合のみ、 選択したプラグインがそのスロットにロードされます。その他は診断により無効になります。

​

コンテキスト エンジン プラグイン

​

コントロール UI (スキーマ + ラベル)

• plugins.entries.<id> / .enabled / .config のプラグインごとのラベルを追加します。
• プラグインが提供するオプションの設定フィールドのヒントを以下にマージします。 plugins.entries.<id>.config.<field>

{
  "id": "my-plugin",
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "apiKey": { "type": "string" },
      "region": { "type": "string" }
    }
  },
  "uiHints": {
    "apiKey": { "label": "API Key", "sensitive": true },
    "region": { "label": "Region", "placeholder": "us-east-1" }
  }
}

​

CLI

openclaw plugins list
openclaw plugins info <id>
openclaw plugins install <path>                 # copy a local file/dir into ~/.openclaw/extensions/<id>
openclaw plugins install ./extensions/voice-call # relative path ok
openclaw plugins install ./plugin.tgz           # install from a local tarball
openclaw plugins install ./plugin.zip           # install from a local zip
openclaw plugins install -l ./extensions/voice-call # link (no copy) for dev
openclaw plugins install @openclaw/voice-call # install from npm
openclaw plugins install @openclaw/voice-call --pin # store exact resolved name@version
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor

​

プラグイン API (概要)

• 関数: (api) => { ... }
• オブジェクト: { id, name, configSchema, register(api) { ... } }

export default function (api) {
  api.registerContextEngine("lossless-claw", () => ({
    info: { id: "lossless-claw", name: "Lossless Claw", ownsCompaction: true },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages }) {
      return { messages, estimatedTokens: 0 };
    },
    async compact() {
      return { ok: true, compacted: false };
    },
  }));
}

{
  plugins: {
    slots: {
      contextEngine: "lossless-claw",
    },
  },
}

​

プラグインフック

​

例

export default function register(api) {
  api.registerHook(
    "command:new",
    async () => {
      // Hook logic here.
    },
    {
      name: "my-plugin.command-new",
      description: "Runs when /new is invoked",
    },
  );
}

• api.registerHook(...) を介してフックを明示的に登録します。
• フック適格性ルールは引き続き適用されます (OS/bins/env/config 要件)。
• プラグイン管理のフックは openclaw hooks list と plugin:<id> に表示されます。
• openclaw hooks を介してプラグイン管理のフックを有効/無効にすることはできません。代わりにプラグインを有効/無効にします。

​

エージェントのライフサイクル フック (api.on)

export default function register(api) {
  api.on(
    "before_prompt_build",
    (event, ctx) => {
      return {
        prependSystemContext: "Follow company style guide.",
      };
    },
    { priority: 10 },
  );
}

• before_model_resolve: セッションのロード前に実行されます (messages は使用できません)。これを使用して、modelOverride または providerOverride を決定的にオーバーライドします。
• before_prompt_build: セッションのロード後に実行されます (messages が利用可能です)。これを使用してプロンプト入力を整形します。
• before_agent_start: 従来の互換性フック。上記の 2 つの明示的なフックを推奨します。

• 無効にすると、OpenClaw は before_prompt_build をブロックし、従来の modelOverride および providerOverride を保持しながら、従来の before_agent_start から返されたプロンプト変更フィールドを無視します。

• prependContext: この実行のユーザー プロンプトの先頭にテキストを追加します。ターン固有のコンテンツや動的なコンテンツに最適です。
• systemPrompt: 完全なシステム プロンプト オーバーライド。
• prependSystemContext: 現在のシステム プロンプトの先頭にテキストを追加します。
• appendSystemContext: 現在のシステム プロンプトにテキストを追加します。

1. prependContext をユーザー プロンプトに適用します。
2. systemPrompt オーバーライドが指定されている場合は、それを適用します。
3. prependSystemContext + current system prompt + appendSystemContext を適用します。

• フック ハンドラーは優先順位に従って実行されます (高い順)。
• マージされたコンテキスト フィールドの場合、値は実行順序で連結されます。
• before_prompt_build 値は、従来の before_agent_start フォールバック値の前に適用されます。

• プロバイダーが安定したシステム プレフィックス コンテンツをキャッシュできるように、静的ガイダンスを prependContext から prependSystemContext (または appendSystemContext) に移動します。
• ユーザー メッセージに関連付けられたままにするターンごとの動的コンテキスト用に prependContext を保持します。

​

プロバイダープラグイン (モデル認証)プラグインは モデル プロバイダー認証 フローを登録できるため、ユーザーは OAuth または

• openclaw models auth login --provider <id> [--method <id>]

api.registerProvider({
  id: "acme",
  label: "AcmeAI",
  auth: [
    {
      id: "oauth",
      label: "OAuth",
      kind: "oauth",
      run: async (ctx) => {
        // Run OAuth flow and return auth profiles.
        return {
          profiles: [
            {
              profileId: "acme:default",
              credential: {
                type: "oauth",
                provider: "acme",
                access: "...",
                refresh: "...",
                expires: Date.now() + 3600 * 1000,
              },
            },
          ],
          defaultModel: "acme/opus-1",
        };
      },
    },
  ],
});

• run は、prompter、runtime を含む ProviderAuthContext を受け取ります。 openUrl および oauth.createVpsAwareHandlers ヘルパー。
• デフォルトのモデルまたはプロバイダー構成を追加する必要がある場合は、configPatch を返します。
• --set-default がエージェントのデフォルトを更新できるように、defaultModel を返します。

​

メッセージング チャネルを登録する

const myChannel = {
  id: "acmechat",
  meta: {
    id: "acmechat",
    label: "AcmeChat",
    selectionLabel: "AcmeChat (API)",
    docsPath: "/channels/acmechat",
    blurb: "demo channel plugin.",
    aliases: ["acme"],
  },
  capabilities: { chatTypes: ["direct"] },
  config: {
    listAccountIds: (cfg) => Object.keys(cfg.channels?.acmechat?.accounts ?? {}),
    resolveAccount: (cfg, accountId) =>
      cfg.channels?.acmechat?.accounts?.[accountId ?? "default"] ?? {
        accountId,
      },
  },
  outbound: {
    deliveryMode: "direct",
    sendText: async () => ({ ok: true }),
  },
};

export default function (api) {
  api.registerChannel({ plugin: myChannel });
}

• 構成を channels.<id> (plugins.entries ではありません) の下に置きます。
• meta.label は、CLI/UI リストのラベルに使用されます。
• meta.aliases は、正規化および CLI 入力用の代替 ID を追加します。
• meta.preferOver は、両方が設定されている場合に自動有効化をスキップするチャネル ID をリストします。
• meta.detailLabel および meta.systemImage により、UI に豊富なチャンネル ラベル/アイコンが表示されます。

​

チャネルオンボーディングフック

• configureInteractive(ctx) は、構成済み状態と未構成状態の両方の対話型セットアップを完全に所有できます。
• configureWhenConfigured(ctx) は、すでに構成されているチャネルの動作のみをオーバーライドできます。

1. configureInteractive (存在する場合)
2. configureWhenConfigured (チャネルステータスがすでに構成されている場合のみ)
3. configure へのフォールバック

• configureInteractive および configureWhenConfigured は以下を受け取ります。
  • configured (true または false)
  • label (プロンプトで使用されるユーザー向けチャネル名)
  • 共有設定/ランタイム/プロンプター/オプション フィールドに加えて
• "skip" を返すと、選択とアカウント追跡は変更されません。
• { cfg, accountId? } を返すと、構成の更新が適用され、アカウントの選択が記録されます。

​

新しいメッセージング チャネルを作成する (ステップバイステップ)

1. ID と構成の形状を選択します

• すべてのチャネル構成は channels.<id> の下に存在します。
• マルチアカウント設定には channels.<id>.accounts.<accountId> を推奨します。

2. チャネルメタデータを定義する- meta.label、meta.selectionLabel、meta.docsPath、meta.blurb は CLI/UI リストを制御します。

• meta.docsPath は、/channels/<id> のようなドキュメント ページを指す必要があります。
• meta.preferOver により、プラグインが別のチャンネルを置き換えることができます (自動有効化が優先されます)。
• meta.detailLabel および meta.systemImage は、詳細テキスト/アイコンの UI によって使用されます。

3. 必要なアダプターを実装する

• config.listAccountIds + config.resolveAccount
• capabilities (チャットの種類、メディア、スレッドなど)
• outbound.deliveryMode + outbound.sendText (基本送信用)

4. 必要に応じてオプションのアダプターを追加します

• setup (ウィザード)、security (DM ポリシー)、status (ヘルス/診断)
• gateway (開始/停止/ログイン)、mentions、threading、streaming
• actions (メッセージ アクション)、commands (ネイティブ コマンド動作)

5. プラグインにチャンネルを登録します

• api.registerChannel({ plugin })

{
  channels: {
    acmechat: {
      accounts: {
        default: { token: "ACME_TOKEN", enabled: true },
      },
    },
  },
}

const plugin = {
  id: "acmechat",
  meta: {
    id: "acmechat",
    label: "AcmeChat",
    selectionLabel: "AcmeChat (API)",
    docsPath: "/channels/acmechat",
    blurb: "AcmeChat messaging channel.",
    aliases: ["acme"],
  },
  capabilities: { chatTypes: ["direct"] },
  config: {
    listAccountIds: (cfg) => Object.keys(cfg.channels?.acmechat?.accounts ?? {}),
    resolveAccount: (cfg, accountId) =>
      cfg.channels?.acmechat?.accounts?.[accountId ?? "default"] ?? {
        accountId,
      },
  },
  outbound: {
    deliveryMode: "direct",
    sendText: async ({ text }) => {
      // deliver `text` to your channel here
      return { ok: true };
    },
  },
};

export default function (api) {
  api.registerChannel({ plugin });
}

​

エージェントツール

​

ゲートウェイ RPC メソッドを登録する

export default function (api) {
  api.registerGatewayMethod("myplugin.status", ({ respond }) => {
    respond(true, { ok: true });
  });
}

​

CLI コマンドを登録する

export default function (api) {
  api.registerCli(
    ({ program }) => {
      program.command("mycmd").action(() => {
        console.log("Hello");
      });
    },
    { commands: ["mycmd"] },
  );
}

​

自動応答コマンドを登録するプラグインは、** を呼び出さずに実行するカスタム スラッシュ コマンドを登録できます

export default function (api) {
  api.registerCommand({
    name: "mystatus",
    description: "Show plugin status",
    handler: (ctx) => ({
      text: `Plugin is running! Channel: ${ctx.channel}`,
    }),
  });
}

• senderId: 送信者の ID (利用可能な場合)
• channel: コマンドが送信されたチャネル
• isAuthorizedSender: 送信者が承認されたユーザーかどうか
• args: コマンドの後に渡される引数 (acceptsArgs: true の場合)
• commandBody: コマンドの全文
• config: 現在の OpenClaw 構成

• name: コマンド名 (先頭の / を除く)
• nativeNames: スラッシュ/メニュー サーフェイスのオプションのネイティブ コマンド エイリアス。すべてのネイティブ プロバイダーには default を使用するか、discord のようなプロバイダー固有のキーを使用します。
• description: コマンド リストに表示されるヘルプ テキスト
• acceptsArgs: コマンドが引数を受け入れるかどうか (デフォルト: false)。 false で引数が指定されている場合、コマンドは一致せず、メッセージは他のハンドラーに渡されます。
• requireAuth: 承認された送信者を要求するかどうか (デフォルト: true)
• handler: { text: string } を返す関数 (非同期可能)

api.registerCommand({
  name: "setmode",
  description: "Set plugin mode",
  acceptsArgs: true,
  requireAuth: true,
  handler: async (ctx) => {
    const mode = ctx.args?.trim() || "default";
    await saveMode(mode);
    return { text: `Mode set to: ${mode}` };
  },
});

• コマンドはグローバルに登録され、すべてのチャネルで機能します
• コマンド名は大文字と小文字を区別しません (/MyStatus は /mystatus と一致します)
• コマンド名は文字で始まり、文字、数字、ハイフン、アンダースコアのみを含む必要があります
• 予約されたコマンド名 (help、status、reset など) はプラグインによってオーバーライドできません
• プラグイン間でコマンドを重複して登録すると、診断エラーが発生して失敗します。

​

バックグラウンド サービスを登録する

export default function (api) {
  api.registerService({
    id: "my-service",
    start: () => api.logger.info("ready"),
    stop: () => api.logger.info("bye"),
  });
}

​

命名規則

• ゲートウェイメソッド: pluginId.action (例: voicecall.status)
• ツール: snake_case (例: voice_call)
• CLI コマンド: kebab または Camel、ただしコア コマンドとの衝突を避ける

​

スキル

​

配布 (npm)

• メインパッケージ: openclaw (このリポジトリ)
• プラグイン: @openclaw/* の下の個別の npm パッケージ (例: @openclaw/voice-call)

• エントリ ファイルは .js または .ts です (jiti は実行時に TS をロードします)。
• openclaw plugins install <npm-spec> は npm pack を使用し、~/.openclaw/extensions/<id>/ に抽出し、構成で有効にします。
• 構成キーの安定性: スコープ付きパッケージは、plugins.entries.* の スコープ外 ID に正規化されます。

​

プラグインの例: 音声通話

• 出典: extensions/voice-call
• スキル: skills/voice-call
• CLI: openclaw voicecall start|status
• ツール: voice_call
• RPC: voicecall.start、voicecall.status
• 構成 (twilio): provider: "twilio" + twilio.accountSid/authToken/from (オプションの statusCallbackUrl、twimlUrl)
• 構成 (開発): provider: "log" (ネットワークなし)

​

安全上の注意事項

• 信頼できるプラグインのみをインストールしてください。
• plugins.allow 許可リストを優先します。
• 変更後にゲートウェイを再起動します。

​

プラグインのテスト

• リポジトリ内プラグインは、Vitest テストを src/** の下に保持できます (例: src/plugins/voice-call.plugin.test.ts)。
• 別途公開されたプラグインは、独自の CI (lint/build/test) を実行し、ビルドされたエントリポイント (dist/index.js) で openclaw.extensions ポイントを検証する必要があります。