From c7af9bce67d7d9c2b7b91b09292b8b6bf1c53556 Mon Sep 17 00:00:00 2001
From: Sakurapainting <you2899047197@163.com>
Date: Fri, 27 Mar 2026 18:38:44 +0800
Subject: [PATCH] docs(channel): clarify channel-only validation scope

---
 cmd/picoclaw/internal/channel/start.go | 2 ++
 docs/configuration.md                  | 2 ++
 docs/zh/configuration.md               | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/cmd/picoclaw/internal/channel/start.go b/cmd/picoclaw/internal/channel/start.go
index c8ddb5420..07f8b4ce2 100644
--- a/cmd/picoclaw/internal/channel/start.go
+++ b/cmd/picoclaw/internal/channel/start.go
@@ -19,6 +19,8 @@ func newStartCommand() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "start",
 		Short: "Start channels without gateway side services",
+		Long: "Start enabled channels and AgentLoop without gateway side services.\n\n" +
+			"This mode is channel-agnostic and follows your config. Current runtime validation is primarily focused on QQ; other channels are continuously validated.",
 		Args:  cobra.NoArgs,
 		PreRunE: func(_ *cobra.Command, _ []string) error {
 			if noTruncate && !debug {
diff --git a/docs/configuration.md b/docs/configuration.md
index ba3e29adc..403441f0c 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -53,6 +53,8 @@ Compared with `picoclaw gateway`, channel-only runtime:
 - Does **not** start Cron service, Heartbeat service, Device service
 - Does **not** enable config hot reload or `/reload`
 
+Validation note: channel-only runtime is channel-agnostic by design. Current runtime validation is primarily focused on QQ, while other channels are continuously validated.
+
 Use `picoclaw gateway` if you need the full control plane and background services.
 
 ### Gateway Log Level
diff --git a/docs/zh/configuration.md b/docs/zh/configuration.md
index 392ae5f74..6a42a843f 100644
--- a/docs/zh/configuration.md
+++ b/docs/zh/configuration.md
@@ -51,6 +51,8 @@ picoclaw channel start --debug
 - **不会** 启动 Cron、Heartbeat、Device 服务
 - **不会** 启用配置热更新和 `/reload`
 
+验证说明：channel 独立运行模式在设计上对各渠道通用。当前运行时验证主要覆盖 QQ，其他渠道仍在持续验证中。
+
 若需要完整控制面与后台服务，请使用 `picoclaw gateway`。
 
 ### Gateway 日志等级