OpenClaw プラグイン

​

前提条件

• Node.js v24.16 以降、または v26.1 以降。Node.js v25 はサポートされていません。
• OpenClaw 2026.9.8 以降。
• CoreWeave Forge のアカウントと APIキー。
• トレースの送信先となる Agent Lens の project ([YOUR-TEAM]/[YOUR-PROJECT]) 。

​

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

openclaw plugins install clawhub:@coreweave/forge-agent-lens-for-openclaw

export WANDB_API_KEY="[YOUR-API-KEY]"

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

openclaw gateway restart

​

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

1. CoreWeave Forge にアクセスし、プロダクトメニューから Agent Lens を選択して、サイドメニュー上部の project セレクターで対象の project を選択します。
2. サイドメニューで Conversations を選択します。
3. Conversations タブを選択すると、project に保存されたすべてのエージェントの会話が表示されます。
4. 会話を選択すると、会話ツリー全体を確認できます。

​

設定リファレンス

1. プラグイン設定内の apiKey フィールド (SecretRef オブジェクトまたは値を直接記述した string)。セキュリティ上の理由から、値を直接記述した文字列の使用は推奨されません。
2. WANDB_API_KEY 環境変数。OpenClaw はこの環境変数を ~/.openclaw/.env からも読み込みます。
3. wandb login によって追加される、api.wandb.ai 用の ~/.netrc エントリ。

{
  plugins: {
    entries: {
      forge: {
        enabled: true,
        config: {
          entity: "YOUR-TEAM",
          project: "YOUR-PROJECT",
          // apiKey を省略した場合は、環境変数から WANDB_API_KEY を読み取ります。
          // SecretRef では source に "env"、"file"、または "exec" を指定できます。"env"
          // ソースは provider: "default" で動作します。"file" および "exec"
          // ソースには、対応する secrets.providers エントリが必要です。
          // プレーンな文字列も使用できますが、推奨されません。
          apiKey: { source: "env", provider: "default", id: "WANDB_API_KEY" },
          serviceName: "openclaw-agent",
          // オプション。Conversations タブでのグループ化が改善されます。
          agentName: "my-agent",
          agentVersion: "v1.0",
          agentDescription: "What my agent does.",
          // デフォルトで有効です。完全に無効にするには false に設定します（コンプライアンスや
          // データ保持ポリシーへの対応など）。プラグインは取得した文字列をマスクしないため、
          // 必要に応じて上流でマスクしてください。
          captureContent: true,
          // プラグインがトレースを送信する間隔 (ミリ秒)。最小値は 1000 です。
          flushIntervalMs: 1000,
        },
        hooks: { allowConversationAccess: true },
      },
    },
  },
}

​

トラブルシューティング

​

プラグインは読み込まれたがスパンが表示されない

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

​

スパンは記録されるが入力テキストが空になる

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

​

Agent Lens へのスパン送信エラー

​

プラグインを管理する

openclaw plugins update forge
openclaw plugins disable forge
openclaw plugins enable forge
openclaw plugins uninstall forge