OpenClaw プラグイン

Weave for Agents はパブリックプレビューです。一般提供前に、機能、API、Agents view UI は変更される可能性があります。

Weave OpenClaw プラグインは、OpenClaw ゲートウェイを介して実行されるすべてのエージェントセッションを自動的にトレースし、その構造化データを W&B Weave に送信します。アプリケーションコードを変更しなくても、すべてのターン、モデル呼び出し、ツール実行がログされます。これらのトレースを使用して、セッションのデバッグ、ツール使用状況の監査、Runs 全体でのコストとレイテンシの監視を行えます。このガイドは、ゲートウェイの背後で実行されるエージェントに対して Weave トレースを有効にしたい OpenClaw ゲートウェイ運用担当者向けです。プラグインのインストール、設定、生成されたトレースの確認方法、および一般的な問題のトラブルシューティングについて説明します。

このプラグインは、OpenClaw のセッションデータを Weave に送信します。このデータには、ユーザープロンプト、モデル応答、ツールの入力と出力、ツールの結果、会話履歴が含まれる場合があります。このプラグインは、個人を特定できる情報 (PII) の除去や機密データのマスキングを実装していません。コンテンツの取得を抑止する必要がある場合は、プラグイン設定で captureContent: false を設定してください。セキュリティ要件またはコンプライアンス要件により、このデータを Weave に送信できない場合は、このプラグインをインストールしないでください。

前提条件

Node.js v22.14 以降。
プラグイン API を備えた OpenClaw 2026.4.25 以降。
W&B アカウントと APIキー。
トレースの受信先となる Weave プロジェクト ([YOUR-TEAM]/[YOUR-PROJECT])。

プラグインをインストールする

以下の手順を実行して、プラグインをインストールし、OpenClaw ゲートウェイに登録して、トレースが Weave project に届くことを確認します。

パッケージをインストールします。

openclaw plugins install weave-openclaw

完全な名前 weave-openclaw を使用してください (weave 単体はこのプラグインではなく W&B SDK です) 。プラグインは OpenClaw ゲートウェイが設定を通じて読み込みます。アプリケーションコードから import する必要はありません。

ゲートウェイ設定にプラグインを追加します。

デフォルトの設定ファイルの場所は ~/.openclaw/openclaw.json です (JSON5 形式のため、コメントと末尾のカンマを使用できます) 。まだファイルがない場合は、openclaw onboard を実行してひな形を生成します。ご利用の project に合わせて [YOUR-TEAM] と [YOUR-PROJECT] を更新してください。

{
  plugins: {
    allow: ["weave"],
    entries: {
      weave: {
        enabled: true,
        config: { entity: "YOUR-TEAM", project: "YOUR-PROJECT" },
        hooks: { allowConversationAccess: true },
      },
    },
  },
}

OpenClaw がコンテンツを含む hooks (llm_input、llm_output、agent_end) を実行し、スパンに入力テキストと出力テキスト、tool の引数、および tool の結果が含まれるように、hooks.allowConversationAccess を true に設定します。diagnostics.enabled はデフォルトで有効です。無効にする必要がある場合にのみ、明示的に設定してください。

ゲートウェイを再起動して確認します。

OpenClaw ゲートウェイを再起動し、その後、任意の OpenClaw チャット画面で /weave status を実行して、プラグインが有効になっていることを確認します。最初のエージェント run から数秒以内に、https://wandb.ai/[YOUR-TEAM]/[YOUR-PROJECT] にトレースが表示されます。

Weave で OpenClaw のトレースを表示する

プラグインが有効になると、各エージェントセッションで Weave UI で確認できるトレースが生成されます。少なくとも 1 つのエージェントセッションを実行した後、Weave UI で project を開きます。

https://wandb.ai にアクセスし、project を選択します。
サイドバーで、マルチターンのチャットビューとエージェントごとのバージョン別グループ化を表示するには Agents を選択し、生のスパンツリーを表示するには Traces を選択します。
会話を選択して、セッションツリー全体を確認します。

Agents ビューの詳細については、View agent activity を参照してください。プラグインは、OpenTelemetry (OTel) GenAI semantic conventions に従ってスパンを出力します。

スパン	出力タイミング	主な属性
`invoke_agent <agent>`	各エージェント run ごと	`gen_ai.agent.name`, `gen_ai.conversation.id`, 累積コスト、トークン使用量
`chat <model>`	各モデル呼び出しごと	`gen_ai.request.model`, `gen_ai.usage.input_tokens`, `gen_ai.usage.output_tokens`
`execute_tool <tool>`	各ツール実行ごと	`gen_ai.tool.name`, `gen_ai.tool.call.id`

設定リファレンス

このセクションでは、openclaw.json 内の weave プラグインエントリに関する完全な設定リファレンスを示します。 apiKey フィールドでは、4 つの認証ソースを次の順序で解決します。

source: "env" または source: "file" を持つ SecretRef オブジェクト (以下の例の 10 行目を参照) 。
リテラルの apiKey string (サポートされていますが、推奨されません) 。
WANDB_API_KEY 環境変数。
Weave ホスト用の ~/.netrc エントリ (wandb login によって設定されます) 。

{
  plugins: {
    entries: {
      weave: {
        enabled: true,
        config: {
          entity: "YOUR-TEAM",
          project: "YOUR-PROJECT",
          // apiKey を省略した場合、env から WANDB_API_KEY を読み取ります。
          // SecretRef は source: "env" または "file" をサポートします:
          //   { source: "env",  provider: "default", id: "WANDB_API_KEY" }
          //   { source: "file", provider: "default", id: "/run/secrets/wandb" }
          // プレーン文字列はサポートされますが、推奨しません。
          apiKey: { source: "env", provider: "default", id: "WANDB_API_KEY" },
          serviceName: "openclaw-agent",
          // 省略可能。Agents タブでのグループ化精度が向上します。
          agentName: "my-agent",
          agentVersion: "v1.0",
          agentDescription: "What my agent does.",
          // デフォルトは ON です。コンプライアンスや保持ポリシーに基づき
          // 完全に無効化する場合は false を設定してください。プラグインは取得した
          // 文字列をマスクしないため、必要に応じて上流で除去してください。
          captureContent: true,
          flushIntervalMs: 1000,
        },
        hooks: { allowConversationAccess: true },
      },
    },
  },
}

captureContent のデフォルト値は true です。captureContent が true の場合、プラグインは、入力メッセージと出力メッセージ、tool の引数、tool の結果も、gen_ai.input.messages および gen_ai.output.messages の payload 形式に従って出力します。プラグインは、サブエージェント、compaction イベント、loop detection、retry attempts、context sizing を、追加の属性およびスパンイベントとして付与します。コンプライアンス要件または保持ポリシーのために取得を無効にするには、captureContent を false に設定します。

W&B Dedicated Cloud またはセルフホスト環境のインスタンス

このプラグインは、エンドポイントと認証を Weave Node SDK に委譲します。Weave Python SDK および Node SDK と同じ規則で、次の環境変数を読み取ります。

変数	説明
`WANDB_BASE_URL`	W&B API のベース URL。デフォルト: `https://api.wandb.ai`。Dedicated Cloud またはセルフホスト環境にインストールする場合は、これを設定します。
`WF_TRACE_SERVER_URL`	trace-server の完全な URL を上書きします。セルフマネージド環境またはプロキシ経由の構成で使用します。

トラブルシューティング

トレースが Weave に届かない場合やコンテンツフィールドが空の場合は、最も一般的な原因を診断するために以下のセクションを使用してください。ゲートウェイのログは、openclaw を実行しているプロセスのターミナル出力、またはデーモン化している場合はプロセスマネージャーのログストリームを指します。

プラグインは読み込まれているのに、スパンが表示されない

/weave status を実行します。lifecycle が disabled、config-error、または not-started の場合、プラグインは有効になっていません。ゲートウェイのログに weave: config.entity is required、weave: configuration error、または [weave] incompatible plugin SDK が出ていないか確認してください。
ゲートウェイの設定で diagnostics.enabled: false を設定していないことを確認してください。このフィールドは true である必要があります。
entity と project が、確認中の Weave project の URL スラッグと一致していることを確認してください。/weave status には project=[YOUR-TEAM]/[YOUR-PROJECT] と表示されるはずです。
認証の取得元を確認してください。/weave status には auth=... と表示されるはずです。WANDB_API_KEY env と表示されているのに、キーを別の環境変数に設定している場合は、プラグインが誤ったキーを読み取っています。

スパンは届くものの、input/output テキストが空です

ゲートウェイのログで次を確認してください。

[plugins] typed hook "llm_input"  blocked because non-bundled plugins must set
                                  plugins.entries.weave.hooks.allowConversationAccess=true
[plugins] typed hook "llm_output" blocked ...
[plugins] typed hook "agent_end"  blocked ...

OpenClaw では、コンテンツを含む hook は operator が明示的に有効化した場合にのみ利用できます。設定で plugins.entries.weave.hooks.allowConversationAccess: true を設定し、ゲートウェイを再起動してください。スパン構造とコストおよび使用量データは hook ではなく診断イベント経由で送信されるため、allowConversationAccess が false の場合でも引き続き動作します。

Weave へのトレース送信エラー

プラグインが有効でスパンを生成しているのに Weave に表示されない場合は、エクスポートエラーがないかゲートウェイのログを確認し、以下の表と照らし合わせてください。

症状	最も可能性の高い原因	対処方法
`trace.wandb.ai` からの `401` または `403`	無効な APIキー、またはスコープが制限された APIキー	キーが現在も有効であり、チームが entity と project を所有していることを確認してください。`wandb login` を実行すると `~/.netrc` が更新されます。
agents endpoint からの `404`	ベース URL または trace-server URL が誤っている	Dedicated インストールでは、`WANDB_BASE_URL` をインストール先ホストに設定してください。セルフマネージド環境またはプロキシ環境では、`WF_TRACE_SERVER_URL` を trace-server URL に設定してください。
接続拒否または DNS エラー	DNS、プロキシ、またはファイアウォール	ゲートウェイホストから `trace.wandb.ai` (クラウド) またはインストール先ホスト (Dedicated) の `443` に到達できることを確認してください。

スタートガイド

ガイド

クックブック

リファレンス

詳細とサポート

前提条件

プラグインをインストールする

Weave で OpenClaw のトレースを表示する

設定リファレンス

W&B Dedicated Cloud またはセルフホスト環境のインスタンス

トラブルシューティング

プラグインは読み込まれているのに、スパンが表示されない

スパンは届くものの、input/output テキストが空です

Weave へのトレース送信エラー

​前提条件

​プラグインをインストールする

​Weave で OpenClaw のトレースを表示する

​設定リファレンス

​W&B Dedicated Cloud またはセルフホスト環境のインスタンス

​トラブルシューティング

​プラグインは読み込まれているのに、スパン が表示されない

​スパン は届くものの、input/output テキストが空です

​Weave へのトレース送信エラー

前提条件

プラグインをインストールする

Weave で OpenClaw のトレースを表示する

設定リファレンス

W&B Dedicated Cloud またはセルフホスト環境のインスタンス

トラブルシューティング

プラグインは読み込まれているのに、スパンが表示されない

スパンは届くものの、input/output テキストが空です

Weave へのトレース送信エラー