🦀 OpenClaw .NET

Build an AI Agent Platform in .NET 10 with GitHub Copilot

OpenClaw .NET is the companion repo for the Microsoft Reactor live series on building production‑ready AI agents with .NET 10, Aspire, Blazor and GitHub Copilot. It contains the complete application source, tests, manuals, demos, and per‑session attendee materials — everything you need to follow along live, or rebuild the whole platform on your own machine.

👉 First time here? Start with SETUP.md for a step‑by‑step local setup (prerequisites, hardware, clone, build, run, first chat, troubleshooting).

🌐 Browse the published site: https://elbruno.github.io/openclawnet/ — session slides, live test dashboard, and quick links to materials.

---

📺 Reactor Series — Register

Language	Series Page
🇺🇸 English	Building an AI Agent Platform in .NET 10 with GitHub Copilot
🇪🇸 Español	Construye una Plataforma de Agentes AI en .NET 10 con GitHub Copilot

---

📅 The 4‑Session Journey (50 min each)

#	Session	Focus	Materials
1	Foundation + Local Chat	Architecture, local LLM providers, SignalR streaming, Blazor UI	sessions/session-1
2	Tools + Agent Workflows	Tool framework, security model, agent orchestrator loop	sessions/session-2
3	Skills + Memory	Markdown skills, context management, semantic search	sessions/session-3
4	Automation + Cloud	Cloud providers, job scheduling, testing, production readiness	sessions/session-4

Each session uses an Explain → Explore → Extend approach: walk the architecture, run live demos, then add features with GitHub Copilot.

---

🚀 Quick Start

git clone https://github.com/elbruno/openclawnet.git
cd openclawnet

# Pull a local model
ollama pull llama3.2

# Build & run
dotnet build
aspire start

Open the Web URL from the Aspire dashboard (typically http://localhost:5010) and say hello.

For the full guide — including hardware requirements, the four model providers, the Jobs/Tools demos, and troubleshooting — see SETUP.md.

---

🏗️ Architecture

Blazor Web UI ──SignalR──▶ Gateway API ──▶ Agent Orchestrator
                                              │
                           ┌──────────────────┼──────────────┐
                           ▼                  ▼              ▼
                     Model Provider      Tool Framework   Skills System
                     (Ollama/Foundry     (File/Shell/     (Markdown +
                      Local/Azure/...)    Web/Schedule)    YAML)
                                              │
                                              ▼
                                         SQLite Storage

Session 1 starts with just the chatbot path (UI → Gateway → Model → Storage). Each session adds a new layer until you have the full agent platform.

---

📁 What's in the Repo

• src/ — the full .NET 10 + Aspire application (40+ projects: Gateway, Web, Agent, Memory, Skills, Storage, model providers, tools, MCP servers).
• tests/ — Unit, Integration, and Playwright E2E test suites.
• docs/manuals/ — user‑facing manuals (prerequisites, installation, settings, tools, jobs).
• docs/demos/ — short demo scripts (aspire‑stack, gateway‑only, tools, real‑world scenarios).
• docs/analysis/ — architecture and design analyses.
• scripts/ — helper PowerShell scripts (prereqs, reset, dashboard publish).
• sessions/ — per‑session attendee materials (READMEs, scripts, slides, demo code).

See the What's Where section in SETUP.md for a per‑folder breakdown.

---

📦 Versioning & Release

OpenClaw .NET v1.0.0 is intended to be the project's first, source-only GitHub release, cut from the current main branch.

• OpenClawNet projects are not published to NuGet.org.
• The v1.0.0 tag is the release gate for .github/workflows/release.yml; do not create or push the tag until that workflow is present on the exact main commit being released.
• The release contains no uploaded binaries or packages. GitHub's automatically generated source .zip and .tar.gz archives are the only downloads.
• Package versions are defined in the individual project files. SixLabors.ImageSharp remains at 3.1.12 (MIT) because 4.x requires a commercial-license decision.
• PR CI validates the offline Windows win-x64 unit and mocked Azure unit test projects. Integration, E2E, Playwright, deployment, and live-service tests remain environment-dependent and are not part of the PR gate.

See Release Guidance for the exact tag process, CI scope, and validation blockers.

---

💬 Community

• Discord: Microsoft Foundry Community (.NET channel)
• Issues: Open an issue
• Resources: Generative AI for Beginners .NET · .NET Aspire

---

👋 About the Author

Hi! I'm ElBruno 🧡, a passionate developer and content creator exploring AI, .NET, and modern development practices.

Made with ❤️ by ElBruno

If you like this project, consider following my work across platforms:

• 🔗 Blog: ElBruno.com — Deep dives on embeddings, RAG, .NET, and local AI
• 💻 YouTube: youtube.com/elbruno — Demos, tutorials, and live coding
• 📺 LinkedIn: @elbruno — Professional updates and insights
• 𝕏 Twitter: @elbruno — Quick tips, releases, and tech news
• 📻 Podcast: No Tienen Nombre — Spanish-language episodes on AI, development, and tech culture

---

📄 License

MIT License — see LICENSE for details.

Built with ❤️ for the .NET and AI developer community. 🦀