From 9d6a445bb175bb3881265c2d68e0685f72ba2786 Mon Sep 17 00:00:00 2001
From: Alix-007 <llagy007@gmail.com>
Date: Thu, 26 Mar 2026 09:32:56 +0800
Subject: [PATCH] docs: clarify gateway.log_level default and options (#2013)
 (#2015)

Co-authored-by: Alix-007 <267018309+Alix-007@users.noreply.github.com>
---
 docs/configuration.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/configuration.md b/docs/configuration.md
index d39806887..9360d3897 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -31,6 +31,22 @@ PICOCLAW_HOME=/opt/picoclaw picoclaw agent
 PICOCLAW_HOME=/srv/picoclaw PICOCLAW_CONFIG=/srv/picoclaw/main.json picoclaw gateway
 ```
 
+### Gateway Log Level
+
+`gateway.log_level` controls Gateway log verbosity and is configurable in `config.json`.
+
+```json
+{
+  "gateway": {
+    "log_level": "fatal"
+  }
+}
+```
+
+When omitted, the default is `fatal`. Supported values: `debug`, `info`, `warn`, `error`, `fatal`.
+
+You can also override this with the environment variable `PICOCLAW_LOG_LEVEL`.
+
 ### Workspace Layout
 
 PicoClaw stores data in your configured workspace (default: `~/.picoclaw/workspace`):