Install →
Extension

Settings

Configure Constclaw from the extension's side panel. Click the ⚙️ icon in the top-right corner to open the settings view.

Extension settings

All settings are stored in chrome.storage.local and persist across browser restarts. Changes take effect immediately — no restart required.

Setting
Default
Description
Gateway URL
ws://127.0.0.1:18789
WebSocket endpoint for the OpenClaw gateway. Change this if you configured a custom port or are connecting to a remote machine.
Gateway Token
(empty)
Optional authentication token. Required only if the gateway has OPENCLAW_GATEWAY_TOKEN set. Leave blank for local-only setups.
Response Language
English
The language used for AI responses. This value is injected into the system prompt as Respond in {language}. Supports any language the underlying model understands.
Analysis Mode
Explain & Define
The default analysis mode selected when the side panel opens. Can be changed per-query from the mode dropdown. See Analysis Modes.

Gateway configuration

The OpenClaw gateway has its own config file at ~/.openclaw/openclaw.json. These settings affect the gateway, not the extension directly.

~/.openclaw/openclaw.json (example)json
{
  "gateway": {
    "host": "127.0.0.1",
    "port": 18789,
    "token": ""
  },
  "provider": {
    "name": "anthropic",
    "model": "claude-opus-4-6",
    "apiKey": "sk-ant-..."
  },
  "limits": {
    "maxTokens": 4096,
    "timeout": 30000
  }
}
gateway.host

Bind address. Use 127.0.0.1 for local-only or 0.0.0.0 to allow LAN connections (not recommended without a token).

gateway.port

WebSocket port. Default is 18789. If changed, update the Gateway URL in the extension settings to match.

gateway.token

Authentication token. When set, all connecting clients must provide this token in the auth.token field during the handshake.

provider.name

AI provider: anthropic, openai, or ollama for local models. Set during openclaw onboard.

provider.model

Model ID. Examples: claude-opus-4-6, gpt-4o, llama3.1.

limits.maxTokens

Maximum tokens in the AI response. Higher values allow longer responses but increase cost and latency.

Environment variables

The gateway also reads these environment variables, which override values in openclaw.json:

Variable
Overrides
Description
OPENCLAW_GATEWAY_TOKEN
gateway.token
Gateway auth token. Preferred over config file for security.
ANTHROPIC_API_KEY
provider.apiKey
Anthropic API key. Used when provider is anthropic.
OPENAI_API_KEY
provider.apiKey
OpenAI API key. Used when provider is openai.
OPENCLAW_PORT
gateway.port
Custom port for the WebSocket gateway.

Resetting settings

To reset extension settings to defaults, click the Reset button at the bottom of the settings panel. To reset the gateway config:

bash
"c"># Re-run the onboarding wizard
"kw">openclaw onboard

"c"># Or manually reset the config
rm ~/."kw">openclaw/"kw">openclaw.json
"kw">openclaw onboard --install-daemon
← WebSocket API Analysis Modes →