diff --git a/docs.json b/docs.json
index 0e3b3c47..570e909e 100644
--- a/docs.json
+++ b/docs.json
@@ -120,7 +120,8 @@
                       "openhands/usage/llms/litellm-proxy",
                       "openhands/usage/llms/moonshot",
                       "openhands/usage/llms/openai-llms",
-                      "openhands/usage/llms/openrouter"
+                      "openhands/usage/llms/openrouter",
+                      "openhands/usage/llms/openzoo"
                     ]
                   }
                 ]
diff --git a/openhands/usage/llms/llms.mdx b/openhands/usage/llms/llms.mdx
index b2270bb4..da8f1cf0 100644
--- a/openhands/usage/llms/llms.mdx
+++ b/openhands/usage/llms/llms.mdx
@@ -107,6 +107,7 @@ We have a few guides for running OpenHands with specific model providers:
 - [OpenAI](/openhands/usage/llms/openai-llms)
 - [OpenHands](/openhands/usage/llms/openhands-llms)
 - [OpenRouter](/openhands/usage/llms/openrouter)
+- [OpenZoo](/openhands/usage/llms/openzoo)
 
 These pages remain the authoritative provider references for both the Agent SDK
 and the OpenHands interfaces.
diff --git a/openhands/usage/llms/openzoo.mdx b/openhands/usage/llms/openzoo.mdx
new file mode 100644
index 00000000..9ed2415d
--- /dev/null
+++ b/openhands/usage/llms/openzoo.mdx
@@ -0,0 +1,36 @@
+---
+title: OpenZoo
+description: How to use OpenZoo models with OpenHands
+---
+
+## Using OpenZoo with OpenHands
+
+[OpenZoo](https://openzoo.fun) is an OpenAI-compatible provider with no
+account. You run a small local proxy (`npx openzoo`) that pays for each
+request over the x402 protocol from a local burner wallet; OpenHands talks to
+the proxy like any other OpenAI-compatible endpoint.
+
+### Setup
+
+1. Start the proxy: `npx openzoo`. It listens on `http://localhost:8402/v1`.
+   `npx openzoo address` prints its wallet — fund it with USDC on Solana or
+   Base; `npx openzoo balance` shows what is left.
+2. In the OpenHands UI Settings under the `LLM` tab, enable `Advanced` options
+   and configure:
+
+| Setting | Value |
+| --- | --- |
+| Custom Model | `openai/<model-id>` (e.g. `openai/auto`) |
+| Base URL | `http://localhost:8402/v1` (from Docker: `http://host.docker.internal:8402/v1`) |
+| API Key | `sk-openzoo` (the proxy ignores the key; any non-empty value) |
+
+Available models are listed (free) at
+`GET http://localhost:8402/v1/models` — ids are bare model names, like
+`claude-sonnet-5` or `gpt-4o-mini`; `auto` lets the proxy pick a model per
+request.
+
+### Hosted endpoint
+
+`https://api.openzoo.fun/v1` answers HTTP 402 unless the caller pays x402 or
+presents an OpenZoo subscription key (`ozk_live_…`). OpenHands cannot pay
+x402 itself, so point it at the local proxy.