ClawdBot（Moltbot）腾讯云一键部署教程（新手零失败）

ClawdBot（官方后更名为Moltbot）作为爆火的开源私有化AI智能助理，支持多渠道交互、系统指令执行、多大模型适配等核心能力，腾讯云轻量应用服务器 已上线其专属预置应用镜像，无需手动配置环境、安装依赖，全程零代码、10分钟 即可完成部署，适配零基础新手；同时补充Docker源码构建方案，满足开发者自定义配置需求。

本文为腾讯云专属部署教程，基于最新ClawdBot 版本，所有命令、步骤均经实测可直接复用，配套腾讯云专属避坑指南 和部署验证方法，确保新手一次成功。

一、前置认知与准备

1.1 ClawdBot核心特性

多渠道交互：支持Telegram、WhatsApp、钉钉等12+通信软件，常用工具即可发指令；
私有化部署：数据完全自主掌控，无隐私泄露风险，7×24小时云端运行；
全能任务：可执行系统命令、读写文件、修改代码、监控API、定时任务；
多模型适配：无缝接入Kimi、MiniMax、GLM、Anthropic等主流大模型，按需切换；
轻量低配：2核2G腾讯云轻量服务器即可流畅运行，低成本易上手。

1.2 腾讯云部署核心优势

预置镜像：官方适配的ClawdBot应用模板，一键部署，无需手动装依赖；
免密登录：控制台内置OrcaTerm工具，无需Xshell等第三方软件，直接登录服务器；
灵活地域：支持国内/海外节点，海外节点完美适配Telegram等海外通信渠道；
高可用性：腾讯云原生网络保障，比本地部署更稳定，无需保持本地设备开机。

1.3 前置准备（必做，避免后续踩坑）

1.3.1 账号与权限

腾讯云账号：完成个人/企业实名认证（个人需身份证，企业需营业执照）；
大模型API Key：提前获取1个主流大模型API Key（如Kimi、MiniMax、GLM），用于ClawdBot初始化，注册对应平台即可免费获取测试额度；
- Kimi API Key：https://platform.moonshot.cn
- MiniMax API Key：https://platform.minimax.io

1.3.2 云服务器配置要求

腾讯云轻量应用服务器 为最优选择，配置要求如下，新手直接选最低配置即可满足日常使用：

|----------------------------------------------------------------------------------------|------------------|------------------|
| 配置项 | 最低配置（推荐新手） | 进阶配置（复杂任务/多渠道） |
| CPU | 2核 | 4核 |
| 内存 | 2GB | 8GB |
| 系统盘 | 40GB ESSD | 100GB ESSD |
| 带宽 | 1Mbps | 5Mbps |
| 操作系统 | Ubuntu 22.04 LTS | Ubuntu 22.04 LTS |
| 地域 | 海外（新加坡/硅谷） | 国内（北京/杭州）/海外 |
| > 小贴士：若需使用Telegram/WhatsApp等海外通信渠道，必须选择海外地域，国内地域会被网络限制；仅用Kimi/GLM等国内模型+钉钉，可选国内地域。 | | |

1.3.3 工具准备

无需第三方远程工具：腾讯云控制台内置OrcaTerm，免密登录服务器；
通信软件：提前安装钉钉/Telegram/WhatsApp（任选其一），用于后续与ClawdBot交互。

二、新手首选：腾讯云轻量应用服务器预置镜像一键部署

这是最便捷的部署方式，腾讯云已将ClawdBot的运行环境、依赖全部预置在应用模板中，新购/重装服务器即可，全程零代码，适合零基础新手。

2.1 场景1：新购腾讯云轻量应用服务器

访问腾讯云轻量应用服务器购买页；
按以下要求配置服务器（关键步骤，务必严格按此设置）：
1. 地域与可用区：按需求选择「海外-新加坡/硅谷」或「国内-北京/杭州」；
2. 应用模板：点击应用模板 → 选择AI智能体 分类 → 找到Moltbot（ClawdBot）（若未显示，点击「展开其他镜像」），镜像版本为v2026.1.25；
3. 套餐配置：选择锐驰型 ，直接选2核2G/40GB ESSD/1Mbps（新手最低配）；
4. 登录方式：默认密码登录，设置服务器登录密码（建议含大小写+数字+特殊符号，提升安全性）；
5. 购买时长：新手可先买1个月，测试无误后再续费；
点击立即支付 ，完成后返回「轻量应用服务器控制台」，等待实例创建完成（约1-2分钟，状态显示运行中即就绪）。

2.2 场景2：重装已有腾讯云轻量应用服务器（适合有闲置实例）

若已有腾讯云轻量应用服务器（配置≥2核2G，系统为Ubuntu），可直接重装为ClawdBot镜像，无需新购：

登录腾讯云轻量应用服务器控制台；
找到闲置实例，点击实例名称进入详情页；
点击右上角更多 → 重装系统；
选择应用模板 → AI智能体 → Moltbot（ClawdBot） ，备份选项建议选备份后重装（避免丢失原有数据）；
重新设置登录密码，点击确认，等待重装完成（约3-5分钟）。

2.3 步骤3：登录服务器并初始化ClawdBot

腾讯云内置OrcaTerm免密登录工具，无需记住密码，直接操作：

在轻量应用服务器控制台，找到已创建/重装的ClawdBot实例，点击右侧登录；
选择OrcaTerm → 点击免密连接，直接进入服务器终端（首次登录可能需等待10秒加载）；
终端中输入以下核心初始化命令，直接复制运行，启动ClawdBot配置向导：

clawdbot onboard
按向导完成配置（全程键盘操作 ：方向键选选项，回车键确认，新手选快速模式即可）：
1. Step1：安全确认：提示「ClawdBot权限较高，是否继续？」，选Yes；
2. Step2：初始化模式：选QuickStart（快速入门）（开发者可选Advanced高级模式）；
3. Step3：模型配置：选择模型提供商（如Kimi/MiniMax），粘贴提前准备的API Key，按回车确认（默认模型保持「Keep current」）；
4. Step4：通信渠道（可选）：选择常用通信软件（如Telegram/钉钉），按提示获取Bot Token并配置（新手可暂时跳过，后续再配置）；
5. Step5：完成初始化：向导提示Onboarding complete ，表示配置成功，此时ClawdBot已临时启动。

2.4 步骤4：配置后台运行（关键！避免关闭终端失效）

默认情况下，关闭OrcaTerm终端后，临时启动的ClawdBot会停止运行，需配置后台守护进程，实现7×24小时全天候运行，命令直接复制运行：

先按Ctrl+C（Windows/Mac通用），终止当前临时运行的ClawdBot；
依次运行以下命令，配置后台守护进程：

启用用户linger模式，确保后台进程持续运行 loginctl enable-linger $(whoami) && export XDG_RUNTIME_DIR=/run/user/$ (id -u) # 安装ClawdBot后台守护进程 clawdbot daemon install # 启动后台守护进程 clawdbot daemon start # 查看运行状态（验证是否启动成功） clawdbot daemon status
验证：若运行clawdbot daemon status后，终端显示active (running)，说明后台运行配置成功，此时关闭OrcaTerm终端，ClawdBot仍会在腾讯云服务器上持续运行。

2.5 步骤5：部署验证（两种方式，任选其一即可）

部署完成后，需验证ClawdBot是否可正常使用，Web UI验证为新手首选，操作最简单：

方式1：Web UI访问验证（新手首选）

回到腾讯云轻量应用服务器控制台，复制该实例的公网IP（实例列表中直接显示）；
打开浏览器，访问以下地址（18789为ClawdBot默认端口，腾讯云已自动放行）：

http://你的服务器公网IP:18789
若能成功打开ClawdBot Web交互界面，说明部署完全成功，可直接在网页中输入指令（如「帮我写一个Python冒泡排序代码」）测试交互。

方式2：通信软件验证（已配置通信渠道的用户）

打开已配置的通信软件（如Telegram/钉钉），给ClawdBot发送任意指令；
若ClawdBot能快速回复，且回复内容符合需求，说明部署+通信渠道配置均成功。

三、开发者进阶：腾讯云轻量/ECS Docker源码构建部署

若需自定义ClawdBot配置 （如修改默认端口、集成自定义模型、配置日志持久化），推荐使用Docker源码构建方案，适配腾讯云轻量应用服务器/ECS云服务器，步骤如下（基于Ubuntu 22.04）。

3.1 步骤1：环境准备（安装Docker+Docker Compose）

用OrcaTerm/第三方工具登录腾讯云服务器；
运行腾讯云专属Docker一键安装脚本（国内节点优化，解决网络问题），直接复制运行：

一键安装Docker+Docker Compose，适配Ubuntu 22.04 bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
验证安装：运行以下命令，若能正常输出版本信息，说明安装成功：

docker --version docker compose version

正常输出示例：Docker version 26.0.0；Docker Compose version v2.24.6。

3.2 步骤2：拉取ClawdBot源码并构建镜像

克隆ClawdBot官方源码（国内节点用GitHub加速镜像，避免克隆失败）：

国内节点推荐加速镜像 git clone https://github.com.cnpmjs.org/clawdbot/clawdbot.git # 海外节点直接克隆官方源码 git clone https://github.com/clawdbot/clawdbot.git # 进入项目目录 cd clawdbot
复制并编辑环境变量文件（生产环境必做，加固安全，避免敏感信息泄露）：

复制环境变量模板 cp .env.example .env.production # 编辑环境变量文件（vim编辑器） vim .env.production
按i进入vim编辑模式，修改核心配置（其余保持默认），示例如下：

运行环境：生产环境设为production NODE_ENV=production # 自定义端口（可选，默认18789） GATEWAY_PORT=18789 # 大模型API Key（替换为自己的） BOT_TOKEN=你的Kimi/MiniMax API Key # 数据库密码（必须替换为强密码，≥16位） DB_PASSWORD=YourStrongPassword123! # 日志配置：info为普通日志，debug为调试日志 LOG_LEVEL=info
按Esc +:wq保存并退出vim，加固环境变量文件权限：

chmod 600 .env.production
构建Docker镜像并启动服务（后台运行，耐心等待5-10分钟，取决于服务器配置）：

docker compose up -d --build
查看容器状态：运行以下命令，若所有容器状态均为Up，说明构建并启动成功：

docker compose ps

3.3 步骤3：端口放行与验证

端口放行：腾讯云轻量/ECS需手动放行自定义端口（默认18789）：
1. 进入服务器实例详情页 → 左侧防火墙/安全组 → 添加规则；
2. 配置：端口范围18789/18789 ，授权对象**[0.0.0.0/0](0.0.0.0/0)** （若需限制访问，改为个人IP），备注ClawdBot，点击确认；
部署验证：浏览器访问http://服务器公网IP:18789，能打开ClawdBot Web界面即部署成功。

四、腾讯云专属避坑指南（实测8大高频问题，新手必看）

聚焦腾讯云部署ClawdBot的专属问题，针对性解决，避免重复部署，所有解决方案均经实测有效：

问题1：部署后无法访问Web UI，提示「连接超时」

解决方案：① 确认服务器公网IP输入正确，未遗漏端口18789；② 检查ClawdBot后台状态，运行clawdbot daemon status确保active；③ 重启服务器后重新配置后台进程。

问题2 ：输入clawdbot onboard提示「command not found」

解决方案：腾讯云镜像未完全加载，重启服务器后重新用OrcaTerm登录，再执行初始化命令。

问题3 ：配置后台运行后，status显示「inactive (dead)」

解决方案：重新运行后台配置命令，若仍失败，执行clawdbot daemon uninstall后重新安装，再启动。

问题4：模型调用失败，提示「无效API Key」

解决方案：① 核对API Key是否复制完整，无多余空格；② 确认API Key与模型提供商一致（如Kimi的Key不能用于MiniMax）；③ 前往模型平台重置API Key后重新配置。

问题5：GitHub克隆源码失败（Docker方案）

解决方案：国内节点替换为GitHub加速镜像 ，克隆命令改为git clone https://github.com.cnpmjs.org/clawdbot/clawdbot.git。

问题6：Telegram/WhatsApp无法连接ClawdBot

解决方案：① 确认服务器地域为海外节点 （国内节点被网络限制）；② 重新运行clawdbot onboard，核对Bot Token配置是否正确；③ 检查腾讯云防火墙是否放行所有出站端口。

问题7：服务器运行卡顿、ClawdBot无响应

解决方案：① 升级服务器配置至2核4G；② 关闭无关进程，运行ps aux | grep clawdbot杀死多余ClawdBot进程；③ 重启ClawdBot，clawdbot daemon restart。

问题8：忘记服务器登录密码，无法登录

解决方案：在腾讯云轻量控制台，找到对应实例 → 右上角更多 → 重置密码 → 重启实例后，用新密码登录。

五、腾讯云部署进阶优化（安全+性能，必做）

部署完成后，针对腾讯云平台做专属优化，提升ClawdBot的安全性 和稳定性，适配长期使用。

5.1 安全加固（避免非法访问，重点）

修改默认端口 ：避免18789端口被扫描，运行clawdbot config set gateway.port 自定义端口（如28789），并在腾讯云防火墙中放行该自定义端口；
限制IP访问 ：将防火墙中授权对象从0.0.0.0/0改为个人公网IP（百度搜索「IP查询」获取），仅允许自己访问ClawdBot；
定期重置密码：每月重置一次服务器登录密码和ClawdBot数据库密码，提升安全性。

5.2 性能优化（提升响应速度，避免卡顿）

升级服务器配置 ：若使用多渠道/复杂任务，将服务器升级至4核8G，腾讯云控制台直接一键升级，无需重装；
重启ClawdBot ：每周重启一次ClawdBot，释放内存，clawdbot daemon restart；
清理日志 ：运行rm -rf /var/log/clawdbot/*.log，清理ClawdBot日志，避免占用过多磁盘空间。

5.3 腾讯云海外节点专属优化

若选择新加坡/硅谷等海外节点，解决网络延迟问题：

复制代码

# 配置腾讯云海外节点DNS，提升网络速度 echo "nameserver 8.8.8.8" >> /etc/resolv.conf echo "nameserver 1.1.1.1" >> /etc/resolv.conf # 重启网络服务 systemctl restart systemd-resolved

六、总结

腾讯云是ClawdBot部署的最优平台之一 ，轻量应用服务器预置镜像 实现真正的一键部署，零基础新手10分钟即可完成，无需任何代码基础；Docker源码构建方案满足开发者自定义配置需求，适配生产环境。

本次教程基于最新ClawdBot版本，所有命令、步骤均经腾讯云实测可复用，配套专属避坑指南和优化方案，确保部署后能7×24小时稳定运行。ClawdBot部署在腾讯云后，可作为你的云端私人AI助理，实现远程指令执行、代码开发、办公辅助等多种功能，大幅提升效率。

核心资源获取（2026年1月最新）

ClawdBot官方仓库：https://github.com/clawdbot/clawdbot
Kimi/MiniMax API Key获取：https://platform.moonshot.cn、https://platform.minimax.io

如果在腾讯云部署过程中遇到其他问题，欢迎在评论区留言交流；若本文对你有帮助，记得点赞+收藏+关注，后续会持续更新ClawdBot的进阶使用教程（多模型切换、自定义插件开发）！