Quick Start
In a nutshell: install Client first, then inside it click "Add Claw" to onboard your first execution host. Add an LLM Connection and you can send your first message.
Before you begin
- First-time MyClaws deployment β get the end-to-end flow working quickly.
- Self-hosted or local demo β a reproducible minimal setup.
- Writing a demo guide for a colleague β follow the steps on this page.
Five steps to your first conversation
- Go to the download page and get the Client for your OS (macOS / Windows / Android).
- Launch Client and log in. On first login you will be prompted for the Admin service URL.
- Open Claw Management, click "Add Claw" and follow the guided flow to onboard your first host (recommended).
- In LLM Connection add at least one provider credential (see LLM & Credentials).
- Go to the conversation page, pick an Agent and a Claw, and send your first message. Streaming output means the connection is live.
Install Client and set the Admin URL
- macOS: double-click the
.dmgand drag to Applications. - Windows: double-click the
.exeand follow the installer wizard. - Android: enable "Unknown sources", install the
.apk, or use the app-store channel.
On first launch an Admin URL input box appears:
- It defaults to the official deployment, ready to use.
- Self-hosted users enter their own domain (with
https://). - After logging in, change the default password immediately.
Add your first Claw inside Client
This is the default recommended path for new users β no terminal needed:
- Open Claw Management from the top menu.
- Click the Add Claw button.
- Pick the target platform (macOS / Linux / Windows) and follow the on-screen guide.
- A few seconds later, the new Claw appears in the list as online.
- Rename it so you can identify it later in the conversation page.
If you are a power user, need to onboard many hosts, or want to wire this into automation, see the scripted approach in Claw Deploy.
Configure an LLM Connection
Go to Settings β LLM Connection β Add Provider:
- Anthropic / OpenAI / OpenRouter / Google: enter your API Key.
- Claude Code: choose the "Claude Code" connection type and complete OAuth.
- Codex: use dedicated Codex credentials, or inherit the default LLM.
Configure at least one default model and one fast model (used for auto-generating titles).
Send your first message
- Select the Claw you just installed plus any Agent.
- Send something like
hello, list /tmpin the input area. - You should see streaming output and tool-call blocks β the connection is working.
Small gotchas to know
Use the install method recommended inside Client
The "Add Claw" button generates commands using your actual Admin domain. Copying generic commands from elsewhere often fails because of cross-origin checks.
Claude Code OAuth requires a browser on the local machine
In a headless environment use an API Key connection to avoid OAuth redirect failures.
Self-hosted download fallback
If your custom OSS domain is unreachable, the download page automatically falls back to the native OSS domain or GitHub Release.
Where to go next
- Connect multiple hosts: see the advanced paths in Claw Deploy.
- Understand the platform vocabulary: Core Concepts.
- Let an Agent start work automatically: Trigger.