Cloudflare OS: installeren en instellen

Cloudflare OS: Review Nieuws

Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.

In deze handleiding zet je Cloudflare OS op: de open-source AI-werkomgeving van Cloudflare waarin een agent kleine apps ("gadgets") voor je bouwt en taken uitvoert, veilig afgeschermd. Je probeert het lokaal op je eigen computer of zet het in je eigen Cloudflare-account. Alles volgt de officiële README van de repository (stand september 2026).

Eerst even: wat installeer je?

Cloudflare OS is geen besturingssysteem voor je computer. Het is een webapplicatie die draait op de Workers-runtime van Cloudflare. Je werkt ermee in de browser, ongeveer zoals met een online kantoorpakket. Alleen maakt de agent voor elk "document" een eigen kleine app, die in een eigen sandbox draait.

Cloudflare noemt deze versie (v2, uitgebracht in augustus 2026) nadrukkelijk early access: veel kan al, maar er zitten nog ruwe randjes aan.

Wat je nodig hebt

Lokaal proberen: Git, Node.js en de pakketbeheerder pnpm. Een Cloudflare-account is niet nodig: de runtime (workerd) is open source en draait op je eigen machine.
Online zetten: een Cloudflare-account.
Een taalmodel: Cloudflare OS werkt met verschillende grote AI-providers en met zelfgehoste modellen.

Optie 1: lokaal proberen

Haal de code op en start de hele omgeving:

git clone https://github.com/cloudflare/cloudflare-os.git
cd cloudflare-os
pnpm run-local

Open daarna http://localhost:8787 in je browser.

Dit draait de volledige stack lokaal via wrangler (de ontwikkeltool van Cloudflare) bovenop workerd. Je gegevens komen in de submap .wrangler. Let op: dit is bedoeld om het te proberen, niet om productie op te draaien.

Optie 2: in je eigen Cloudflare-account

De eenvoudigste route is het online uitrolproces van Cloudflare:

os.cloudflare.app/deploy

Wil je meer controle, bijvoorbeeld eigen gatekeepers of aanpassingen aan de code, gebruik dan de starter-repository als basis:

github.com/cloudflare/cloudflare-os-starter

Draaien op je eigen server met alleen workerd, zonder Cloudflare, kan in principe ook, maar de documentatie en tooling daarvoor zijn nog "coming soon".

De eerste stappen in de omgeving

"Maak slides voor mijn komende afspraak met een klant." Dit gebruikt de ingebouwde blueprint voor presentaties.
"Maak een gezamenlijke whiteboard-app." De agent bouwt dan een nieuwe app vanaf nul.
"Maak een boter-kaas-en-eieren-spel", gevolgd door "Ik ben X, jij bent O. Ik heb mijn eerste zet gedaan, jij bent."

Elke app die zo ontstaat, is een gadget: privé en afgeschermd, maar deelbaar met anderen, net als een document in een online kantoorpakket.

Externe diensten koppelen (gatekeepers)

Gadgets en de agent hebben standaard nergens toegang toe, ook niet tot het internet. Toegang tot bijvoorbeeld GitHub of Google loopt via een gatekeeper: een apart onderdeel dat de verbinding bewaakt, alles logt en acties met gevolgen eerst aan jou voorlegt.

Voor de meeste gatekeepers moet je eenmalig OAuth-gegevens aanmaken bij de dienst zelf. Elke gatekeeper heeft een eigen handleiding in de repository (packages/gatekeeper-*/README.md). Beschikbaar zijn onder meer:

GitHub, Google, Cloudflare en Supabase.
Notion, Confluence en Slack.
Email Workers, Home Assistant, Spotify en ZoomInfo.

Begin met één dienst die je echt nodig hebt. Het aanmaken van OAuth-apps is bij sommige providers bewerkelijk.

Controleren of het werkt

De webinterface laadt op localhost:8787 (lokaal) of op je eigen domein (in de cloud).
Een eenvoudige opdracht zoals het boter-kaas-en-eieren-spel levert een werkende gadget op.
Na het koppelen van een gatekeeper kun je die dienst aan een chat of gadget "voorstellen" (bijvoorbeeld door een link naar een GitHub-repository te plakken), en de agent kan er dan mee werken.

Bijwerken

Lokaal haal je de nieuwste code op en start je opnieuw:

git pull
pnpm run-local

Bij een installatie via de starter-repository werk je die bij volgens de instructies daar. Omdat het project volop in ontwikkeling is, kunnen updates flink wat veranderen. Maak daarom eerst een kopie van de map .wrangler als je lokale gegevens wilt bewaren.