# OpenClaw

The SimpleLLM OpenClaw setup writes provider configuration, model metadata, and an API-key environment file. The setup package requires Node.js 20 or newer.

## Interactive setup

~~~bash
npx @simplellm/openclaw-provider
~~~

The wizard fetches the model catalogue, asks for your key, and configures the provider.

| Default file | Purpose |
| --- | --- |
| `~/.openclaw/openclaw.json` | Provider and model configuration |
| `~/.openclaw/.env` | SIMPLELLM_API_KEY |

The setup merges configuration rather than replacing the entire file. Back up custom configuration before changing it, and keep the environment file private.

## Start OpenClaw

~~~bash
openclaw
~~~

The setup package's documented default is `simplellm/Qwen3-Coder-30B-A3B-Instruct`. Check your generated configuration and current catalogue rather than assuming the default model will always remain available.

## Environment-based setup

Provide the key through an environment variable instead of placing it in a command-line argument:

~~~bash
export SIMPLELLM_API_KEY='YOUR_API_KEY'
npx @simplellm/openclaw-provider
~~~

Command-line secrets can appear in shell history or process listings. Use your environment or secret tooling for automated setup.

## Configuration variables

| Variable | Default / meaning |
| --- | --- |
| `SIMPLELLM_API_KEY` | Supply the key non-interactively |
| `SIMPLELLM_BASE_URL` | https://api.simplellm.eu, without /v1 |
| `OPENCLAW_STATE_DIR` | ~/.openclaw; controls configuration and environment-file location |

## Refresh and diagnose

Re-run the wizard to pick up model changes. If you use a custom state directory, confirm that OpenClaw and the setup command use the same one.

Check key validity, selected model, and account credits when setup succeeds but inference fails. See [Troubleshooting](/docs/errors.html) for HTTP errors and the [provider README](https://github.com/SimpleLLM/openclaw-provider) for package details.

Protect both configuration files and avoid sharing a diagnostic archive containing the API key.