openclaw/QUICK-START.md

🚀 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 拉取（推荐）

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

方法2: 使用部署包

1. 复制文件到笔记本

   • moltbot-notebook-deploy.tar.gz (836MB)
   • notebook-setup.bat

2. 在笔记本上解压

   tar -xzf moltbot-notebook-deploy.tar.gz -C C:\moltbot
   cd C:\moltbot
   

3. 运行安装

   notebook-setup.bat
   

4. 开始使用

   • 双击桌面 Moltbot.bat
   • 选择 [2] 启动 Gateway
   • 选择 [1] 聊天

---

🔧 常用操作

重启 Gateway

桌面:

• 关闭 Moltbot.bat 窗口
• 重新打开 Moltbot.bat
• 选择 [2] 启动 Gateway

服务器:

ssh root@38.14.254.51
systemctl restart moltbot

查看日志

桌面:

• 位置: C:\Users\15622\AppData\Local\Temp\claude\...

服务器:

# Gateway 日志
journalctl -u moltbot -f

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

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

检查服务状态

服务器:

# 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/

手动备份

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

---

🆘 故障排查

Gateway 无法启动

# 检查 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

---

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