Hands-On Lab

Deploy Your Moltworker AI Agent

Follow the steps below to deploy a fully functional AI personal assistant on Cloudflare.

Your Progress 0 / 7 steps completed

Before we begin, let's confirm you have access to the workshop Cloudflare account.

Open the Cloudflare Dashboard and log in with the email you registered with.
Check the invitation email from Cloudflare — accept the invite to join the workshop account.
Once logged in, verify you can see the workshop account in the account selector (top-left).
Navigate to Workers & Pages — you should see the Workers Paid plan is active.

Trouble? If you don't see the invitation, check your spam folder. Ask a workshop helper if you're stuck.

I can access the workshop Cloudflare account

Install the required tools on your machine.

1. Check Node.js

You need Node.js 18 or higher:

node --version
# Should output v18.x.x or higher

If not installed, download from nodejs.org (LTS recommended).

2. Install Wrangler CLI

npm install -g wrangler

3. Login to Cloudflare

wrangler login
# This will open a browser window — authorize the CLI

Verify it works:

wrangler whoami
# Should show your email and the workshop account

Node.js, Wrangler, and login are all set

Clone the workshop edition of Moltworker and install dependencies:

git clone https://github.com/lllxpr/moltworker-workshop.git
cd moltworker-workshop
npm install
# postinstall will automatically clone the official moltworker source

Note: If you don't have Git installed, you can download the repo as a ZIP from the GitHub page. The npm install step will automatically fetch the official Moltworker source code.

Repository cloned and dependencies installed

Run the deploy wizard — it will guide you through all the configuration steps automatically:

npm run wizard

Before you start: The wizard will ask for a Cloudflare API Token to create resources automatically. Create one at dash.cloudflare.com/profile/api-tokens using the "Edit Cloudflare Workers" template, and add permissions for AI Gateway and R2.

The wizard will guide you through 10 steps:

Verify environment — checks Node.js, Wrangler, CF login
Detect your Account — auto-detects from wrangler whoami
API Token — for automating resource creation
Create AI Gateway — via Cloudflare API
Generate AI Gateway auth token — for Unified Billing (no external API keys!)
Select AI model — defaults to Kimi K2.5
Generate Gateway Token — for Control UI access
Set up R2 storage — create bucket + API credentials
Set all secrets — automatically via Wrangler
Deploy — your agent goes live!

Important: Save the Gateway Token displayed in step 7 — you'll need it to access the Control UI. The wizard also saves all config to .workshop-config.json.

If you prefer manual configuration, set secrets individually:

# Manual alternative — the wizard does all this for you
npx wrangler secret put CLOUDFLARE_AI_GATEWAY_API_KEY
npx wrangler secret put CF_AI_GATEWAY_ACCOUNT_ID
npx wrangler secret put CF_AI_GATEWAY_GATEWAY_ID
npx wrangler secret put CF_AI_GATEWAY_MODEL
# Enter: workers-ai/@cf/moonshotai/kimi-k2.5
export TOKEN=$(openssl rand -hex 32)
echo "$TOKEN" | npx wrangler secret put MOLTBOT_GATEWAY_TOKEN
npm run deploy

Wizard completed and worker deployed

1. Open the Control UI

Open this URL in your browser (replace with your worker subdomain and token):

https://<your-worker>.workers.dev/?token=<YOUR_GATEWAY_TOKEN>

First load: The container may take 1-2 minutes to start. Be patient!

2. Open the Admin UI

Navigate to the admin panel to pair your device:

https://<your-worker>.workers.dev/_admin/

3. Pair Your Device

Log in via Cloudflare Access (use your workshop email).
In the Admin UI, click "Pair Device".
Approve the pairing request.

4. Send Your First Message

Go back to the Control UI and type a message — your AI agent is alive!

Device paired and first message sent

Auto-Sleep Configuration

To save costs, configure the container to sleep after being idle:

# In wrangler.toml, set SANDBOX_SLEEP_AFTER to auto-sleep after 10 minutes idle
# This reduces monthly cost from ~$35 to ~$5-6 if used a few hours/day

View Your Usage

AI Gateway — Dashboard → AI → AI Gateway → your gateway → Analytics
Workers — Dashboard → Workers & Pages → your worker → Analytics
R2 — Dashboard → R2 → your bucket → Metrics

Post-Workshop Cleanup

If you want to remove your deployment after the workshop:

npx wrangler delete

Reviewed cost controls

Troubleshooting

Container takes too long to start

The first start can take 1-2 minutes as the container image is pulled. Subsequent starts are faster. If it takes more than 3 minutes, try refreshing.

"Unauthorized" error on Control UI

Make sure you're using the correct gateway token in the URL. If you lost it, you can regenerate: echo $(openssl rand -hex 32) | npx wrangler secret put MOLTBOT_GATEWAY_TOKEN

AI model not responding

Check your AI Gateway configuration in the Cloudflare Dashboard. Ensure the gateway is active and Unified Billing has credits. Also verify CF_AI_GATEWAY_MODEL is set to workers-ai/@cf/moonshotai/kimi-k2.5.

wrangler login fails

Try running wrangler login --browser or clear existing credentials with wrangler logout first. On corporate networks, you may need to configure proxy settings.

Deploy Your Moltworker AI Agent

Verify Your Access

Environment Setup

1. Check Node.js

2. Install Wrangler CLI

3. Login to Cloudflare

Clone & Install

Configure & Deploy with Wizard

Access & Pair Your Device