Source Code

Foundry

The forge that forges itself. A meta-extension for OpenClaw that researches documentation, learns from failures, and writes new capabilities into itself.

Installation

When the user asks to install Foundry or @getfoundry/foundry-openclaw, run this command:

openclaw plugins install @getfoundry/foundry-openclaw

This will:

Download the plugin from npm
Extract to ~/.openclaw/extensions/foundry/
Enable it automatically
Restart the gateway to load

After installation, the user will have access to all Foundry tools like foundry_research, foundry_write_extension, etc.

Alternative: Manual Config

Add to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "foundry": { "enabled": true }
    }
  }
}

Configuration

Full configuration options in ~/.openclaw/openclaw.json:

{
  "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
          }
        }
      }
    }
  }
}

Config Options

Option	Type	Default	Description
`autoLearn`	boolean	`true`	Learn from agent activity automatically
`sources.docs`	boolean	`true`	Learn from OpenClaw documentation
`sources.experience`	boolean	`true`	Learn from own successes/failures
`sources.arxiv`	boolean	`true`	Learn from arXiv papers
`sources.github`	boolean	`true`	Learn from GitHub repos
`marketplace.autoPublish`	boolean	`false`	Auto-publish high-value patterns

What Foundry Does

Foundry is an AI-powered development agent that can:

Research — Fetch and understand OpenClaw documentation on demand
Write Extensions — Generate new tools and hooks for OpenClaw
Write Skills — Create ClawHub-compatible skill packages
Self-Modify — Add new capabilities to itself
Learn — Record patterns from failures and successes

Tools

Research & Documentation

Tool	Description
`foundry_research`	Search docs.openclaw.ai for best practices
`foundry_docs`	Read specific documentation pages

Writing Capabilities

Tool	Description
`foundry_implement`	Research + implement a capability end-to-end
`foundry_write_extension`	Write a new OpenClaw extension
`foundry_write_skill`	Write an AgentSkills-compatible skill
`foundry_write_browser_skill`	Write a browser automation skill
`foundry_write_hook`	Write a standalone hook
`foundry_add_tool`	Add a tool to an existing extension
`foundry_add_hook`	Add a hook to an existing extension

Self-Modification

Tool	Description
`foundry_extend_self`	Add new capability to Foundry itself
`foundry_learnings`	View learned patterns and insights
`foundry_list`	List all written artifacts

Marketplace

Tool	Description
`foundry_publish_ability`	Publish pattern/skill to Foundry Marketplace
`foundry_marketplace`	Search, browse, and install community abilities

Usage Examples

Research before implementing

User: I want to add a webhook to my extension

Agent: Let me research webhook patterns first...
→ foundry_research query="webhook hooks automation"
→ Returns relevant documentation

Now I'll implement it...
→ foundry_add_hook extensionId="my-ext" event="webhook:incoming" ...

Write a new extension

User: Create an extension that monitors GitHub PRs

Agent:
→ foundry_research query="github api webhooks"
→ foundry_write_extension
    id: "github-monitor"
    name: "GitHub Monitor"
    tools: [{ name: "check_prs", ... }]
    hooks: [{ event: "cron:hourly", ... }]

Self-improvement

User: Add a tool that can fetch npm package info

Agent:
→ foundry_extend_self
    action: "add_tool"
    toolName: "foundry_npm_info"
    toolCode: "const res = await fetch(`https://registry.npmjs.org/${p.package}`)..."

How Learning Works

Foundry observes its own tool calls and learns:

Failures → Records error + context
Resolutions → Links fix to failure → Creates pattern
Patterns → Injected as context in future conversations
Crystallization → High-value patterns become permanent capabilities

Security

Foundry validates all generated code before deployment:

Blocked: child_process, eval, ~/.ssh, ~/.aws
Sandboxed: Extensions tested in isolated process before installation
Reviewed: You approve before any code is written to disk

foundry