5-minute taste

Run AdkClaw in your browser, right now

No install. No setup. Open Google Cloud Shell, paste a command, see the reference agent run end-to-end. If you like it, then commit to the full 5-level workshop.

1. Open Cloud Shell

Click the button below — Google opens Cloud Shell with this repo pre-cloned.

Requires a Google account. Cloud Shell is free — 50 hours/week.

2. Configure your keys

In the Cloud Shell terminal, run the setup wizard:

cd ~/cloudshell_open/adkclaw
npm install
npm run setup

You'll need a free Gemini API key and a Telegram bot token (both free, both 30 seconds to obtain).

3. Start the daemon

npm run dev

Send /start to your bot on Telegram, copy the numeric ID it replies with, paste into .env as ALLOWED_SENDERS, restart, and chat.

What you'll have in 5 minutes

✓ A working agent on Telegram with a name + personality
✓ Tools: web search, URL fetch, filesystem read/write
✓ Conversation memory in SQLite (survives restarts)
✓ A live dashboard at localhost:3000

Like what you see? Commit to the full 5-level workshop and ship to Cloud Run.