# 🚀 Moltbot 分布式集群 - 快速使用指南

**配置完成日期**: 2026-01-29
**状态**: ✅ 全部完成并运行中

---

## ⚡ 立即开始使用

### 在台式机上

1. **启动 Moltbot**
   - 双击桌面 `Moltbot.bat`
   - 选择 [2] 启动 Gateway（首次或未运行时）
   - 等待 5-10 秒

2. **开始聊天**
   - 选择 [1] 进入聊天模式
   - 输入消息，按回车发送
   - 输入 `exit` 返回菜单

3. **快速提问**
   - 双击桌面 `Ask Moltbot.bat`
   - 输入问题，按回车

---

## 📊 当前系统状态

### ✅ 运行中

| 组件 | 状态 | 说明 |
|------|------|------|
| 服务器 Gateway | ✅ 运行中 | 38.14.254.51:18789 |
| 桌面 Gateway | ✅ 运行中 | ws://0.0.0.0:18789 |
| 浏览器控制服务 | ✅ 就绪 | 2个配置文件 |
| 监控系统 | ✅ 运行中 | 每5分钟检查 |
| 备份系统 | ✅ 运行中 | 每日00:00备份 |

### 📦 已配置文件

**桌面电脑** (D:\workspace\moltbot\):
- `CLUSTER-CONFIG-SUMMARY.md` - 完整配置报告
- `NOTEBOOK-DEPLOY.md` - 笔记本部署指南
- `SETUP.md` - 基础配置说明
- `status-dashboard.html` - 监控面板
- `notebook-setup.json` - 笔记本配置模板
- `moltbot-notebook-deploy.tar.gz` - 部署包(836MB)

**服务器** (38.14.254.51):
- `/opt/moltbot/` - Moltbot 安装目录
- `/opt/moltbot-monitoring/` - 监控脚本
- `/opt/moltbot-backup/` - 备份目录
- `/root/.clawdbot/moltbot.json` - 配置文件

---

## 💻 部署笔记本

### 方法1: 从 Git 拉取（推荐）

```bash
# 在笔记本上
git clone <your-repo> C:\moltbot
cd C:\moltbot
notebook-setup.bat
```

### 方法2: 使用部署包

1. **复制文件到笔记本**
   - `moltbot-notebook-deploy.tar.gz` (836MB)
   - `notebook-setup.bat`

2. **在笔记本上解压**
   ```cmd
   tar -xzf moltbot-notebook-deploy.tar.gz -C C:\moltbot
   cd C:\moltbot
   ```

3. **运行安装**
   ```cmd
   notebook-setup.bat
   ```

4. **开始使用**
   - 双击桌面 `Moltbot.bat`
   - 选择 [2] 启动 Gateway
   - 选择 [1] 聊天

---

## 🔧 常用操作

### 重启 Gateway

**桌面**:
- 关闭 Moltbot.bat 窗口
- 重新打开 Moltbot.bat
- 选择 [2] 启动 Gateway

**服务器**:
```bash
ssh root@38.14.254.51
systemctl restart moltbot
```

### 查看日志

**桌面**:
- 位置: `C:\Users\15622\AppData\Local\Temp\claude\...`

**服务器**:
```bash
# Gateway 日志
journalctl -u moltbot -f

# 健康检查日志
tail -f /var/log/moltbot-health.log

# 备份日志
tail -f /var/log/moltbot-backup.log
```

### 检查服务状态

**服务器**:
```bash
# Gateway 状态
systemctl status moltbot

# Redis 状态
systemctl status redis

# PostgreSQL 状态
systemctl status postgresql
```

---

## 📈 监控和维护

### 自动监控

- **检查频率**: 每 5 分钟
- **自动重启**: 服务失败时自动重启
- **告警日志**: `/var/log/moltbot-health.log`

### 自动备份

- **备份时间**: 每日 00:00
- **备份内容**: 配置、Redis、数据库、会话
- **保留策略**:
  - 每日备份: 7 天
  - 每周备份: 4 周
- **备份位置**: `/opt/moltbot-backup/`

### 手动备份

```bash
ssh root@38.14.254.51
/opt/moltbot-monitoring/backup.sh
```

---

## 🆘 故障排查

### Gateway 无法启动

```bash
# 检查 Node.js 版本
node --version  # 需要 v22+

# 检查端口占用
netstat -an | findstr 18789

# 查看错误日志
# 服务器: journalctl -u moltbot -n 50
# 桌面: 检查 Moltbot.bat 窗口
```

### 浏览器工具无法使用

1. 确认 Gateway 正在运行
2. 打开 http://127.0.0.1:18789 或 http://38.14.254.51:18789
3. 点击 Chrome 扩展图标
4. 确保 badge 显示 "ON"

### API 调用失败

1. 检查网络连接: `ping 38.14.254.51`
2. 验证 API key 是否正确
3. 查看 Gateway 日志

---

## 📖 文档索引

| 文档 | 说明 |
|------|------|
| SETUP.md | 基础配置和架构 |
| NOTEBOOK-DEPLOY.md | 笔记本部署指南 |
| CLUSTER-CONFIG-SUMMARY.md | 完整配置报告 |
| status-dashboard.html | 可视化监控面板 |
| COMPLETION-REPORT.md | 完成报告 |

---

## 🎯 系统架构

```
┌─────────────────────────────────────────┐
│     Moltbot 分布式 AI 集群              │
└─────────────────────────────────────────┘

    服务器 (38.14.254.51)       桌面 (本地)
    ┌──────────────────┐      ┌──────────────┐
    │ Gateway ✅       │      │ Gateway ✅   │
    │ Redis ✅         │      │ 浏览器工具✅  │
    │ PostgreSQL ✅    │      │              │
    │ 监控 ✅          │      │              │
    │ 备份 ✅          │      │              │
    └──────────────────┘      └──────────────┘
             │
             │     笔记本1 & 2 (待部署)
             │     ┌──────────────┐
             └─────│ Gateway      │
                   │ 浏览器工具   │
                   │ ○ 待部署     │
                   └──────────────┘
```

---

## 🔑 关键信息

| 项目 | 值 |
|------|-----|
| 服务器 IP | 38.14.254.51 |
| Gateway 端口 | 18789 |
| 浏览器控制端口 | 18792 |
| API Provider | MiniMax |
| AI 模型 | Claude 3.5 Sonnet |
| 配置目录 | `~/.clawdbot/` 或 `~/.moltbot/` |

---

## 📞 支持

**查看监控面板**: 双击桌面 `Moltbot-Quick-Start.url`

**验证集群**: 运行 `verify-cluster.bat`

**部署笔记本**: 参考 `NOTEBOOK-DEPLOY.md`

---

**🎉 配置完成！系统已就绪，随时可以使用！**