Docs: gateway-first quick start, web + channels as primary interface

- Restructure Quick Start: gateway -> engine choice -> channels -> CLI
- Lead with web dashboard and IM channels as primary interaction
- Position CLI as power user / automation option
- Reorder features: web dashboard and channels first
- Rewrite use cases: web and multi-channel scenarios first
- Add three-mode comparison table (Web + Channels + CLI)

Author: CrazyBoyM

README.md

@@ -46,30 +46,64 @@ cd bashclaw && ./bashclaw doctor
 
 ## Quick Start
 
-### Recommended: Claude Code CLI Engine
+### 1. Start the Gateway
 
-If you have a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) subscription (Pro/Max/Team/Enterprise), BashClaw can use it directly as its backend -- no API keys, no per-token cost:
+```sh
+bashclaw gateway
+```
+
+Open `http://localhost:18789` in your browser. If no API key is configured, a first-run setup overlay guides you through it.
+
+### 2. Choose an Engine
+
+<table>
+<tr><th>Claude Code CLI (Recommended)</th><th>Builtin (Direct API)</th></tr>
+<tr>
+<td>
+
+Reuses your Claude subscription -- no API keys, no per-token cost.
 
 ```sh
-bashclaw config set '.agents.defaults.engine' '"claude"'
+bashclaw config set \
+  '.agents.defaults.engine' '"claude"'
+```
 
-bashclaw agent -m "What is the mass of the sun?"   # one-shot
-bashclaw agent -i                                    # interactive REPL
+Requires: [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated.
+
+</td>
+<td>
+
+Calls LLM APIs directly via curl. Supports 18 providers.
+
+```sh
+export ANTHROPIC_API_KEY="sk-ant-..."
+# or set via web dashboard
 ```
 
-This delegates all reasoning and tool execution to the `claude` CLI, reusing your existing subscription.
+</td>
+</tr>
+</table>
 
-### Alternative: Builtin Engine with API Keys
+### 3. Connect Channels (Optional)
 
-For other providers or if you prefer direct API access:
+Add always-on messaging through Telegram, Discord, Slack, or Feishu. Channels auto-start with the gateway:
 
 ```sh
-export ANTHROPIC_API_KEY="sk-ant-..."   # or OPENAI_API_KEY, GOOGLE_API_KEY, etc.
+# Example: Telegram
+bashclaw config set '.channels.telegram.botToken' '"BOT_TOKEN"'
+bashclaw config set '.channels.telegram.enabled' 'true'
+bashclaw gateway   # web + Telegram both active
+```
+
+See [Channels](#channels) for all platforms.
+
+### 4. CLI Mode (Power Users)
+
+For scripting, automation, or SSH sessions:
 
+```sh
 bashclaw agent -m "What is the mass of the sun?"   # one-shot
 bashclaw agent -i                                    # interactive REPL
-bashclaw onboard                                     # guided setup wizard
-bashclaw gateway                                     # web dashboard + channels
 ```
 
 ## Why BashClaw
@@ -106,12 +140,11 @@ BashClaw targets Bash 3.2 deliberately: no `declare -A`, no `mapfile`, no `|&`.
 
 ## Features
 
-- **Pure shell** -- Zero dependencies beyond bash 3.2, curl, jq. Already on your machine.
-- **Self-modifying** -- Agent hot-patches its own source at runtime. No compilation step.
+- **Web dashboard** -- Built-in browser UI for chat, config, and monitoring. First-run setup wizard. No external tools.
+- **Multi-channel** -- Telegram, Discord, Slack, Feishu/Lark. Each channel is one shell script. Auto-starts with gateway.
 - **Dual engine** -- Claude Code CLI (reuses subscription) or builtin (direct API via curl). Per-agent configurable.
 - **Multi-provider** -- 18 providers: Claude, GPT, Gemini, DeepSeek, Qwen, Zhipu, Moonshot, MiniMax, Groq, xAI, Mistral, Ollama, vLLM, and more.
-- **Multi-channel** -- Telegram, Discord, Slack, Feishu/Lark. Each channel is one shell script.
-- **Web dashboard** -- Built-in browser UI for chat, config, and monitoring. No external tools.
+- **Pure shell** -- Zero dependencies beyond bash 3.2, curl, jq. Already on your machine.
 - **14 built-in tools** -- Web fetch, search, shell exec, memory, cron, file I/O, inter-agent messaging.
 - **Plugin system** -- 4 discovery paths. Register tools, hooks, commands, providers.
 - **8-layer security** -- SSRF protection, command filters, pairing codes, rate limiting, RBAC, audit.
@@ -153,14 +186,15 @@ bashclaw gateway
 **Logs** -- Live log viewer with level filtering.
 **First-run** -- If no API key is set, shows a setup overlay on first visit.
 
-### Web + CLI Dual Mode
+### Web + Channels + CLI
 
-Both modes share the same config, sessions, and state. Changes in the dashboard take effect in CLI immediately, and vice versa.
+All three modes share the same config, sessions, and state. Changes in one take effect in the others immediately.
 
 | Mode | Best For | Command |
 |------|----------|---------|
-| Web | First-time setup, visual config, casual chat | `bashclaw gateway` |
-| CLI | Automation, scripting, SSH, power users | `bashclaw agent -i` |
+| Web | First-time setup, visual config, casual chat | `bashclaw gateway` then open browser |
+| Channels | Always-on team bot, mobile access | `bashclaw gateway` with channels enabled |
+| CLI | Automation, scripting, SSH, CI/CD | `bashclaw agent -m "..."` or `bashclaw agent -i` |
 
 ### REST API
 
@@ -780,19 +814,29 @@ Config file: `~/.bashclaw/bashclaw.json`
 
 ## Use Cases
 
-**Personal assistant on a Mac**
+**Web dashboard on a Mac**
 ```sh
-export ANTHROPIC_API_KEY="sk-ant-..."
-bashclaw agent -i
-# No Python, no Node, no Docker. Just works.
+bashclaw gateway
+# Open http://localhost:18789 -- first-run wizard configures API keys
+# Chat with the agent in your browser immediately
+```
+
+**Multi-channel team bot**
+```sh
+# One agent, multiple channels -- all served by a single gateway
+bashclaw config set '.channels.telegram.enabled' 'true'
+bashclaw config set '.channels.discord.enabled' 'true'
+bashclaw config set '.channels.slack.enabled' 'true'
+bashclaw gateway
+# Messages from all platforms routed to the same agent
 ```
 
-**Headless server agent**
+**Always-on server agent**
 ```sh
 # Install on a fresh Ubuntu server
 curl -fsSL .../install.sh | bash
 bashclaw daemon install --enable
-# Agent runs 24/7, accessible via Telegram or web dashboard
+# Agent runs 24/7, accessible via Telegram, Discord, Slack, or web dashboard
 ```
 
 **CI/CD pipeline agent**
@@ -801,14 +845,10 @@ bashclaw daemon install --enable
 bashclaw agent -m "Review this diff and suggest improvements" < diff.patch
 ```
 
-**Multi-channel team bot**
+**SSH / headless CLI**
 ```sh
-# One agent, multiple channels
-bashclaw config set '.channels.telegram.enabled' 'true'
-bashclaw config set '.channels.discord.enabled' 'true'
-bashclaw config set '.channels.slack.enabled' 'true'
-bashclaw gateway
-# Messages from all platforms routed to the same agent
+bashclaw agent -i
+# Interactive REPL for power users. No browser needed.
 ```
 
 ## Testing

README_CN.md

@@ -46,30 +46,64 @@ cd bashclaw && ./bashclaw doctor
 
 ## 快速开始
 
-### 推荐: Claude Code CLI 引擎
+### 1. 启动 Gateway
 
-如果你有 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 订阅 (Pro/Max/Team/Enterprise),BashClaw 可以直接使用它作为后端 -- 无需 API 密钥,无按量付费:
+```sh
+bashclaw gateway
+```
+
+在浏览器中打开 `http://localhost:18789`。如果尚未配置 API 密钥,首次访问会显示引导式配置界面。
+
+### 2. 选择引擎
+
+<table>
+<tr><th>Claude Code CLI (推荐)</th><th>Builtin (直接调用 API)</th></tr>
+<tr>
+<td>
+
+复用你的 Claude 订阅 -- 无需 API 密钥,无按量付费。
 
 ```sh
-bashclaw config set '.agents.defaults.engine' '"claude"'
+bashclaw config set \
+  '.agents.defaults.engine' '"claude"'
+```
 
-bashclaw agent -m "太阳的质量是多少?"    # 单次问答
-bashclaw agent -i                        # 交互式 REPL
+前置要求: 已安装 [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) 并完成认证。
+
+</td>
+<td>
+
+通过 curl 直接调用 LLM API。支持 18 个提供者。
+
+```sh
+export ANTHROPIC_API_KEY="sk-ant-..."
+# 或通过 Web 控制台设置
 ```
 
-这会将所有推理和工具执行委托给 `claude` CLI,复用你现有的订阅额度。
+</td>
+</tr>
+</table>
 
-### 备选: Builtin 引擎 + API 密钥
+### 3. 接入消息频道 (可选)
 
-使用其他提供者或偏好直接 API 访问时:
+通过 Telegram、Discord、Slack 或飞书接入始终在线的消息服务。频道随 Gateway 自动启动:
 
 ```sh
-export ANTHROPIC_API_KEY="sk-ant-..."   # 或 OPENAI_API_KEY, GOOGLE_API_KEY 等
+# 示例: Telegram
+bashclaw config set '.channels.telegram.botToken' '"BOT_TOKEN"'
+bashclaw config set '.channels.telegram.enabled' 'true'
+bashclaw gateway   # Web 控制台 + Telegram 同时运行
+```
+
+详见[消息频道](#消息频道)章节。
+
+### 4. CLI 模式 (高级用户)
+
+用于脚本、自动化或 SSH 会话:
 
+```sh
 bashclaw agent -m "太阳的质量是多少?"    # 单次问答
 bashclaw agent -i                        # 交互式 REPL
-bashclaw onboard                         # 引导式安装向导
-bashclaw gateway                         # Web 控制台 + 频道
 ```
 
 ## 为什么选 BashClaw
@@ -106,12 +140,11 @@ BashClaw 刻意以 Bash 3.2 为目标: 不用 `declare -A`、不用 `mapfile`、
 
 ## 特性
 
-- **纯 Shell** -- 仅依赖 bash 3.2, curl, jq。你的机器上已经有了。
-- **自修改** -- 智能体在运行时热修改自身源代码。无编译步骤。
+- **Web 控制台** -- 内置浏览器界面,用于聊天、配置和监控。首次引导向导。无需外部工具。
+- **多频道** -- Telegram, Discord, Slack, 飞书/Lark。每个频道是一个 Shell 脚本。随 Gateway 自动启动。
 - **双引擎** -- Claude Code CLI (复用订阅) 或 builtin (curl 直接调用 API)。按智能体独立配置。
 - **多提供者** -- 18 个提供者: Claude, GPT, Gemini, DeepSeek, 通义千问, 智谱, Moonshot, MiniMax, Groq, xAI, Mistral, Ollama, vLLM 等。
-- **多频道** -- Telegram, Discord, Slack, 飞书/Lark。每个频道是一个 Shell 脚本。
-- **Web 控制台** -- 内置浏览器界面,用于聊天、配置和监控。无需外部工具。
+- **纯 Shell** -- 仅依赖 bash 3.2, curl, jq。你的机器上已经有了。
 - **14 个内置工具** -- Web 抓取、搜索、Shell 执行、记忆、定时任务、文件 I/O、智能体间通信。
 - **插件系统** -- 4 个发现路径。可注册工具、钩子、命令、提供者。
 - **8 层安全模型** -- SSRF 防护、命令过滤、配对码、限流、RBAC、审计。
@@ -150,14 +183,15 @@ bashclaw gateway
 **状态** -- 网关状态、活跃会话、提供者信息。
 **首次引导** -- 如果没有配置 API 密钥,首次访问会显示配置引导。
 
-### Web + CLI 双模式
+### Web + 频道 + CLI
 
-两种模式共享相同的配置、会话和状态。控制台中的更改立即在 CLI 中生效,反之亦然。
+三种模式共享相同的配置、会话和状态。任一模式中的更改立即在其他模式中生效。
 
 | 模式 | 适用场景 | 命令 |
 |------|----------|------|
-| Web | 首次配置、可视化管理、日常聊天 | `bashclaw gateway` |
-| CLI | 自动化、脚本、SSH 会话、高级用户 | `bashclaw agent -i` |
+| Web | 首次配置、可视化管理、日常聊天 | `bashclaw gateway` 然后打开浏览器 |
+| 频道 | 始终在线的团队机器人、移动端访问 | `bashclaw gateway` 并启用频道 |
+| CLI | 自动化、脚本、SSH、CI/CD | `bashclaw agent -m "..."` 或 `bashclaw agent -i` |
 
 ### REST API
 
@@ -779,19 +813,29 @@ plugin_register_provider "my_llm" "My LLM" '["model-a"]' '{"envKey":"MY_KEY"}'
 
 ## 使用场景
 
-**Mac 上的个人助手**
+**Mac 上的 Web 控制台**
 ```sh
-export ANTHROPIC_API_KEY="sk-ant-..."
-bashclaw agent -i
-# 不需要 Python、Node、Docker。直接运行。
+bashclaw gateway
+# 打开 http://localhost:18789 -- 首次引导向导配置 API 密钥
+# 在浏览器中直接与智能体对话
+```
+
+**多频道团队机器人**
+```sh
+# 一个智能体,多个频道 -- 由同一个 Gateway 提供服务
+bashclaw config set '.channels.telegram.enabled' 'true'
+bashclaw config set '.channels.discord.enabled' 'true'
+bashclaw config set '.channels.slack.enabled' 'true'
+bashclaw gateway
+# 所有平台的消息路由到同一个智能体
 ```
 
-**无头服务器智能体**
+**始终在线的服务器智能体**
 ```sh
 # 在全新 Ubuntu 服务器上安装
 curl -fsSL .../install.sh | bash
 bashclaw daemon install --enable
-# 智能体 7x24 运行,通过 Telegram 或 Web 控制台访问
+# 智能体 7x24 运行,通过 Telegram、Discord、Slack 或 Web 控制台访问
 ```
 
 **CI/CD 流水线智能体**
@@ -800,14 +844,10 @@ bashclaw daemon install --enable
 bashclaw agent -m "审查这个 diff 并提出改进建议" < diff.patch
 ```
 
-**多频道团队机器人**
+**SSH / 无头 CLI**
 ```sh
-# 一个智能体,多个频道
-bashclaw config set '.channels.telegram.enabled' 'true'
-bashclaw config set '.channels.discord.enabled' 'true'
-bashclaw config set '.channels.slack.enabled' 'true'
-bashclaw gateway
-# 所有平台的消息路由到同一个智能体
+bashclaw agent -i
+# 高级用户的交互式 REPL。无需浏览器。
 ```
 
 ## 测试