TOPIC / SETUP

OpenClaw First Config: Four Post-Install Steps

Complete the four essential post-install steps — gateway auth, model provider, a first test, and doctor — before adding any channels or skills to OpenClaw.

Best for

  • Users who finished installation but have not stabilized the baseline yet
  • People configuring auth, model access, and doctor for the first time
  • Anyone preparing to add channels or skills after install

You have not confirmed a path yet

You can keep reading this page, but if you want the shortest next-step recommendation, answering the 3 questions on the homepage will be faster.

Current stage

Stabilize / Lock the baseline

Milestone page

Stabilize auth, model access, channels, and safety boundaries before widening permissions or automation.

Risk level

Medium risk

Last review

Reviewed · 2026-03-21

Prerequisites

2

Install done ≠ usable

Service started is not the milestone. Do these four steps before channels and skills:

  1. Set Gateway authentication
  2. Configure at least one model provider
  3. Run a first test
  4. Run openclaw doctor

1. Gateway auth

openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token your-secure-token-here

Verify:

openclaw config list | grep gateway.auth

You should see gateway.auth.mode = token and a masked token.

2. Model provider

openclaw config set model.provider deepseek
openclaw config set model.api_key sk-your-key-here
openclaw config set model.name deepseek-chat

Or for OpenAI:

openclaw config set model.provider openai
openclaw config set model.api_key sk-***
openclaw config set model.name gpt-4o

3. First test

openclaw run --prompt "Hello"

You should get a model response. If not, check the API key and network.

4. Verify with doctor

openclaw doctor

Ensure all checks pass. For auto-fix of known issues:

openclaw doctor --repair

Checklist

  • gateway.auth.mode set
  • gateway.auth.token (or password) configured
  • At least one model provider with valid API key
  • openclaw run --prompt "Hello" returns a reply
  • openclaw doctor passes

Extra resources

Next step

Keep tightening the baseline

Once the baseline is stable, connect one real channel and validate the message loop.

Open next step

Path progress

Completed 0 / 5 milestones

Seen 0 / 5 key nodes

Prerequisite status

Run the setup path first

Complete this first

Pending

Prerequisites are still pending

This page will count as seen, but formal completion has to wait until the prerequisite steps are satisfied.