clawdbot不提供传统安装包，仅通过官方脚本、npm或源码构建部署：一、运行curl -fssl https://clawd.bot/install.sh | bash；二、npm install -g clawdbot@latest；三、git clone https://github.com/clawdbot/clawbot并pnpm build；四、所有来源须限于clawd.bot、github.com/clawdbot/clawbot、npmjs.com/package/clawdbot；五、onboard向导必配ai模型api key、消息通道token及工作目录。
如果您希望在本地部署 Clawdbot，但不确定从何处获取官方安装资源或如何完成完整配置，则可能是由于未识别其非传统“下载安装包”模式 — Clawdbot 不提供 GUI 安装程序或 .exe/.dmg 下载链接，而是通过命令行脚本与包管理器分发。以下是实现安装与配置的多种可行方法：
一、通过官方一键安装脚本（推荐）
Clawdbot 官方维护了跨平台自动安装脚本，可检测系统类型、校验 Node.js 版本、安装依赖并启动初始化向导，全程无需手动下载文件。该脚本托管于 clawd.bot 域名下，为唯一权威来源。
1、打开终端（macOS/Linux）或 PowerShell（Windows，建议以管理员身份运行）。
2、执行以下命令（macOS/Linux）：
curl -fsSL https://clawd.bot/install.sh | bash
3、Windows 用户可任选其一：
PowerShell：iwr -useb https://clawd.bot/install.ps1 | iex
CMD：curl -fsSL https://clawd.bot/install.cmd -o install.cmd && install.cmd && del install.cmd
4、脚本运行完成后，系统将自动调用 clawdbot onboard --install-daemon 启动配置向导。
二、使用 npm 全局安装（需预装 Node.js 22+）
此方法适用于已具备合规 Node.js 环境的用户，跳过环境检测环节，直接安装 CLI 工具。npm 包由官方发布并签名，源地址为 https://www.npmjs.com/package/clawdbot。
1、确认 Node.js 版本满足要求：
在终端中输入 node -v，输出必须为 v22.x.x 或更高版本。
2、执行全局安装命令：
npm install -g clawdbot@latest
3、验证安装是否成功：
clawdbot --help，若显示完整命令列表则表示安装就绪。
4、立即启动交互式配置流程：
clawdbot onboard --flow quickstart，该模式跳过高级选项，仅询问模型 API Key 与消息渠道。
三、从 GitHub 源码构建（开发/定制场景）
当需要修改网关逻辑、调试技能模块或启用实验性功能时，应克隆官方仓库进行本地构建。源码仓库为唯一可信代码来源，托管于 https://github.com/clawdbot/clawbot，所有发布版本均由此生成。
1、确保已安装 Git 与 pnpm（推荐）或 npm。
2、克隆仓库：
git clone https://github.com/clawdbot/clawdbot.git
3、进入项目目录并安装依赖：
cd clawbot && pnpm install
4、构建 CLI 工具：
pnpm build
5、建立本地命令链接：
pnpm link
6、运行初始化向导：
clawdbot onboard --install-daemon，此时 CLI 将指向本地构建版本。
四、验证安装来源真实性
Clawdbot 无第三方镜像站或非官方分发渠道。所有安装行为均应指向以下三个权威域名之一，任何其他域名（如 clawdbot.io、clawbot.dev 等）均非官方：
1、主官网与文档入口：https://clawd.bot/
2、安装脚本托管地址：https://clawd.bot/install.sh（及对应 .ps1/.cmd）
3、源码仓库地址：https://github.com/clawdbot/clawbot
4、npm 包注册页：https://www.npmjs.com/package/clawdbot
五、配置阶段关键操作
无论采用何种安装方式，onboard 向导均会引导完成三项核心配置，缺一不可：
1、选择 AI 模型后端（Claude、GPT、Qwen、Gemini 等），并粘贴对应 API Key；
2、启用至少一个消息通道（Telegram、WhatsApp、Discord），例如 Telegram 需提供 BotFather 分配的 botToken 字符串（形如 123456789:ABCdefGHIjklMNOPqrSTUVWXYZ）；
3、确认工作目录路径（默认为 /root/clawd 或 %USERPROFILE%\clawd），该路径下将生成 config.json 与 memory/ 子目录。
