QClaw项目可通过三种方式快速创建：一、命令行初始化，执行qclaw create my-first-project生成标准骨架；二、图形向导新建，通过桌面端可视化配置环境与示例工作流；三、模板克隆，git clone后运行qclaw init --link绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚刚安装qclaw并希望快速启动一个可运行的项目，则需要完成初始化配置与基础结构搭建。以下是创建第一个qclaw项目的具体操作流程：一、通过命令行初始化新项目
QClaw提供内置CLI工具，支持在终端中一键生成标准项目骨架，该方式适用于所有操作系统且能确保依赖版本一致性。
1、打开终端（Windows用户使用PowerShell或Git Bash，macOS/Linux用户使用默认终端）。
2、执行命令：qclaw create my-first-project，其中my-first-project为自定义项目名称，不可含空格或特殊字符。
3、等待CLI自动下载模板、安装核心依赖并生成src/、config/、package.json等必要目录与文件。
4、进入项目目录：cd my-first-project。
二、使用图形化项目向导创建
QClaw桌面客户端内置交互式向导，适合不熟悉命令行的新手，通过可视化界面选择项目类型与初始配置。
1、启动QClaw桌面应用，点击主界面上方的“新建项目”按钮。
2、在弹出窗口中输入项目名称与保存路径，勾选“包含示例工作流”复选框以获得可立即运行的参考逻辑。
3、从下拉菜单中选择目标运行环境：可选Local Simulation或Cloud Edge Runtime。
4、点击“完成”，向导将自动生成项目并在资源管理器中高亮显示根目录。
三、从模板仓库手动克隆并配置
当需要基于特定行业模板（如工业传感器接入、视频流处理）启动项目时，可直接拉取官方维护的GitHub模板仓库，再绑定本地QClaw环境。
1、访问QClaw官方模板库页面，复制所需模板的HTTPS克隆地址，例如：https://github.com/qclaw-templates/iot-sensor-starter.git。
2、在终端中执行：git clone https://github.com/qclaw-templates/iot-sensor-starter.git my-iot-project。
3、进入该目录后运行：qclaw init --link，使QClaw识别该目录为合法项目并注入运行时元数据。
4、检查项目根目录下是否生成.qclaw/隐藏文件夹，其存在即表示绑定成功。
