一、环境准备与安装前检查

在开始部署前，需确保系统满足以下基础条件：

容器运行时环境：已安装Docker（建议20.10+版本）及Compose插件（v2.0+）
存储空间：建议预留至少2GB可用空间用于应用数据存储
网络配置：确保80/443端口未被占用（若使用反向代理需额外配置）
应用商店集成：已完成1Panel容器管理平台的部署（版本需支持应用市场功能）

通过应用商店安装可避免手动拉取镜像的复杂性，同时自动处理依赖关系。安装完成后，系统会自动创建名为moltbot-service的容器组，包含核心服务、数据库和Web控制台三个组件。

二、初始化配置流程详解

2.1 执行初始化命令

通过容器CLI工具完成基础配置生成：

docker compose -f docker-compose-cli.yml run --rm moltbot-cli onboard

该过程会执行以下关键操作：

生成加密密钥对（用于后续API鉴权）
创建默认管理员账户（需记录终端显示的临时密码）
初始化数据库结构（采用SQLite嵌入式数据库方案）
输出基础配置摘要（包含API端点地址等）

注意事项：

初始化过程需要互联网访问权限（用于拉取基础镜像）
若遇到端口冲突，可通过-p参数指定自定义端口
生产环境建议将数据卷挂载到持久化存储

2.2 配置文件深度调整

初始化完成后，需手动修改安全策略配置：

定位配置目录：

cd /var/lib/1panel/apps/moltbot/data/conf

编辑核心配置文件：
使用文本编辑器打开clawdbot.json，在gateway配置块中添加安全策略：

"gateway": {
  "mode": "local",
  "controlUi": {
    "allowInsecureAuth": true  // 开发环境允许HTTP明文认证
  }
}

获取访问令牌：
在配置文件中搜索gateway.auth.token字段，复制其32位哈希值。该令牌具有以下特性：
- 采用HMAC-SHA256算法生成
- 默认有效期为90天（可配置）
- 支持动态刷新机制

三、安全增强配置（可选）

3.1 TLS证书配置

生产环境建议启用HTTPS加密：

准备PEM格式证书文件

修改配置文件：

"gateway": {
  "tls": {
    "cert": "/path/to/cert.pem",
    "key": "/path/to/key.pem"
  }
}

重启服务使配置生效

3.2 访问控制策略

通过controlUi.auth配置块实现：

"controlUi": {
  "auth": {
    "mode": "token",  // 支持token/basic/oauth多种模式
    "whitelist": ["192.168.1.0/24"]  // IP白名单限制
  }
}

四、服务重建与访问验证

4.1 重建应用容器

在1Panel管理界面执行以下操作：

进入”已安装应用”列表
找到Moltbot应用卡片
点击”重建”按钮（该操作会：
- 重新拉取最新镜像
- 应用配置变更
- 保持数据卷不变
- 平均耗时约3-5分钟）

4.2 控制台访问方式

重建完成后，通过以下任一方式访问：

直接访问法：
```
http://<服务器IP>:<映射端口>?token=<复制的令牌>
```
示例：http://192.168.1.100:8080?token=c9917c5a066beeb26266d09baed99495

反向代理配置（推荐生产环境使用）：

location /moltbot/ {
  proxy_pass http://localhost:8080/;
  proxy_set_header Authorization "Bearer $token";
}

4.3 首次登录验证

成功访问后需完成：

修改默认管理员密码
配置SMTP邮件服务（用于密码重置）
设置操作日志保留周期（默认30天）
验证核心功能模块（如任务调度、API网关等）

五、常见问题处理

5.1 初始化失败排查

现象：终端报错Error: Database lock file exists
原因：前次初始化未正常完成
解决方案：删除data/db/LOCK文件后重试

5.2 令牌失效处理

当出现401未授权错误时：

检查系统时间是否同步（NTP服务状态）

重新生成令牌：

docker compose exec moltbot-service token-refresh

更新所有使用旧令牌的客户端配置

5.3 性能优化建议

对于高并发场景：

调整JVM内存参数（修改docker-compose.yml中的-Xmx值）
启用连接池（配置database.poolSize参数）
部署Redis作为缓存层（需修改gateway.cache配置）

六、升级与维护指南

6.1 版本升级流程

备份当前数据卷：

tar -czvf moltbot_backup_$(date +%Y%m%d).tar.gz /var/lib/1panel/apps/moltbot/data

在应用商店执行”升级”操作
验证配置文件兼容性（重点关注新增配置项）
执行数据库迁移脚本（如有）

6.2 监控告警配置

建议集成以下监控指标：

容器资源使用率（CPU/内存）
API请求成功率（通过Prometheus采集）
数据库连接数
任务队列积压量

可通过配置healthCheck端点实现自动化巡检：

"monitoring": {
  "endpoints": [
    "/api/v1/health",
    "/api/v1/metrics"
  ],
  "interval": 60  // 单位：秒
}

本指南系统覆盖了Moltbot从安装到生产就绪的全流程，特别针对容器化部署场景提供了详细配置说明。通过标准化操作流程，可将部署时间从传统模式的2-3小时缩短至30分钟内，同时确保安全配置符合企业级标准。建议首次部署后进行完整的功能测试，包括核心业务流验证和异常场景处理测试。

Moltbot快速部署指南：从安装到访问的全流程解析