╔══════════════════════════════════════════════════╗
║         NECOCLAW v0.2.0 — Quick Start           ║
║        Self-Evolving AI Agent Platform           ║
╚══════════════════════════════════════════════════╝

【3步快速开始】

  Windows: 双击 start.bat 启动
  macOS/Linux: 终端运行 ./start.sh 启动

  1. 启动 NECOCLAW
  2. 浏览器打开 http://localhost:24088
  3. 开始对话!

───────────────────────────────────────────────────

【系统要求】

  - Windows 10/11 (64位)
  - macOS 10.15+ (Intel 或 Apple Silicon)
  - Linux x86_64 (Ubuntu 20.04+, CentOS 8+, etc.)
  - 内存 4GB+ (推荐 8GB+)
  - 磁盘空间 200MB+

───────────────────────────────────────────────────

【完整安装（可选）】

  Windows: 双击 install.bat
  macOS/Linux: 终端运行 ./install.sh

  安装后:
  - 安装到 ~/.necoclaw/ (或 %USERPROFILE%\.necoclaw\)
  - 自动添加到 PATH
  - 之后在任意终端输入 necoclaw start 即可启动

───────────────────────────────────────────────────

【配置 LLM API】

  NECOCLAW 需要 LLM API 来驱动 AI 对话。

  方式一: 免费获取（推荐新手）
    1. 访问 https://api.necoclaw.ai 注册账号
    2. 获取 API Key（每日 200万 免费 Token + 打卡送 10万）
    3. 在 WebUI 的 LLM Router > 供应商市场 页面点击
       "+ Custom Provider" 添加供应商，填入 Key 和
       Base URL: https://api.necoclaw.ai/v1

  方式二: 本地 Ollama（离线运行）
    1. 安装 Ollama: https://ollama.com
    2. 运行 ollama pull qwen3:14b
    3. NECOCLAW 会自动检测并使用本地模型

  方式三: 手动配置
    编辑 config.yaml 中的 llm 部分:

    llm:
      providers:
        - id: my-provider
          api_type: openai
          base_url: https://api.xxx.com/v1
          api_key: sk-xxx
          model: gpt-4o
      routes:
        - role: default
          provider_id: my-provider

───────────────────────────────────────────────────

【常用命令】

  necoclaw start      启动 Agent（含 WebUI）
  necoclaw doctor     检测系统环境
  necoclaw onboard    首次配置向导
  necoclaw --help     查看所有命令

───────────────────────────────────────────────────

【消息渠道】

  除了 WebUI，还支持接入:
  - 飞书 (Feishu)     — WebSocket 长连接
  - 钉钉 (DingTalk)   — Stream 模式
  - Telegram          — Bot API
  - Discord           — WebSocket
  - Slack             — Socket Mode
  - QQ (OneBot)       — OneBot v11
  - 微信 (WeChat)     — WeChatFerry

  在 WebUI > 更多 > 渠道 页面配置。

───────────────────────────────────────────────────

【数据目录】

  所有数据保存在 ~/.necoclaw/ (Windows: %USERPROFILE%\.necoclaw\):
  - config.yaml    配置文件
  - memory.db      对话记忆
  - workspace/     项目工作区
  - identity.yaml  Agent 身份

───────────────────────────────────────────────────

  GitHub: https://github.com/necoclaw/necoclaw
  问题反馈: https://github.com/necoclaw/necoclaw/issues
