摘要：本文聚焦Clawdbot安装全流程，详解Windows、Mac、Linux多系统适配方案，涵盖一键脚本、Docker两种安装方式，拆解前置准备、配置衔接及常见故障解决方案，所有安装与排查命令均优化为可复制格式。结合最新版本适配要点，帮助不同系统用户高效避坑，顺利完成安装部署，为后续使用筑牢基础。全文约830字，细节拉满。
📌 安装前置：Clawdbot统一准备要求
所有系统需满足统一前置条件，版本验证与环境检查命令如下：
验证Node.js版本（需≥22）
node -v
查看系统存储空间（需预留≥2G）
Windows（管理员命令提示符）
wmic logicaldisk get size,freespace,caption
Mac/Linux（终端）
df -h
关闭 Windows Defender 实时防护（临时，安装后可重启）
Set-MpPreference -DisableRealtimeMonitoring $true关闭不必要的防火墙或安全软件，防止拦截安装脚本与核心组件，避免安装中断。
🔧 脚本安装：Clawdbot分系统实操
🪟 Windows系统：Clawdbot安装要点
Windows系统需解决权限与脚本执行策略问题，完整可复制命令如下：
以管理员身份运行命令提示符，修改PowerShell执行策略
Set-ExecutionPolicy RemoteSigned -Force
一键安装 Clawdbot
iwr -useb https://molt.bot/install.ps1 | iex
老旧 Windows 系统（Win7 等）适配 WSL2 后安装
wsl --install # 安装 WSL2（需重启电脑）wsl # 进入 Linux 子系统curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git🍎 Mac/Linux系统：Clawdbot安装要点
Mac系统一键安装（依赖Homebrew，无Homebrew先安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git
Linux 系统一键安装
curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git
Linux 源码编译安装（适配服务器场景）
git clone https://github.com/clawdbot/clawdbot.gitcd clawdbotnpm installnpm run buildnpm link # 全局可用 clawdbot 命令安装完成后，执行以下命令验证是否成功：
查看版本
clawdbot --version
基础功能测试
clawdbot test ⚙️ 进阶安装：Clawdbot Docker部署全流程
Docker部署（生产环境首选）完整可复制命令，适配国内外服务器：
1. 安装Docker与Docker Compose
国内服务器
bash <(wget -qO- https://xuanyuan.claude/docker.sh)
海外服务器
curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.shsudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-(uname−s)−(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose
2. 验证 Docker 安装
docker --versiondocker compose version
3. 部署 Clawdbot
git clone https://github.com/clawdbot/clawdbot.gitcd clawdbotcp .env.example .env.production
手动修改.env.production，设置强密码（≥16 位，含大小写、数字、特殊符号）
chmod 600 .env.productiondocker build -t clawdbot:latest .docker run -d --restart=always --name clawdbot -p 18789:18789 clawdbot:latest🔍 安装排障：Clawdbot常见故障解决
针对安装中常见报错，可通过以下命令排查修复：
端口占用报错（18789端口被占用）
Windows
netstat -ano | findstr "18789" # 查找占用进程PIDtaskkill /f /pid 进程PID # 结束占用进程
Mac/Linux
lsof -i:18789 # 查找占用进程 PIDkill -9 进程 PID # 结束占用进程
或更换端口启动
clawdbot gateway --port 8888
Docker 镜像构建失败
rm -rf clawdbot # 删除原有源码git clone https://github.com/clawdbot/clawdbot.git # 重新拉取源码docker build -t clawdbot:latest . # 重新构建
安装后无法启动，自动诊断
clawdbot doctor声明：本站所有文章，如无特殊说明或标注，均为绝学社原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系绝学社网站管理员进行处理。
