Foundry

自らを鍛える炉。

Foundry は、OpenClaw 用の自己記述型メタ拡張であり、あなたがどのように作業するかを学び、ドキュメントを調査し、新しい機能を自身へと書き込むことができます。ワークフローを観察し、パターンをツール化し、運用に合わせて自らをアップグレードします。

$FDRY — dexscreener · Solana
┌─────────────────────────────────────────────────────────────┐
│                         FOUNDRY                             │
│                                                             │
│   Observe ──► Research ──► Learn ──► Write ──► Deploy      │
│       │          │          │          │          │         │
│       ▼          ▼          ▼          ▼          ▼         │
│   workflows   docs.openclaw  patterns  extensions  gateway  │
│   tool calls  arXiv papers   insights  tools       restart  │
│   outcomes    GitHub repos   workflows hooks       resume   │
│                                        skills              │
└─────────────────────────────────────────────────────────────┘

OpenClaw と Foundry の違い

foundry_extend_self

x402

OpenClaw の構成図

OpenClaw
├── Gateway
├── Channels (Discord, Slack, Telegram…)
├── Skills & Tools
└── Plugins
    └── Foundry
        ├─ 観察 → あなたのワークフローを監視
        ├─ 調査 → docs、論文、リポジトリを探索
        ├─ 書き込み → 拡張・スキル・フックを生成
        ├─ 学習 → 結果から学ぶ
        ├─ 形態化 → パターンをツールに固める
        └─ 公開 → マーケットプレイスへ送信

自己記述コードの重要性

パターンは「Xが起きたらYを行う」と宣言します。
自己書き込みコードは X が発生したときに Y を自動で実行します。

ワークフロー学習

Foundry はすべてのワークフローを追跡します：

• Goal – 例：staging にデプロイ
• Tools – git → build → test → deploy
• Outcome – success / failure / partial
• Duration – 45 s

時間とともにパターンが浮上します。
5 回以上使用され、成功率が 70 % を超えるパターンは Foundry が専用ツールへと固めます。

Foundry 観察 → パターン学習 & ドキュメント調査
      ↓
ツール/フックを書き込み、ワークフローに合わせる
      ↓
コードが Foundry の一部になる
      ↓
より良い Foundry がさらに書き込む
      ↓
繰り返し

主な機能

自己記述コード生成

• OpenClaw 拡張（ツール・フック付き）を作成
• API スキル (AgentSkills フォーマット + YAML フロントマター) を生成
• ブラウザ自動化スキル (CDP 統合) を生成
• 独立フック (

  HOOK.md

  +

  handler.ts

  ) を作成
• 新機能で自己拡張
• デプロイ前に隔離サンドボックスでコードを検証

ワークフロー学習 & 形態化

• 目標 → ツール列 → 結果をすべて追跡
• 目標からキーワード抽出してパターン照合
• 成功率と平均時間を算出
• 高価値パターン（≥5 回、成功率 ≥70 %）をツールへ固化
• 類似タスク開始時に関連パターンを提案

Overseer

毎時間自動実行：

• 形態化候補の検出
• 高価値パターンからツールを自動生成
• 30 日以上未使用の古いパターンを除去
• ツール性能メトリクス（ADAS‑style）を追跡
• 実施したアクションを報告

OpenClaw ネイティブ統合

• AgentSkills フォーマット：YAML フロントマターに

  emoji

  、

  requires

  、

  events

  を含む
• ブラウザ自動化：認証済みワークフロー用 CDP ベースのブラウザツール
• スキルゲーティング：

  requires.config

  、

  requires.bins

  、

  requires.env

  を自動生成
• フックシステム：OpenClaw の全フックイベント（gateway:startup, command:new など）を完全サポート
• ClawdHub 対応：スキルは ClawdHub レジストリへ公開可能

プロアクティブ学習

ツールの成功/失敗を文脈付きで記録し、繰り返されるワークフローからパターンを構築。Foundry Marketplace で知見を共有し、エージェント会話に関連コンテキストを注入。

サンドボックス検証

生成コードを隔離 Node プロセスで実行し、ランタイムエラーを捕捉。静的セキュリティスキャン（シェル実行、

eval

Restart Resume

ゲートウェイ再起動前に会話コンテキストを保存し、管理フックで自動復帰。自己変更時の作業ロスは発生しない。

インストール

Install the Foundry plugin

bash<br>npm install -g @lekt9/foundry<br><br>{ "plugins": { "entries": { "foundry": { "enabled": true } } } }</sub>

~/.openclaw/openclaw.json

~/.openclaw/openclaw.json

<source>

"github:lekt9/openclaw-foundry"

nix run github:lekt9/openclaw-foundry

bash<br>git clone https://github.com/lekt9/openclaw-foundry ~/.openclaw/extensions/foundry<br>cd ~/.openclaw/extensions/foundry && npm install<br>

設定例

{
  "plugins": {
    "entries": {
      "foundry": {
        "enabled": true,
        "source": "github:lekt9/openclaw-foundry",
        "config": {
          "autoLearn": true,
          "sources": {
            "docs": true,
            "experience": true,
            "arxiv": true,
            "github": true
          },
          "marketplace": {
            "autoPublish": false
          }
        }
      }
    }
  }
}

autoLearn

true

sources.docs

true

sources.experience

true

marketplace.autoPublish

false

ツール一覧

調査・学習

• foundry_research – docs.openclaw.ai でベストプラクティスやパターン検索
• foundry_docs – 特定ドキュメントページ（プラグイン、フック、ツール等）を読む
• foundry_learnings – 記録されたパターン・ワークフロー・洞察を見る

コード生成

• foundry_implement – 調査＋エンドツーエンドで機能実装
• foundry_write_extension – ツール/フック付き OpenClaw 拡張を書き込む
• foundry_write_skill – API スキルパッケージ (

  SKILL.md

  +

  api.ts

  ) を生成
• foundry_write_browser_skill – CDP 統合のブラウザ自動化スキルを書く
• foundry_write_hook – 独立フック (

  HOOK.md

  +

  handler.ts

  ) を作成
• foundry_add_tool – 既存拡張にツールを追加
• foundry_add_hook – 既存拡張にフックを追加
• foundry_extend_self – Foundry 自体へ機能追加

管理

• foundry_list – 作成済みの拡張とスキル一覧
• foundry_restart – コンテキスト保存付きゲートウェイ再起動
• foundry_publish_ability – パターン/拡張を Foundry Marketplace に公開
• foundry_marketplace – 検索、リーダーボード閲覧、インストール

バンドルスキル

Foundry には自動で利用可能な組み込みスキルがあります：

foundry-browser-helper

クイックリファレンス

browser open https://example.com
browser snapshot           # AI が読める形式で取得
browser click ref=btn_submit
browser type ref=input_email "user@example.com"

仕組み（フェーズ）

1. Observe – 目標、ツール列、結果、時間を記録
2. Research – docs・論文・リポジトリからパターン探索
3. Learn – 成功率を追跡し、形態化候補を特定
4. Write – TypeScript で拡張/スキル/フックコード生成（型安全、エラーハンドリング付き）
5. Deploy –

   ~/.openclaw/extensions/

   に書き込み、

   openclaw.plugin.json

   を作成しゲートウェイ再起動。会話は自動復帰。

スキル生成フォーマット

API スキル (AgentSkills)

---
name: my-api-skill
description: Integrates with My API service
metadata:
  openclaw:
    emoji: 🔌
    requires:
      env: ["MY_API_KEY"]
---
# My API Skill

## Authentication
This skill requires the `MY_API_KEY` environment variable.

## Endpoints
- `GET /users` – List all users
- `POST /users` – Create a new user

ブラウザ自動化スキル

---
name: my-browser-skill
description: Automates login workflow
metadata:
  openclaw:
    emoji: 🌐
    requires:
      config: ["browser.enabled"]
---
# My Browser Skill

## Workflow
1. Open login page
2. Fill credentials
3. Submit form
4. Verify success

独立フック

my-hook/
├── HOOK.md          # フロントマター + ドキュメント
└── handler.ts       # イベントハンドラコード

サンドボックスセキュリティ

child_process / exec / spawn

eval()

new Function()

~/.ssh/

id_rsa

~/.aws/

aws_secret

警告：

• process.env

  – 環境変数アクセス

• fs.readFile / fs.writeFile

  – ファイルシステムアクセス
• Base64 エンコード – 隠蔽の可能性

ランタイム検証手順：

1. 拡張を一時ディレクトリへ書き込み
2. 独立 Node プロセス (

   tsx

   ) を起動
3. OpenClaw API をモック

4. register()

   をインポート・実行
5. エラーがあれば拒否、無ければデプロイ

Foundry Marketplace

x402 Solana USDC 支払いで機能を公開／ダウンロード。

# ワークフローパターンを公開
foundry_publish_ability type="pattern" name="Deploy Staging" patternId="wp_123"

# 既存パターン検索
foundry_marketplace action="search" query="deploy" type="pattern"

# リーダーボード表示
foundry_marketplace action="leaderboard"

# パターンをインストールし適用
foundry_marketplace action="install" id="abc123"

x402 プロトコル

• サーバーは HTTP 402 と支払い要件を返す
• USDC トランザクションを自分のウォレットで署名
• 署名付きトランザクションをヘッダーに添えて再送信するとスキルが取得できる

能力タイプ & 価格

詳細設定

{
  "plugins": {
    "entries": {
      "foundry": {
        "enabled": true,
        "config": {
          "dataDir": "~/.openclaw/foundry",
          "openclawPath": "/path/to/openclaw",
          "autoLearn": true,
          "sources": {
            "docs": true,
            "experience": true,
            "arxiv": false,
            "github": false
          },
          "marketplace": {
            "url": "https://api.claw.getfoundry.app",
            "autoPublish": false
          }
        }
      }
    }
  }
}

dataDir

~/.openclaw/foundry

openclawPath

autoLearn

true

sources.docs

true

sources.experience

true

sources.arxiv

true

sources.github

true

marketplace.url

https://api.claw.getfoundry.app

marketplace.autoPublish

false

研究基盤

Foundry の自己改善メカニズムは、最新の自律学習エージェント研究に基づいています。

foundry_extend_self

コア原則

“基本的なコーディングツールを備えたエージェントシステムは、自らを自律的に編集し、性能を向上させることができる。” – Robeyns et al.

Foundry はこの理念を具現化します：コードを書いているシステムが書かれるコードそのものです。

主要ディレクトリ構成

~/.openclaw/foundry/
├── workflows.json            # 記録されたワークフロー
├── workflow-patterns.json    # 形態化候補
└── learnings.json            # パターン、洞察、結果

~/.openclaw/extensions/       # 生成拡張が置かれる場所
~/.openclaw/skills/           # 生成スキルが置かれる場所
~/.openclaw/hooks/foundry-resume/   # 再起動復帰フック

開発手順

# 型チェック
npx tsc --noEmit

# 拡張をローカルでテスト
openclaw gateway restart
tail -f ~/.openclaw/logs/gateway.log | grep foundry

ライセンス

MIT – OpenClaw で構築。Foundry により鍛えられた。