packages/kilo-docs/pages/kiloclaw/end-to-end.md
This guide walks you through a full KiloClaw setup — from creating accounts to scheduling your first automated workflow. Plan for about 60 minutes.
For most users, a useful KiloClaw configuration involves:
We recommend creating separate accounts for your KiloClaw rather than connecting it to your personal accounts. This applies to Google, GitHub, and any other services you connect. A dedicated account improves isolation — your personal data stays separate, and you can control exactly what access the Claw has by sharing or delegating only what you want.
{% callout type="warning" title="Chain-of-connection security" %} If your Claw has access to sensitive data (like your email), be careful which chat platform you connect it to. On broadly-accessible platforms like Slack or Discord, anyone on the server could potentially message your Claw and access that data. If you're connecting sensitive integrations, use a private platform like Kilo Chat or Telegram. {% /callout %}
The steps below walk you through this configuration.
Take these steps before configuring your Claw.
If you are doing a 1-1 configuration call with Kilo, please complete these steps before the call.
Configuring Google services is by far the most involved part of setting up your Claw.
Before configuring, take these preflight steps:
[email protected] works well.{% callout type="tip" title="Google Workspace users" %}
If your organization uses Google Workspace, create the dedicated bot account inside your Workspace domain (e.g., [email protected]) rather than as a standalone @gmail.com account.
A Workspace-managed account benefits from your organization's admin policies, making configuration easier. {% /callout %}
Set up Google Cloud — Visit console.cloud.google.com. Accept the terms of service and click "Start my free tier". You may need to add a credit card for identity verification.
{% callout type="info" %} Nothing KiloClaw does costs any money with Google. {% /callout %}
Install Docker — KiloClaw configures Google by running a Docker container on your machine. Download Docker at docker.com, then open it. You don't need to sign in or create a Docker account.
Your Claw needs a way to communicate with you. Kilo Chat requires no setup — just open the web app. For other platforms, follow the relevant guide:
{% callout type="tip" %} If you're not sure which to pick, Kilo Chat (no setup) or Telegram (2 minutes) are the easiest options. {% /callout %}
This lets your Claw act as the bot Google account — sending email, reading calendar, and more. Takes about 15 minutes.
Prerequisites: Docker is installed and running, and your bot Google account is already created.
For full details, see the Google setup guide.
A dedicated bot GitHub account is strongly recommended. Takes about 7 minutes.
Create a Personal Access Token (PAT):
repo, workflow, write:org, read:user.For full details, see the GitHub setup guide.
Set up a private workspace repo:
Once GitHub is connected, ask your Claw to back up its workspace:
Use your GitHub access to back up your workspace. Make it a GitHub repo and push it as a private repo. Add me as a member so I can see it. Then set up a cron job to pull, rebase, and push any changes at least once an hour.
After sending that, redeploy from the dashboard to pick up the changes.
After OAuth is set up, decide how much access to give your Claw to your personal accounts.
| Option | What it does | Best for | Configured from |
|---|---|---|---|
| Forward select emails | A Gmail filter forwards specific senders or labels to the bot account | Targeted use cases like newsletter digests | Your personal account |
| Forward all email | Forwards your full inbox to the bot | Simpler setups where noise is acceptable | Bot account (destination) |
| Full account delegation | Gives the bot direct read/write access to your personal account | Maximum capability | Your personal account — Gmail Settings → Add a delegate |
{% callout type="info" %} Email forwarding is configured from the destination (bot) account. Account delegation is configured from the source (personal) account. {% /callout %}
Push notifications: by default, your Claw wakes up on every incoming email. If you'd prefer a digest (e.g., once at 7am), disable push notifications in Settings → Google Account on the dashboard — otherwise it processes each email as it arrives.
Google Calendar: share your personal calendar from your personal Google account. Go to Google Calendar → Settings → Settings for my calendars → [your calendar] → Share with specific people, and add the bot account.
By default, KiloClaw asks for confirmation before every tool call. To let it act freely, go to the KiloClaw dashboard and enable auto-approval in the Default Permissions section.
Just tell it in plain language what you want. Be specific. If you want it to remember something across sessions, tell it to write it down in a specific file.
Tell your Claw when and what to do — for example:
Schedule a daily cron job at 7am to summarize my emails and send me a digest.
{% callout type="tip" %} Mentioning "cron job" helps it understand you want a recurring scheduled task. {% /callout %}
Reusable capabilities that extend what your Claw can do — things like triaging email, summarizing documents, or managing GitHub issues. You can install a pre-built skill by asking your Claw:
Install the [skill name] skill.
Or ask your Claw to build a custom skill from scratch — it has a built-in skill-builder skill for exactly this. You can explore popular skills and use case inspiration at the KiloClaw Bytes library.
Model picker: Balanced is a good starting point. Frontier is more capable but significantly more expensive.
You can also use your KiloPass credits — find this under Profile in the dashboard.