Compare commits

...

6 Commits

Author SHA1 Message Date
Pocket Clawd
c2056b23be docs: add Northflank page to nav + polish copy 2026-01-26 14:56:59 -08:00
Daniel Adeboye
f074611625
Merge branch 'main' into docs/northflank-deploy-guide 2026-01-26 22:50:02 +01:00
adeboyedn
938c315cf5 minor update 2026-01-26 15:41:19 +01:00
adeboyedn
c252de682b cleanup 2026-01-26 15:05:42 +01:00
Daniel Adeboye
9632d81350
Merge branch 'main' into docs/northflank-deploy-guide 2026-01-26 14:47:46 +01:00
adeboyedn
bd6d4f406c docs: add Northflank deployment guide for Clawdbot 2026-01-26 08:07:33 +01:00
2 changed files with 58 additions and 0 deletions

View File

@ -805,6 +805,10 @@
"source": "/install/railway/", "source": "/install/railway/",
"destination": "/railway" "destination": "/railway"
}, },
{
"source": "/install/northflank/",
"destination": "/northflank"
},
{ {
"source": "/gcp", "source": "/gcp",
"destination": "/platforms/gcp" "destination": "/platforms/gcp"
@ -852,6 +856,7 @@
"install/docker", "install/docker",
"railway", "railway",
"render", "render",
"northflank",
"install/bun" "install/bun"
] ]
}, },

53
docs/northflank.mdx Normal file
View File

@ -0,0 +1,53 @@
---
title: Deploy on Northflank
---
Deploy Clawdbot on Northflank with a one-click template and finish setup in your browser.
This is the easiest “no terminal on the server” path: Northflank runs the Gateway for you,
and you configure everything via the `/setup` web wizard.
## How to get started
1. Click [Deploy Clawdbot](https://northflank.com/stacks/deploy-clawdbot) to open the template.
2. Create an [account on Northflank](https://app.northflank.com/signup) if you dont already have one.
3. Click **Deploy Clawdbot now**.
4. Set the required environment variable: `SETUP_PASSWORD`.
5. Click **Deploy stack** to build and run the Clawdbot template.
6. Wait for the deployment to complete, then click **View resources**.
7. Open the Clawdbot service.
8. Open the public Clawdbot URL and complete setup at `/setup`.
9. Open the Control UI at `/clawdbot`.
## What you get
- Hosted Clawdbot Gateway + Control UI
- Web setup wizard at `/setup` (no terminal commands)
- Persistent storage via Northflank Volume (`/data`) so config/credentials/workspace survive redeploys
## Setup flow
1) Visit `https://<your-northflank-domain>/setup` and enter your `SETUP_PASSWORD`.
2) Choose a model/auth provider and paste your key.
3) (Optional) Add Telegram/Discord/Slack tokens.
4) Click **Run setup**.
5) Open the Control UI at `https://<your-northflank-domain>/clawdbot`
If Telegram DMs are set to pairing, the setup wizard can approve the pairing code.
## Getting chat tokens
### Telegram bot token
1) Message `@BotFather` in Telegram
2) Run `/newbot`
3) Copy the token (looks like `123456789:AA...`)
4) Paste it into `/setup`
### Discord bot token
1) Go to https://discord.com/developers/applications
2) **New Application** → choose a name
3) **Bot** → **Add Bot**
4) **Enable MESSAGE CONTENT INTENT** under Bot → Privileged Gateway Intents (required or the bot will crash on startup)
5) Copy the **Bot Token** and paste into `/setup`
6) Invite the bot to your server (OAuth2 URL Generator; scopes: `bot`, `applications.commands`)