██████╗ ██████╗ ███████╗███╗   ██╗ ██████╗██╗      █████╗ ██╗    ██╗
██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██║    ██║
██║   ██║██████╔╝█████╗  ██╔██╗ ██║██║     ██║     ███████║██║ █╗ ██║
██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██║     ██║     ██╔══██║██║███╗██║
╚██████╔╝██║     ███████╗██║ ╚████║╚██████╗███████╗██║  ██║╚███╔███╔╝
 ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

 █████╗  ██████╗ ███████╗███╗   ██╗████████╗    ███████╗ ██████╗ ██████╗  ██████╗ ███████╗
██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝    ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║       █████╗  ██║   ██║██████╔╝██║  ███╗█████╗
██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║       ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝
██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║       ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝  ╚═╝       ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝

Build and deploy autonomous AI agents in minutes — no code required.

Already have OpenClaw installed? Agent Forge will detect it and skip straight to agent configuration.

By BobbyCodes

---

╔══════════════════════════════════════╗
║         WHAT IS AGENT FORGE?        ║
╚══════════════════════════════════════╝

A slick terminal UI that guides you through spinning up a full fleet of AI agents powered by OpenClaw. Each agent gets its own persona, model, workspace, and automation hooks via n8n — all configured through an interactive wizard.

No YAML. No config files. Just run and go.

---

╔══════════════════════════════════════╗
║              FEATURES               ║
╚══════════════════════════════════════╝

• 🤖 10 pre-built agent types — Research, Coder, Writer, DevOps, Finance, and more
• 🧠 Per-agent model selection — assign a different LLM to each agent
• 🔗 n8n webhook integration — agents delegate actions to automation workflows
• ☁️ Any AI provider — Ollama Cloud, OpenRouter, OpenAI, Anthropic, Google
• 🪟 Windows + Linux — one script install on both platforms

---

╔══════════════════════════════════════╗
║             QUICKSTART              ║
╚══════════════════════════════════════╝

🪟 Windows

Right-click inside the folder → Open in Terminal, then:

powershell -ExecutionPolicy Bypass -File install.ps1

🐧 Linux / Proxmox

bash install.sh

The installer handles Python venv, dependencies, and OpenClaw CLI — then launches the TUI automatically.

Requirements: Python 3.10+ · Node.js 22+

---

╔══════════════════════════════════════╗
║            AGENT CATALOG            ║
╚══════════════════════════════════════╝

Agent	What it does
🔍 Research	Web research, fact-finding, summarization
💻 Coder	Code generation, review, debugging
✍️ Writer	Content creation, copywriting
🎧 Customer Support	Inquiry handling, FAQ, ticket triage
📊 Data Analyst	Data analysis, reporting, insights
🚀 DevOps	Deployments, monitoring, infrastructure
📅 Scheduler	Calendar, reminders, task coordination
📱 Social Media	Content creation, engagement monitoring
💰 Finance	Budgeting, expense tracking
🧪 QA Tester	Test writing, bug reporting

---

╔══════════════════════════════════════╗
║          PROVIDER SETUP             ║
╚══════════════════════════════════════╝

Agent Forge works with any provider OpenClaw supports. Use whichever you prefer:

Provider	Notes
☁️ Ollama Cloud	Recommended — huge model library, no local GPU needed
🔀 OpenRouter	Access hundreds of models with one API key
🤖 OpenAI	GPT-4o and friends
🧬 Anthropic	Claude models
🌐 Google	Gemini models

Ollama Cloud setup — during onboarding choose Custom Provider and enter:

Field	Value
Base URL	https://ollama.com/v1
Compatibility	OpenAI-compatible
API Key	from ollama.com/settings/keys
Model ID	gemma4:31b or any model at ollama.com/models

When asked "How do you want to hatch your bot?" — choose Later to return to Agent Forge.

---

╔══════════════════════════════════════╗
║       PER-AGENT MODEL SELECTION     ║
╚══════════════════════════════════════╝

Give each agent its own model. Enter the ID in your provider's format:

• Ollama Cloud: gemma4:31b, qwen3.5:397b
• OpenRouter: google/gemma-3-27b-it, qwen/qwen3-32b

---

╔══════════════════════════════════════╗
║          HOW AGENTS WORK            ║
╚══════════════════════════════════════╝

All agents are action-incapable by design — they reason and produce structured output, but all external actions are handed off to n8n via webhook:

{
  "agent": "coder",
  "action": "create_file",
  "payload": {},
  "priority": "normal",
  "timestamp": "2026-04-17T00:00:00Z"
}

This keeps the AI focused on thinking, and automation handles the doing.

---

╔══════════════════════════════════════╗
║            AFTER SETUP              ║
╚══════════════════════════════════════╝

Start the gateway and connect:

openclaw gateway run

Then open openclaw tui or the dashboard at http://127.0.0.1:18789.

---

  Made with 🦞 by BobbyCodes-dev
  ══════════════════════════