Clawdbot(Moltbot)保姆级安装教程

以下是针对 Clawdbot（Moltbot） 的保姆级安装教程，涵盖环境准备、下载安装、配置调试全流程，适配不同操作系统（Windows/macOS/Linux），并附常见问题解决指南。

一、前置说明

Clawdbot（Moltbot）是一款功能型机器人/工具（具体用途可能为自动化交互、数据采集或智能对话，需根据实际版本调整），安装前需明确：

系统要求：Windows 10+/macOS 12+/Ubuntu 20.04+（64位）；
依赖环境：Python 3.8+、Node.js 16+、Git（可选，用于拉取代码）；
权限要求：部分操作需管理员/终端sudo权限。

二、环境准备（必做！）

1. 检查/安装Python 3.8+

Clawdbot核心依赖Python，需确保版本≥3.8。

Windows：
① 前往 Python官网下载最新版（如3.11）；
② 安装时勾选 Add Python to PATH（关键！否则需手动配置环境变量）；
③ 验证：打开命令提示符（Win+R→输入cmd），运行 python --version，显示版本号即成功。
macOS：
① 自带Python可能为2.x，需手动安装3.8+：
- 方法1（推荐）：通过Homebrew安装：brew install python@3.11（需先安装Homebrew）；
- 方法2：官网下载.pkg安装包，按向导完成。
  ② 验证：终端运行 python3 --version（macOS需用python3区分系统自带2.x）。
Linux（Ubuntu）：
① 终端运行 sudo apt update && sudo apt install python3.8 python3-pip；
② 验证：python3 --version 和 pip3 --version。

2. 安装Node.js 16+（若依赖前端模块）

部分Clawdbot版本需Node.js运行前端界面或插件。

Windows/macOS：
前往 Node.js官网下载LTS版本（如18.x），安装时勾选自动添加PATH；
验证：终端运行 node --version 和 npm --version。
Linux（Ubuntu）：
终端运行 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs；
验证同上。

3. 安装Git（可选，用于拉取源码）

若需从GitHub/Gitee获取最新代码，需安装Git：

Windows：Git官网下载安装包，按向导完成（默认选项即可）；
macOS：brew install git 或官网下载；
Linux：sudo apt install git；
验证：git --version。

三、下载Clawdbot（Moltbot）

根据版本类型选择安装方式（预编译包/源码编译）：

方式1：预编译包（推荐新手）

适合快速上手，无需编译，直接解压运行。

获取安装包：
- 官方渠道：访问Clawdbot官网/GitHub Releases（假设仓库地址），下载对应系统的压缩包（如clawdbot-windows-x64.zip、clawdbot-macos-arm64.dmg）；
- 第三方可信源：注意核对文件哈希值（如SHA256），避免恶意软件。
解压/安装：
- Windows：右键压缩包→“全部提取”→选择路径（如C:\Tools\Clawdbot）；
- macOS：双击.dmg文件→拖拽图标到Applications文件夹；
- Linux：解压.tar.gz：tar -zxvf clawdbot-linux-x64.tar.gz -C ~/tools/（路径自定义）。

方式2：源码编译（适合开发者/定制需求）

需从代码仓库拉取源码并编译。

克隆代码（需Git）：
终端运行： # GitHub示例（替换为实际仓库地址） git clone https://github.com/clawdbot/moltbot.git cd moltbot
安装依赖（以Python项目为例）： # 创建虚拟环境（可选但推荐） python -m venv venv # 激活虚拟环境 # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate # 安装Python依赖 pip install -r requirements.txt # 若需Node.js依赖（如前端界面） npm install

四、初始化配置

安装完成后，需配置关键参数（如API密钥、权限、网络）。

1. 配置文件定位

预编译包：通常在安装目录的config文件夹（如C:\Tools\Clawdbot\config\settings.json）；
源码版：在项目根目录的config文件夹（如moltbot/config/settings.json）。

2. 关键配置项（示例）

用文本编辑器（如VS Code、Notepad++）打开settings.json，修改以下内容：

{
  "api_key": "your_api_key_here",  // 替换为实际API密钥（如OpenAI、自定义服务）
  "log_level": "INFO",            // 日志级别（DEBUG/INFO/WARNING/ERROR）
  "network": {
    "proxy": "",                  // 代理地址（如无代理留空）
    "timeout": 30                 // 请求超时时间（秒）
  },
  "permissions": {
    "allow_file_access": true,     // 是否允许访问本地文件
    "allow_network": true          // 是否允许联网
  }
}

3. 环境变量（可选）

敏感信息（如API密钥）建议通过环境变量设置，避免明文暴露：

Windows：
右键“此电脑”→属性→高级系统设置→环境变量→新建系统变量（如CLAWDBOT_API_KEY=your_key）；
macOS/Linux：
终端编辑~/.bashrc或~/.zshrc，添加： export CLAWDBOT_API_KEY="your_key" 保存后运行 source ~/.bashrc 生效。

五、运行Clawdbot

1. 预编译包启动

Windows：进入安装目录→双击clawdbot.exe（或start.bat批处理文件）；
macOS：打开Applications文件夹→双击Clawdbot.app（首次运行需在“系统设置-安全性与隐私”中允许）；
Linux：终端进入安装目录→运行 ./clawdbot（若提示权限不足，先执行chmod +x clawdbot）。

2. 源码版启动

根据项目类型选择命令（以Python后端+Node.js前端为例）：

仅后端： # 激活虚拟环境（若使用） # Windows: venv\Scripts\activate # macOS/Linux: source venv/bin/activate python main.py # 或根据项目入口文件调整（如app.py）
前后端同时启动（需另开终端）： # 终端1：启动后端 python main.py # 终端2：启动前端（假设前端在frontend目录） cd frontend npm run serve # 或npm start（根据package.json配置）

3. 验证运行

启动后，观察终端/日志输出：

成功标志：显示“Server started on port 8080”或类似提示；
访问界面：浏览器打开http://localhost:8080（端口以实际配置为准），若能加载界面则正常。

六、常见问题与解决

问题1：Python/Node.js版本过低

现象：运行python main.py提示“语法错误”或npm install失败；
解决：卸载旧版本，重新安装≥3.8（Python）或≥16（Node.js），并确保PATH正确。

问题2：依赖安装失败（如pip/npm报错）

现象：pip install -r requirements.txt提示“找不到包”或网络超时；
解决：
- 切换国内镜像源：
  - pip：pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple；
  - npm：npm config set registry https://registry.npmmirror.com；
- 检查网络代理（如公司内网需配置代理）。

问题3：启动时报“端口被占用”

现象：提示“Address already in use: port 8080”；
解决：
- 关闭占用端口的程序（Windows用netstat -ano | findstr 8080查PID，任务管理器结束进程；macOS/Linux用lsof -i:8080查PID，kill -9 PID）；
- 或修改配置文件中的端口（如将8080改为8081）。