clawdbot支持windows（10+，含wsl2）、macos（ventura 13+，arm版node.js）、linux（ubuntu 20.04+/debian 11+），均需node.js 22+；安装后须运行clawdbot onboard并输入有效api密钥方可启用。
如果您希望在个人电脑上部署Clawdbot本地AI助手，但不确定其在不同操作系统下的安装路径与兼容性要求，则需根据系统类型选择对应安装方式。以下是针对主流桌面操作系统的兼容性说明与具体安装步骤：
一、Windows系统安装方法
Windows平台需依赖PowerShell与Node.js运行环境，安装过程涉及执行策略调整与依赖缓存清理，适用于Windows 10及以上版本（含WSL2子系统支持）。
1、访问Node.js官网下载并安装Node.js 22或更高版本，安装时勾选“Add to PATH”选项。
2、以管理员身份打开PowerShell，执行命令：Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process，解除脚本执行限制。
3、在PowerShell中运行安装命令：iwr -useb https://molt.bot/install.ps1 | iex。
4、若提示nup/git拉取失败，执行：npm cache clean --force后重试安装脚本。
5、安装完成后运行clawdbot onboard启动引导配置，按提示输入API密钥并选择模型。
二、macOS系统安装方法
macOS需满足Ventura 13及以上系统版本，且必须使用ARM架构版Node.js以保障M系列芯片性能，安装脚本自动适配M1/M2/M3/M4芯片。
1、打开终端，执行命令检查Node版本：node -v；若低于22或无输出，需前往Node.js官网下载ARM64安装包。
2、在终端中粘贴并执行安装命令：curl -fsSL https://clawd.bot/install.sh | bash，输入管理员密码授权。
3、安装成功后验证版本：clawdbot --version，确认返回有效版本号。
4、运行入职向导并安装后台守护进程：clawdbot onboard --install-daemon，弹出权限请求时点击“允许”。
5、完成配置后，本地控制面板将自动在浏览器中打开：http://127.0.0.1:18789。
三、Linux系统安装方法
Linux平台推荐Ubuntu 20.04+或Debian 11+发行版，安装依赖curl、Git与Node.js，脚本自动检测并补全缺失组件。
1、确保系统已安装curl工具，如未安装，执行：sudo apt update && sudo apt install curl -y（Ubuntu/Debian）。
2、在终端中运行安装命令：curl -fsSL https://clawd.bot/install.sh | bash。
3、安装完成后执行：clawdbot doctor进行健康检查，发现异常可运行clawdbot doctor --fix尝试自动修复。
4、启动引导配置：clawdbot onboard，按提示完成模型接入与渠道绑定。
四、Windows通过WSL2安装方法
该方式适用于习惯Linux生态但使用Windows系统的用户，利用WSL2提供原生Linux运行环境，规避Windows底层兼容性问题。
1、以管理员身份运行PowerShell，执行：wsl --install启用WSL2并安装默认Ubuntu发行版。
2、重启系统后，在开始菜单启动Ubuntu应用，设置Linux用户名与密码。
3、在Ubuntu终端中更新系统：sudo apt update && sudo apt upgrade -y。
4、安装Node.js 22+：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs。
5、全局安装Clawdbot：sudo npm install -g clawdbot@latest，验证安装：clawdbot --help。
6、运行入职向导：clawdbot onboard --install-daemon，完成模型与通信渠道配置。
五、各系统兼容性关键说明
Clawdbot官方明确支持三大桌面平台，但对底层运行环境有差异化要求：Windows仅支持x64与ARM64架构，macOS强制要求Ventura 13+及ARM版Node.js，Linux需curl与Git可用且内核版本≥5.4。
1、Node.js版本必须为22或以上，低版本将导致核心模块加载失败。
2、macOS下若出现/usr/local is not writable错误，需执行：sudo chown -R $(whoami) $(brew --prefix)/*修复权限。
3、所有平台安装后首次运行clawdbot onboard时，必须输入有效的AI模型API密钥，否则无法进入主功能流程。
4、Telegram、Discord、WhatsApp等消息渠道的接入能力在所有平台一致，但飞书、钉钉等国产IM需手动配置Webhook或使用社区插件。
