Fix clw-llm-unreachable: OpenClaw LLM service unreachable connection error

Sat, 18 Apr 2026 11:19:13 +0800

1. Symptoms

The clw-llm-unreachable error in OpenClaw manifests when the client cannot establish a connection to the configured Large Language Model (LLM) service endpoint. This blocks all inference requests, CLI commands, or API calls relying on the LLM backend.

Typical error output from `clw` CLI:

$ clw infer –prompt “Hello world” clw-llm-unreachable: Failed to reach LLM service at https://llm.example.com:443/v1. Connection refused (error code: ECONNREFUSED). Retries exhausted after 3 attempts.


In application logs (e.g., from a Python integration):

ERROR:clw.client: LLM endpoint unreachable: https://localhost:8080/v1/models Traceback (most recent call last): File “/usr/local/lib/python3.11/site-packages/openclaw/client.py”, line 245, in _connect raise LLMUnreachableError(f"Failed to reach LLM at {self.endpoint}") clw-llm-unreachable: Connection timeout after 30s

Proxy on ErrorVault — Developer Error Code Dictionary

Fix clw-llm-unreachable: OpenClaw LLM service unreachable connection error

1. Symptoms

Typical error output from clw CLI:

Typical error output from `clw` CLI: