286f6f43a7
Add complete Moltbot distributed cluster setup: - 6 documentation files (33KB) - Deployment tools and scripts - Configuration templates - Status dashboard See CLUSTER-CONFIG-SUMMARY.md for details.
260 lines
5.7 KiB
Markdown
260 lines
5.7 KiB
Markdown
# 🚀 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`
|
||
|
||
---
|
||
|
||
**🎉 配置完成！系统已就绪，随时可以使用！**
|