Getting Started
Goal: go from zero to a first working chat with minimal setup.Fastest chat: no channel setup needed. Turn on the web client
(
gateway.webClient.enabled: true) and chat in the browser at http://127.0.0.1:18789/v2/client/.
Run wednesdayai dashboard (or open http://127.0.0.1:18789/ on the
)
to open Control UI v2, the operator console at the gateway root.
Docs: Dashboard, Control UI v2, and Web client.Prereqs
- Node 24 or newer
Quick setup (CLI)
1
Install WednesdayAI (recommended)
- macOS/Linux
- Windows (PowerShell)
Other install methods and requirements: Install.
2
Run the onboarding wizard
3
Check the Gateway
If you installed the service, it should already be running:
4
Open the Control UI
If the Control UI loads, your Gateway is ready for use.
Optional checks and extras
Run the Gateway in the foreground
Run the Gateway in the foreground
Useful for quick tests or troubleshooting.
Send a test message
Send a test message
Requires a configured channel.
Useful environment variables
If you run WednesdayAI as a service account or want custom config/state locations:OPENCLAW_HOMEsets the home directory used for internal path resolution.OPENCLAW_STATE_DIRoverrides the state directory.OPENCLAW_CONFIG_PATHoverrides the config file path.
Go deeper
Onboarding Wizard (details)
Full CLI wizard reference and advanced options.
macOS app onboarding
First run flow for the macOS app.
What you will have
- A running Gateway
- Auth configured
- Control UI access or a connected channel