从零部署Moltbot：2026最新原创教程，新手也能一次成功

2026年初，开源圈爆火的Moltbot（原Clawdbot）凭借“本地优先、主动执行、多端联动”的核心优势，成为无数用户的首选个人AI助手——它不像传统AI那样只提供建议，而是能直接操作用户设备，完成文件整理、浏览器控制、跨平台消息交互等实操任务，被誉为“住在设备里的全职数字管家”[4]。无论是新手想快速拥有专属AI助手，还是开发者想基于源码二次定制，这篇教程都能帮你避开所有坑，实现从零到一的完整部署。

本文将覆盖「本地设备部署」「Docker容器化部署」「阿里云云端部署」三种主流方案，适配Windows、Mac、Linux、VPS等不同环境，每一步都附带详细指令和验证方法，全程原创无抄袭，确保新手也能跟着操作成功。

一、先搞懂：Moltbot是什么，部署前必知核心要点

1.1 Moltbot核心定位

Moltbot是一款基于MIT协议开源的自托管AI智能体，本质是“AI智能体网关”，核心价值是让AI从“提供建议”升级为“直接执行”[4]。它无需依赖专属客户端，可通过Telegram、WhatsApp、Discord等12+常用聊天软件交互，所有数据存储在本地设备，隐私自主可控，还支持插件扩展和永久记忆，越用越贴合个人习惯[6]。

1.2 部署前必看前提

• 适配场景：个人学习、私人AI助手、小型团队内部工具（不适合大规模多用户并发场景）[2]；
• 核心依赖：需对接大模型（Anthropic Claude、OpenAI GPT、Ollama本地模型等），需提前准备对应API密钥（本地模型可免密钥）[1]；
• 安全提醒：Moltbot可执行终端命令、访问本地文件，部署时务必做好安全隔离，避免泄露敏感信息[1]。

二、部署准备：硬件+软件，一次性备齐不踩坑

无论选择哪种部署方案，都需要先准备好硬件环境和基础软件，不同方案的配置要求略有差异，按需对应即可。

2.1 硬件配置要求

部署场景	最低配置	推荐配置	适配设备
本地部署（个人使用）	CPU双核、内存4GB、硬盘20GB可用空间	CPU四核、内存8GB+、硬盘50GB+ SSD	Windows 10+、MacOS、Linux（Ubuntu 20.04+）、树莓派4
Docker容器化部署	CPU双核、内存2GB、硬盘20GB可用空间	CPU双核、内存4GB+、硬盘30GB+ SSD	任意支持Docker的设备（本地电脑、VPS）
阿里云云端部署	2vCPU、内存2GB、40GB ESSD、200Mbps带宽	2vCPU、内存4GB+、40GB ESSD、200Mbps带宽	阿里云轻量应用服务器（免备案地域优先）

注：Mac Mini M4（16GB内存+256GB SSD）因性价比高、功耗低，是本地长期部署的首选设备[1]。

2.2 必备软件与资源

（1）通用必备软件

• Git：用于克隆源码（本地部署、源码部署必备），各系统安装命令如下[1]：
• MacOS：brew install git
• Ubuntu/Debian：sudo apt-get install git
• Windows：下载Git安装包（官网直达），默认安装即可。
• js：版本≥22（本地部署、源码部署必备），安装命令[1]：
• MacOS：brew install node
• Ubuntu/Debian：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash – && sudo apt-get install -y nodejs
• Windows：下载js安装包（选择≥22版本），勾选“Add to PATH”，安装后重启终端。
• 包管理器：npm（随js自动安装）或pnpm（推荐，更快），pnpm安装命令：npm install -g pnpm[1]。

（2）可选软件（按需安装）

• Docker：用于容器化部署，实现安全隔离，推荐所有用户安装（尤其是公网部署）[2]；
• 本地模型：Ollama/LM Studio，可替代云端API，实现免费本地运行（无需API密钥）[1]；
• 远程工具：Xshell、Putty（云端部署、VPS部署时，用于远程连接服务器）。

（3）必备资源

• API密钥：对接云端大模型需准备（Anthropic：https://console.anthropic.com/；OpenAI：https://platform.openai.com/api-keys）[1]；
• 通信渠道凭证：如Telegram Bot Token、WhatsApp账号（用于绑定Moltbot交互渠道）[1]；
• 阿里云账号（云端部署必备）：需完成实名认证，用于购买服务器和获取百炼API-Key[3]。

三、三种部署方案：按需选择，新手优先选这一种

推荐优先级：新手→本地全局部署（最简单，一条命令搞定）；需要稳定运行→Docker容器化部署（安全隔离）；需要7×24小时在线→阿里云云端部署（无需占用本地设备）。

方案一：本地全局部署（新手首选，5分钟搞定）

这种方式无需复杂配置，适合新手快速体验Moltbot核心功能，支持Windows、MacOS、Linux全系统。

步骤1：验证基础环境

打开终端（Mac/Linux）或PowerShell（Windows），依次输入以下命令，验证Node.js、pnpm、Git是否安装成功，若输出版本号则正常：

bash node -v  # 需显示≥v22.0.0 pnpm -v  # 任意版本均可 git -v   # 任意版本均可

步骤2：全局安装Moltbot

输入以下命令（二选一，推荐pnpm，速度更快），自动下载并安装最新版Moltbot[1]：

bash # 方式1：pnpm安装（推荐） pnpm add -g moltbot@latest # 方式2：npm安装 npm install -g moltbot@latest

步骤3：验证安装成功

输入以下命令，若输出版本号，说明安装成功：

bash moltbot –version

步骤4：运行配置向导（关键步骤）

输入以下命令，启动配置向导，一步步完成初始化（全程中文引导，新手无需担心）[1]：

bash moltbot onboard –install-daemon

配置向导核心步骤（按提示操作即可）：

1. 选择AI模型提供商：新手推荐Anthropic（Claude，功能最全），本地用户可选Ollama（免费）；
2. 配置API密钥：粘贴提前准备的API密钥，系统会自动验证有效性；
3. 选择消息渠道：推荐Telegram（海外）或企业微信（国内），按提示获取并输入凭证；
4. 配置工作区：选择默认技能（文件操作、浏览器控制等），安装后台守护进程（实现开机自启）。

步骤5：启动Moltbot并测试

配置完成后，输入以下命令启动Moltbot服务（推荐守护进程启动，无需手动维持）[1]：

bash # 守护进程自动启动（推荐） moltbot gateway # 手动指定端口启动（端口冲突时使用） moltbot gateway –port 18789

启动成功后，打开浏览器访问以下地址，即可通过网页端操作Moltbot：

• Web聊天界面：http://localhost:18789/chat
• 控制面板：http://localhost:18789

测试方法：在网页聊天界面发送“帮我列一个项目清单”，若能正常回复并执行，说明部署成功[1]。

方案二：Docker容器化部署（安全稳定，推荐长期运行）

Docker部署可实现环境隔离，避免Moltbot影响本地系统，同时便于迁移和升级，适合长期运行或公网部署，步骤如下[2]。

步骤1：安装并验证Docker

参考以下命令安装Docker（国内服务器推荐一键安装脚本，解决网络问题）：

bash # 国内服务器一键安装（推荐） bash <(wget -qO- https://xuanyuan.cloud/docker.sh) # 海外服务器/本地设备（官方安装方式） curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh

安装完成后，输入以下命令验证，输出版本号即正常：

bash docker –version docker compose version

步骤2：拉取Moltbot镜像

注意：生产环境务必锁定具体版本，避免使用latest（防止自动更新引入兼容问题）[2]：

bash # 测试环境（快速体验，用latest） docker pull xxx.xuanyuan.run/moltbot/moltbot:latest # 生产环境（推荐，替换v1.0.0为实际稳定版本） docker pull xxx.xuanyuan.run/moltbot/moltbot:v1.0.0

步骤3：启动Docker容器

分两种场景，按需选择命令，启动后自动映射端口18789：

（1）测试环境（本地体验，简化配置）

bash docker run -d \ –name moltbot-test \ -p 18789:18789 \ -v ~/.clawdbot:/root/.clawdbot \ -e AGENT_MODEL=”anthropic/claude-opus-4-5″ \ -e LOG_LEVEL=”info” \ –restart unless-stopped \ xxx.xuanyuan.run/moltbot/moltbot:latest

（2）生产环境（安全优先，非root运行）

bash docker run -d \ –name moltbot-prod \ -p 127.0.0.1:18789:18789 \  # 仅本地可访问，公网需配合反向代理 -v /data/moltbot:/home/moltbot/.clawdbot \ -e AGENT_MODEL=”anthropic/claude-opus-4-5″ \ -e LOG_LEVEL=”info” \ –user 1000:1000 \  # 非root用户运行，提升安全性 –read-only \  # 容器文件系统只读，防止篡改 –security-opt no-new-privileges \  # 禁止提升权限 –restart unless-stopped \ xxx.xuanyuan.run/moltbot/moltbot:v1.0.0

步骤4：验证容器运行状态

输入以下命令，若STATUS显示“Up”，说明容器启动成功：

bash docker ps | grep moltbot

后续配置（API密钥、消息渠道）：进入容器执行配置向导，命令如下：

bash docker exec -it moltbot-prod moltbot onboard –install-daemon

方案三：阿里云云端部署（7×24小时在线，无需本地设备）

适合没有闲置本地设备，需要Moltbot全天候运行的用户，阿里云提供一键部署镜像，简化配置[3]。

步骤1：准备阿里云资源

1. 注册并实名认证阿里云账号，进入Moltbot专属部署页面：https://www.aliyun.com/activity/ecs/clawdbot；
2. 创建阿里云百炼API-Key：进入https://bailian.aliyun.com，在“密钥管理”中创建API-Key，复制并保存（后续配置用）[3]。

步骤2：购买服务器并部署镜像

1. 点击“一键购买并部署”，选择Moltbot应用镜像（2026年默认版本1.25）；
2. 配置参数：地域选择美国（弗吉尼亚，免ICP备案），实例规格默认2vCPU+2GiB（足够基础使用），选择购买时长；
3. 支付完成后，等待1-3分钟，直至服务器实例状态变为“运行中”，记录公网IP地址[3]。

步骤3：配置API-Key与端口放行

1. 进入服务器实例详情页，找到“应用详情”，点击“防火墙一键放行应用端口”（端口18789）；
2. 点击“配置百炼API-Key”，粘贴提前保存的API-Key，执行命令完成配置；
3. 点击“生成token执行命令”，复制生成的访问Token（登录后台用）[3]。

步骤4：访问并测试Moltbot

打开本地浏览器，输入“http://服务器公网IP:18789”，输入访问Token登录控制面板，完成消息渠道配置后，即可正常使用[3]。

四、核心配置详解：优化体验+保障安全

4.1 配置文件位置与核心参数

Moltbot配置文件默认路径：~/.clawdbot/moltbot.json，可手动修改优化配置，核心参数说明如下[1]：

json { “channels”: {  // 消息渠道配置 “telegram”: { “botToken”: “YOUR_TELEGRAM_BOT_TOKEN”,  // 替换为你的Telegram Token “dm”: { “policy”: “pairing”,  // 私聊策略：pairing（需配对，更安全） “allowFrom”: [“your_user_id”]  // 允许私聊的用户ID }, “groups”: { “*”: { “requireMention”: true  // 群聊需@Moltbot才响应，防止误触发 } } } }, “ai”: {  // AI模型配置 “provider”: “anthropic”,  // 模型提供商，推荐anthropic “model”: “claude-opus-4-5”,  // 模型版本 “apiKey”: “sk-ant-xxx”  // 替换为你的API密钥 }, “security”: {  // 安全配置（必配） “sandbox”: true,  // 开启沙箱隔离，防止恶意命令 “allowedCommands”: [“ls”, “cat”, “grep”]  // 允许执行的终端命令，限制最小权限 } }

4.2 必做安全配置（重中之重）

Moltbot的执行权限较高，务必做好以下安全措施，避免风险[1][6]：

1. 开启沙箱隔离：确保配置文件中“security.sandbox”设为true；
2. 限制终端命令：仅保留必要的命令（如ls、cat），禁止rm、sudo等高危命令；
3. 控制访问权限：私聊策略设为pairing，群聊开启“requireMention”；
4. 公网部署需反向代理：通过Nginx配置HTTPS，隐藏端口，避免直接暴露公网；
5. 定期更新：输入“pnpm update -g moltbot”（本地部署）或重新拉取最新镜像（Docker部署），修复安全漏洞。

五、常见问题排查：遇到坑不用慌，逐一解决

部署过程中遇到报错，优先排查以下问题，90%的坑都能解决：

1. 安装失败：提示“依赖缺失”“版本不符”

解决方法：① 确认Node.js版本≥22，若版本过低，卸载后重新安装；② 清除npm/pnpm缓存，命令：npm cache clean –force / pnpm store prune；③ 更换国内镜像源，加速依赖下载：

bash npm config set registry https://registry.npmmirror.com pnpm config set registry https://registry.npmmirror.com

2. 启动失败：提示“端口18789被占用”

解决方法：① 查找占用端口的进程，终止进程（Mac/Linux：sudo lsof -i:18789 | grep -v PID | awk ‘{print $2}’ | xargs sudo kill -9）；② 手动指定其他端口启动，命令：moltbot gateway –port 18790。

3. API调用失败：提示“密钥无效”“网络错误”

解决方法：① 检查API密钥是否输入正确，是否过期，重新生成并配置；② 国内用户需配置代理，解决网络访问问题；③ 切换AI模型提供商（如从OpenAI切换为Anthropic）。

4. 消息渠道无法连接：Telegram/WhatsApp无法接收消息

解决方法：① 检查渠道凭证（如Telegram Bot Token）是否正确，重新获取并配置；② 确认服务器网络可访问对应渠道（如Telegram需开放对应端口）；③ 重启Moltbot服务：moltbot gateway restart。

5. Docker容器启动后，无法访问网页端

解决方法：① 检查容器端口映射是否正确（docker ps查看PORTS字段）；② 确认防火墙已放行18789端口；③ 生产环境若配置“127.0.0.1:18789:18789”，需通过服务器本地浏览器访问，公网需修改端口映射为“0.0.0.0:18789:18789”并配置反向代理。

六、部署完成后：这些优化让Moltbot更好用

1. 安装插件：访问Clawdhub（Moltbot社区技能平台），安装文件整理、日程管理等插件，扩展功能；
2. 设置开机自启：本地部署可通过系统自带工具（如Mac的启动台、Windows的服务）设置，Docker部署已通过“–restart unless-stopped”实现自动重启；
3. 数据备份：定期备份配置文件（~/.clawdbot/moltbot.json）和本地记忆数据，避免误操作导致数据丢失；
4. 体验高级功能：尝试通过Moltbot执行Shell命令、控制浏览器抓取网页信息、跨渠道同步消息，解锁“数字管家”全部能力[6]。

七、总结：部署Moltbot，选对方案就很简单

Moltbot作为2026年现象级本地AI助手，部署难度并不高——新手优先选择「本地全局部署」，5分钟就能完成；需要长期稳定运行，选「Docker容器化部署」，兼顾安全与便捷；需要全天候在线，选「阿里云云端部署」，无需占用本地设备。

核心要点：做好基础环境准备，严格配置API密钥和安全参数，遇到问题优先排查端口、网络和配置文件，就能一次部署成功。部署完成后，你会发现Moltbot能真正帮你节省时间，从繁琐的重复操作中解放出来，成为你工作和生活中的得力助手。

如果在部署过程中遇到其他未提及的问题，欢迎在评论区留言，一起交流解决～

|（注：文档部分内容可能由 AI 生成)