mirror of
https://github.com/openclaw/openclaw.git
synced 2026-02-09 05:19:32 +08:00
929a3725d3
* docs(navigation): canonicalize paths and align zh nav * chore(docs): remove stray .DS_Store * docs(scripts): add non-mint docs link audit * docs(nav): fix zh source paths and preserve legacy redirects (#11428) (thanks @sebslight) * chore(docs): satisfy lint for docs link audit script (#11428) (thanks @sebslight)
121 lines
2.7 KiB
Markdown
121 lines
2.7 KiB
Markdown
---
|
|
summary: "Get OpenClaw installed and run your first chat in minutes."
|
|
read_when:
|
|
- First time setup from zero
|
|
- You want the fastest path to a working chat
|
|
title: "Getting Started"
|
|
---
|
|
|
|
# Getting Started
|
|
|
|
Goal: go from zero to a first working chat with minimal setup.
|
|
|
|
<Info>
|
|
Fastest chat: open the Control UI (no channel setup needed). Run `openclaw dashboard`
|
|
and chat in the browser, or open `http://127.0.0.1:18789/` on the
|
|
<Tooltip headline="Gateway host" tip="The machine running the OpenClaw gateway service.">gateway host</Tooltip>.
|
|
Docs: [Dashboard](/web/dashboard) and [Control UI](/web/control-ui).
|
|
</Info>
|
|
|
|
## Prereqs
|
|
|
|
- Node 22 or newer
|
|
|
|
<Tip>
|
|
Check your Node version with `node --version` if you are unsure.
|
|
</Tip>
|
|
|
|
## Quick setup (CLI)
|
|
|
|
<Steps>
|
|
<Step title="Install OpenClaw (recommended)">
|
|
<Tabs>
|
|
<Tab title="macOS/Linux">
|
|
```bash
|
|
curl -fsSL https://openclaw.ai/install.sh | bash
|
|
```
|
|
</Tab>
|
|
<Tab title="Windows (PowerShell)">
|
|
```powershell
|
|
iwr -useb https://openclaw.ai/install.ps1 | iex
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
<Note>
|
|
Other install methods and requirements: [Install](/install).
|
|
</Note>
|
|
|
|
</Step>
|
|
<Step title="Run the onboarding wizard">
|
|
```bash
|
|
openclaw onboard --install-daemon
|
|
```
|
|
|
|
The wizard configures auth, gateway settings, and optional channels.
|
|
See [Onboarding Wizard](/start/wizard) for details.
|
|
|
|
</Step>
|
|
<Step title="Check the Gateway">
|
|
If you installed the service, it should already be running:
|
|
|
|
```bash
|
|
openclaw gateway status
|
|
```
|
|
|
|
</Step>
|
|
<Step title="Open the Control UI">
|
|
```bash
|
|
openclaw dashboard
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
<Check>
|
|
If the Control UI loads, your Gateway is ready for use.
|
|
</Check>
|
|
|
|
## Optional checks and extras
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Run the Gateway in the foreground">
|
|
Useful for quick tests or troubleshooting.
|
|
|
|
```bash
|
|
openclaw gateway --port 18789
|
|
```
|
|
|
|
</Accordion>
|
|
<Accordion title="Send a test message">
|
|
Requires a configured channel.
|
|
|
|
```bash
|
|
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
|
|
```
|
|
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Go deeper
|
|
|
|
<Columns>
|
|
<Card title="Onboarding Wizard (details)" href="/start/wizard">
|
|
Full CLI wizard reference and advanced options.
|
|
</Card>
|
|
<Card title="macOS app onboarding" href="/start/onboarding">
|
|
First run flow for the macOS app.
|
|
</Card>
|
|
</Columns>
|
|
|
|
## What you will have
|
|
|
|
- A running Gateway
|
|
- Auth configured
|
|
- Control UI access or a connected channel
|
|
|
|
## Next steps
|
|
|
|
- DM safety and approvals: [Pairing](/channels/pairing)
|
|
- Connect more channels: [Channels](/channels)
|
|
- Advanced workflows and from source: [Setup](/start/setup)
|