From 99f7c0abe394b6df08ea371cfa7a5c205657c9a5 Mon Sep 17 00:00:00 2001
From: Sakurapainting <you2899047197@163.com>
Date: Fri, 20 Mar 2026 19:26:29 +0800
Subject: [PATCH] docs: clarify configuration format for `model_list` and
 `providers` in README

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index d9785f200..4afb94b32 100644
--- a/README.md
+++ b/README.md
@@ -261,6 +261,10 @@ picoclaw onboard
 
 **2. Configure** (`~/.picoclaw/config.json`)
 
+> [!IMPORTANT]
+> `model_list` is the recommended and current config format. Launcher UI writes model settings into `model_list`.
+> `providers` is a legacy compatibility section (still supported in some flows).
+
 ```json
 {
   "agents": {