本文为2026年最新Clawdbot安装部署使用全攻略，涵盖阿里云一键部署（新手首选）、ECS手动部署（技术用户）、本地部署（Windows/Mac/Linux）、Docker容器部署、OpenClaw汉化版部署五种主流方案，详细拆解从环境准备、部署实施、初始化配置到基础使用、高级拓展、常见问题排查的全流程，命令可直接复制执行，步骤清晰可落地，适用于新手入门、技术进阶等不同需求人群，助力快速搭建属于自己的自托管AI助手。

Clawdbot（现也称为Moltbot，第三方汉化版名为OpenClaw）是一款开源自托管AI助手平台，由PSPDFKit创始人Peter Steinberger创建，核心定位是“24小时在线的个人数字助理”。与ChatGPT、Siri等商业助手不同，Clawdbot最大的优势在于完全自托管（所有数据保留在个人基础设施中）、隐私保护（对话、记忆和集成都存储在本地）、开源免费（基于MIT许可证），同时支持多平台通信对接、50+工具集成和多种AI模型调用，可满足个人与小型团队的智能辅助需求，广泛应用于自动化任务处理、日程管理、邮件处理、多渠道对话交互等场景。

第一章 前言：了解Clawdbot核心信息

1.1 Clawdbot核心特性（2026最新版）

2026年Clawdbot（Moltbot）已更新至v2026.1.25版本，在兼容性、功能丰富度和部署便捷性上均有大幅提升，核心特性如下，帮助用户快速判断是否符合自身需求：

• 隐私与控制优势：完全自托管架构，所有对话数据、用户记忆、集成配置均存储在本地或个人服务器中，无需担心数据泄露；支持本地AI模型部署，脱离公网API也可正常使用，进一步强化隐私保护。

• 多AI模型兼容：原生支持Anthropic Claude（推荐Claude 3.5 Sonnet）、OpenAI GPT-4/GPT-3.5，同时兼容所有支持OpenAI API格式的第三方模型；可灵活切换模型提供商，按需选择性能与成本平衡的方案，也支持阿里云百炼大模型（国内用户首选，无需跨境网络）。

• 多通信通道集成：原生支持WhatsApp（无需Business API）、Telegram、Slack、Discord等主流聊天工具，国内用户可适配钉钉、企业微信（需简单配置），后续可通过常用聊天软件发送指令、接收响应，实现24小时随时交互。

• 丰富工具集成：内置50+种工具集成能力，涵盖日程管理（Google Calendar、Apple Calendar）、邮件管理（Gmail、Outlook、IMAP）、任务管理（Todoist、Apple Reminders）、笔记文档（Notion、Obsidian）、智能家居（Philips Hue、HomeKit）、媒体控制（Spotify、Apple Music）等场景，一站式满足日常办公与生活需求。

• 高级自动化能力：支持定时任务（Cron Jobs）、拖拽式自动化流程（Workflows），可组合“模型+工具+数据”实现个性化自动化场景，例如“每天早上8点推送日程提醒+检查未读邮件”“监控文件夹新增文件并自动备份至OSS”等。

• 多部署方式支持：适配阿里云轻量应用服务器一键部署（新手友好）、ECS实例手动部署、本地电脑部署（Windows/Mac/Linux）、Docker容器部署（服务器首选），同时有第三方汉化版OpenClaw，CLI与Web界面全中文适配，降低国内用户使用门槛。

• 低配置门槛：最低仅需2GB内存、2核CPU、40GB存储即可运行，个人电脑、轻量服务器均可部署，无需高额硬件成本；支持开机自启、后台运行，部署后无需持续手动维护。

1.2 教程适用人群与环境说明

1.2.1 适用人群

• 新手用户：无专业技术基础，想快速搭建个人AI助手，优先选择“阿里云轻量应用服务器一键部署”或“OpenClaw汉化版一键脚本部署”。

• 技术用户：有Linux基础、熟悉命令行操作，想自定义配置、灵活调整部署环境，可选择“ECS实例手动部署”“Docker部署”或“本地部署”。

• 国内用户：优先选择阿里云百炼大模型+阿里云服务器部署，无需跨境网络，访问速度更快、稳定性更高；也可选择OpenClaw汉化版，适配中文使用习惯。

• 隐私敏感用户：选择本地部署或自购服务器部署，搭配本地AI模型，实现完全离线使用，确保数据安全。

1.2.2 环境兼容性说明（2026最新）

Clawdbot对硬件和软件环境有明确要求，部署前需确认环境符合以下条件，避免后续操作报错：

部署类型	硬件要求（最低）	软件要求	网络要求
阿里云轻量应用服务器	CPU≥2核、内存≥2GiB、存储≥40GB（SSD优先）、带宽≥2Mbps	阿里云Moltbot专属镜像（v2026.1.25）	国内节点（华东1/华北2）或跨境节点（中国香港、新加坡），无需本地网络配置
ECS实例/自购服务器	CPU≥2核、内存≥2GiB、存储≥40GB（SSD优先）	Linux（Ubuntu 20.04+/CentOS 8+）、Node.js≥22.0.0、Docker（可选）	稳定公网连接，放行80、18789端口
Windows本地部署	CPU≥2核、内存≥4GiB、存储≥50GB	Windows 10/11、WSL2（Ubuntu子系统）、Node.js≥22.0.0	稳定互联网连接（用于下载依赖、调用AI API）
Mac本地部署	CPU≥2核、内存≥4GiB、存储≥50GB	macOS 11+、Node.js≥22.0.0、Homebrew（可选）	稳定互联网连接
Linux本地部署	CPU≥2核、内存≥4GiB、存储≥50GB	Ubuntu 20.04+/CentOS 8+、Node.js≥22.0.0	稳定互联网连接
Docker部署	CPU≥2核、内存≥2GiB、存储≥40GB	Docker≥20.10.0、Docker Compose（可选）	稳定互联网连接（用于拉取镜像）

1.3 前置说明与注意事项

• 版本说明：本文以Clawdbot（Moltbot）v2026.1.25官方版本、OpenClaw汉化版（nightly稳定版）为核心，所有步骤均经过实测验证，可直接复用；若后续版本更新，核心步骤不变，仅需适配版本号调整命令。

• 命令规范：所有命令均标注适用环境（Linux/Mac/Windows PowerShell），复制时需去掉多余空格，确保命令完整；若执行报错，优先检查命令拼写、环境版本是否符合要求。

• 密钥安全：API Key（阿里云百炼、Anthropic、OpenAI）、访问Token、服务器密码等敏感信息，需妥善保存，切勿泄露，否则可能导致AI额度被盗用、服务器被入侵。

• 端口安全：部署时需放行80（网页访问）、18789（Clawdbot默认通信端口），无需放行多余端口，避免安全风险；若服务器有防火墙，需提前配置规则放行对应端口。

• 汉化版说明：OpenClaw是Clawdbot（Moltbot）的第三方开源汉化版，CLI与Web界面全中文适配，每小时自动同步官方最新代码，适合不熟悉英文的国内用户，部署步骤与官方版基本一致，本文单独拆解其部署流程。

• 成本说明：Clawdbot软件本身开源免费（MIT许可证）；服务器成本根据部署载体而定（本地部署无服务器成本，阿里云轻量应用服务器月付约几十元）；AI API使用需支付少量费用（阿里云百炼、Claude、OpenAI均有免费额度，后续按使用量计费，月成本约5-30美元，取决于使用频率）。

第二章 部署前准备：必备资源与工具

无论选择哪种部署方案，都需提前准备好以下核心资源与工具，避免部署过程中频繁中断，提高效率；不同部署方案的额外准备的资源，将在对应章节单独说明。

2.1 必备核心资源

2.1.1 AI API Key（核心凭证）

Clawdbot的核心功能依赖AI模型调用，需提前获取对应平台的API Key，国内用户优先推荐阿里云百炼（无需跨境网络），国外用户可选择Anthropic Claude或OpenAI，以下是三种主流平台的API Key创建步骤，按需选择：

方案1：阿里云百炼API Key（国内用户首选）

阿里云百炼是国内成熟的大模型服务平台，兼容性好、访问速度快，支持Clawdbot一键配置，步骤如下：

1. 注册并登录阿里云账号：访问阿里云官网（https://www.aliyun.com/），注册账号并完成实名认证（个人用户可通过身份证刷脸、支付宝授权认证，企业用户需上传营业执照，审核1-3个工作日）；未完成实名认证无法开通百炼服务和购买服务器。

2. 进入阿里云百炼平台：访问阿里云百炼大模型服务平台（https://bailian.aliyun.com/），登录已实名认证的账号。

3. 创建API Key：在平台导航栏中找到“密钥管理”（推荐选择华北2（北京）地域），点击“创建API-Key”，系统将自动生成一组API Key（包含Access Key ID与Access Key Secret）。

4. 保存API Key：点击“复制”按钮，将生成的Access Key ID与Access Key Secret保存至本地记事本（或其他安全位置），切勿泄露，后续部署时需使用；若之前创建过API Key，可直接使用现有密钥，无需重复创建。

5. 查看免费额度：阿里云百炼提供一定额度的免费调用资源，登录后可在“控制台→额度管理”中查看，免费额度耗尽后，需按使用量计费，可根据自身需求充值。

方案2：Anthropic Claude API Key（国外用户推荐）

1. 访问Anthropic Console：打开Anthropic官网控制台（https://console.anthropic.com/），注册并登录账号（需境外手机号验证）。

2. 进入API Keys页面：登录后，在左侧导航栏中找到“API Keys”，点击进入。

3. 创建并保存密钥：点击“Create Key”，输入密钥名称（自定义，如“Clawdbot使用”），点击“Create”生成密钥，密钥格式为“sk-ant-...”，复制并保存至本地，切勿泄露。

4. 查看计费标准：Claude API按Token计费，约0.003美元/1K输入Token，0.015美元/1K输出Token，新用户注册有少量免费额度，后续按使用量计费。

方案3：OpenAI API Key（备选）

1. 访问OpenAI Platform：打开OpenAI平台（https://platform.openai.com/），注册并登录账号（需境外手机号验证）。

2. 进入API Keys页面：登录后，点击右上角个人头像，选择“View API keys”，进入密钥管理页面。

3. 创建并保存密钥：点击“Create new secret key”，输入密钥名称（自定义），点击“Create secret key”生成密钥，复制并保存至本地，密钥仅显示一次，刷新页面后将无法再次查看，需妥善保存。

4. 注意事项：OpenAI API需跨境网络才能调用，国内用户若无跨境网络，不推荐选择；新用户注册有少量免费额度，后续按使用量计费。

2.1.2 服务器资源（按需准备）

若选择阿里云部署（一键部署/ECS手动部署），需提前准备阿里云账号（已完成实名认证）；若选择自购服务器，需确保服务器符合硬件要求，且已安装对应操作系统（Linux优先）；若选择本地部署，无需额外准备服务器，使用个人电脑即可。

2.1.3 通信通道凭证（可选）

若需通过WhatsApp、Telegram、钉钉等聊天工具与Clawdbot交互，需提前准备对应工具的账号与授权凭证，后续配置时使用：

• Telegram：需准备Telegram账号，创建Bot并获取Bot Token（后续章节详细说明）。

• WhatsApp：需准备WhatsApp账号，无需Business API，后续通过Clawdbot初始化向导完成绑定。

• 钉钉：需准备钉钉账号，创建企业应用并获取APP Key、APP Secret（国内用户适配）。

2.2 必备工具准备

根据部署方案，需提前安装对应操作工具，确保后续命令执行、远程连接正常：

2.2.1 远程连接工具（服务器部署必备）

若选择阿里云ECS、自购服务器部署，需使用SSH工具远程连接服务器，推荐以下工具，按需选择：

• Windows用户：Xshell、FinalShell（免费）、PowerShell（系统自带，无需额外安装），推荐FinalShell，界面友好、操作简单，支持文件传输。

• Mac/Linux用户：终端（系统自带）、iTerm2（Mac推荐，可增强终端功能），无需额外安装，直接使用即可。

• 阿里云自带工具：阿里云轻量应用服务器、ECS实例均提供Web版Workbench，无需安装本地工具，登录阿里云控制台即可直接远程连接服务器。

2.2.2 基础操作工具

• 记事本/文本编辑器：用于保存API Key、访问Token、服务器密码等敏感信息，推荐Notepad++（Windows）、TextEdit（Mac）、VS Code（全平台）。

• 浏览器：用于访问Clawdbot Web界面、阿里云控制台、AI平台等，推荐Chrome、Edge、Firefox，确保浏览器版本更新至最新。

• 文件传输工具（可选）：若需向服务器上传文件（如配置文件、本地模型），推荐FileZilla（全平台免费）、FinalShell（自带文件传输功能）。

2.3 环境检查工具（本地/手动部署必备）

若选择本地部署、ECS手动部署或Docker部署，需提前检查并安装Node.js、Docker等核心软件，以下是检查与安装方法：

2.3.1 Node.js检查与安装（核心依赖）

Clawdbot（Moltbot）严格要求Node.js版本≥22.0.0，低于该版本将导致部署失败，需提前检查并升级，不同系统的操作方法如下：

方法1：检查现有Node.js版本

打开终端（Mac/Linux）或PowerShell（Windows），执行以下命令，查看当前Node.js版本：

node -v npm -v

若输出结果中Node.js版本≥22.0.0（如v22.12.0），且npm版本≥10.0.0，说明环境符合要求，无需升级；若版本低于22.0.0，需按以下方法升级。

方法2：通过nvm安装/升级Node.js（推荐，全平台适配）

nvm（Node Version Manager）是Node.js版本管理工具，可快速安装、切换不同版本的Node.js，避免版本冲突，步骤如下：

Linux/Mac系统

1. 安装nvm：执行以下命令，下载并安装nvm（版本为v0.39.0，可根据官网更新）：

2. 生效nvm配置：执行以下命令，使nvm立即生效（无需重启终端）：

3. 安装Node.js 22：执行以下命令，安装Node.js 22版本（最新稳定版）：

4. 验证安装：执行node -v和npm -v，确认版本符合要求（Node.js≥22.0.0）。

Windows系统

Windows系统需使用nvm-windows（nvm的Windows版本），步骤如下：

1. 下载nvm-windows：访问nvm-windows官网（https://github.com/coreybutler/nvm-windows），下载最新版本的安装包（如nvm-setup.exe）。

2. 安装nvm-windows：双击安装包，按照提示完成安装，注意选择安装路径（建议默认路径），安装过程中会自动检测并卸载已安装的Node.js（若有）。

3. 打开PowerShell（管理员模式），执行以下命令，安装Node.js 22：

4. 验证安装：执行node -v和npm -v，确认版本符合要求。

方法3：直接安装Node.js（备选）

若不想使用nvm，可直接从Node.js官网下载对应版本安装：

1. 访问Node.js官网（https://nodejs.org/），下载LTS版本（推荐，稳定性更高），确保版本≥22.0.0。

2. 双击安装包，按照提示完成安装（Windows系统需勾选“Add to PATH”，确保命令可全局执行）。

3. 验证安装：执行node -v和npm -v，确认版本符合要求。

2.3.2 Docker检查与安装（可选）

若选择Docker部署，需提前安装Docker，确保版本≥20.10.0，不同系统的安装方法如下：

Linux系统（Ubuntu/CentOS）

1. 卸载旧版本（若有）：执行以下命令，卸载旧版本Docker（若未安装，可跳过）：

2. 安装依赖包：执行以下命令，安装Docker所需依赖：

3. 安装Docker：执行官方安装脚本，快速安装最新版本Docker：

4. 启动Docker并设置开机自启：

5. 验证安装：执行以下命令，若输出Docker版本信息，说明安装成功：

Mac系统

1. 访问Docker官网（https://www.docker.com/products/docker-desktop/），下载Mac版Docker Desktop安装包。

2. 双击安装包，将Docker拖入应用程序文件夹，完成安装。

3. 打开Docker Desktop，等待启动完成（启动后菜单栏会显示Docker图标）。

4. 验证安装：打开终端，执行docker --version，确认版本符合要求。

Windows系统

1. 访问Docker官网，下载Windows版Docker Desktop安装包（需Windows 10专业版/企业版，且已启用WSL2）。

2. 双击安装包，按照提示完成安装，安装过程中勾选“Use WSL 2 instead of Hyper-V”（需提前启用WSL2）。

3. 安装完成后，启动Docker Desktop，等待启动完成。

4. 验证安装：打开PowerShell，执行docker --version，确认版本符合要求。

第三章 核心部署方案（按难度从低到高）

本章将详细拆解五种主流部署方案，从新手友好的“阿里云一键部署”开始，逐步过渡到技术用户适用的“手动部署”“Docker部署”，每种方案均包含完整步骤、验证方法和注意事项，用户可根据自身技术水平和需求选择对应方案。

方案一：阿里云轻量应用服务器一键部署（新手首选）

该方案是2026年阿里云推出的Clawdbot（Moltbot）专属部署方案，预装应用镜像，无需手动配置环境、安装依赖，全程一键操作，新手可在5分钟内完成部署，适合无技术基础的用户，核心优势是简单、快捷、稳定，无需担心环境冲突。

3.1.1 部署前额外准备

• 阿里云账号（已完成实名认证）。

• 阿里云百炼API Key（已提前创建，详见第二章2.1.1）。

• 浏览器（推荐Chrome、Edge），用于访问阿里云控制台。

3.1.2 具体部署步骤

步骤1：进入阿里云Clawdbot专属部署页面

1. 打开浏览器，访问阿里云Clawdbot专属部署页面（https://www.aliyun.com/activity/ecs/clawdbot），该页面已默认配置好Clawdbot镜像，无需手动搜索。

2. 若页面加载失败，可通过阿里云官网进入：登录阿里云官网（https://www.aliyun.com/），依次点击“产品→弹性计算→轻量应用服务器”，进入轻量应用服务器购买页面，后续步骤一致。

3. 登录阿里云账号：点击页面右上角“登录”，输入阿里云账号密码（或扫码登录），确保账号已完成实名认证。

步骤2：配置服务器参数并购买

1. 点击页面显著位置的“一键购买并部署”按钮，进入实例配置页面，开始配置服务器参数。

2. 镜像选择：在“镜像类型”中切换至“应用镜像”，在下拉列表中找到“Moltbot（原Clawdbot）”镜像，确认选中（2026年默认版本为v2026.1.25），镜像选中后不可更改，若已购买服务器需通过“重置系统”方式重新选择。

3. 地域选择：

   1. 国内用户：优先选择华东1（杭州）、华北2（北京）节点，访问延迟低，稳定性高；若需绑定域名，后续需完成ICP备案。

   2. 跨境用户：选择中国香港、新加坡节点，无需ICP备案即可上线，适合需要通过Telegram、WhatsApp交互的用户。

4. 实例规格：默认配置为2vCPU+2GiB内存+40GiB ESSD系统盘+200Mbps峰值带宽+1个IPv4地址，无固定流量限制，满足Clawdbot基础使用需求；若需运行复杂自动化任务、部署本地模型，可升级至4vCPU+4GiB配置，点击“升级配置”即可调整。

5. 购买时长：根据自身需求选择月付、季付或年付，时长越长越便于Clawdbot 24小时稳定运行，避免频繁续费导致服务中断；新手可先选择月付，测试无误后再续期。

6. 确认订单并支付：核对配置参数、地域、价格无误后，勾选“我已阅读并同意《轻量应用服务器服务条款》”，点击“立即支付”，选择支付方式（支付宝、微信、银行卡等），完成付款。

步骤3：等待实例创建与镜像部署

1. 支付完成后，系统自动跳转至轻量应用服务器控制台，或通过“阿里云官网→控制台→轻量应用服务器”路径进入管理页面。

2. 在实例列表中找到刚创建的Moltbot实例，实例状态初始为“创建中”，需等待1-3分钟（取决于网络速度），直至状态变为“运行中”，说明服务器实例创建成功，且Moltbot镜像已自动部署完成。

3. 记录核心信息：实例状态变为“运行中”后，点击实例名称，进入“实例详情”页面，记录以下信息（后续配置需使用）：

   1. 公网IP地址：用于后续访问Clawdbot Web界面、配置服务。

   2. 默认登录账号：root（Linux系统默认管理员账号）。

   3. 默认登录密码：可在“实例详情→密码/密钥”页面查看（若未设置，可点击“重置密码”设置新密码，重置后需重启实例生效）。

步骤4：核心配置（API Key+端口放行）

这一步是部署核心，需完成阿里云百炼API Key配置、服务器端口放行，确保Moltbot能正常调用大模型，并允许外部设备访问，步骤如下：

1. 端口放行：

   1. 在“实例详情”页面左侧导航栏中找到“应用详情”，点击进入，页面中会显示Moltbot的默认配置信息。

   2. 找到“防火墙一键放行应用端口”选项，Moltbot默认通信端口为18789，Web访问端口为80，点击“一键放通”，系统自动配置安全组规则，允许外部设备通过这两个端口访问服务器。

   3. 手动放行（若一键放通失败）：若点击“一键放通”后提示失败，可手动配置防火墙规则：

      • 在“实例详情”左侧导航栏中找到“安全防护→防火墙”，点击进入。

      • 点击“添加规则”，依次配置两个端口：

        1. 端口1：协议选择TCP，端口范围填写80，授权对象填写0.0.0.0/0（允许所有IP访问），备注“Clawdbot Web访问端口”，点击“确定”。

        2. 端口2：协议选择TCP，端口范围填写18789，授权对象填写0.0.0.0/0，备注“Clawdbot通信端口”，点击“确定”。

2. 配置阿里云百炼API Key：

   1. 在“应用详情”页面找到“配置百炼API-Key”模块，点击“一键配置”按钮，弹出API Key输入框。

   2. 打开之前保存的阿里云百炼API Key（Access Key ID与Access Key Secret），依次粘贴至对应输入框，确认无输入错误（注意区分大小写，不可多输、少输空格）。

   3. 点击“执行命令”，系统自动将API Key写入Moltbot配置文件，完成大模型调用授权，执行成功后会提示“配置完成”。

3. 生成访问Token：

   1. API Key配置完成后，在“应用详情”页面继续找到“生成token执行命令”选项，点击“执行命令”。

   2. 系统会自动生成一串唯一的访问Token（由字母、数字与特殊符号组成），点击“复制”按钮，将Token保存至本地记事本，后续登录Clawdbot Web界面需使用，切勿泄露。

步骤5：服务启动与部署验证

1. 启动服务：API Key与Token配置完成后，系统会自动启动Moltbot服务；若服务未自动启动，可通过以下方式重启服务：

   1. Web控制台方式：在“应用详情”页面找到“重启应用”按钮，点击即可重启服务，等待1分钟左右完成重启。

   2. 命令行方式：通过远程连接工具（如FinalShell）登录服务器，执行以下命令重启服务：

2. 部署验证（关键步骤）：

   1. 打开浏览器，在地址栏中输入“http://服务器公网IP”（无需加端口，默认使用80端口），按下回车键。

   2. 页面会跳转至Clawdbot（Moltbot）登录界面，提示输入访问Token，将之前保存的Token粘贴至输入框，点击“登录”。

   3. 若能成功进入Moltbot Web对话界面（左侧为功能菜单，中间为对话窗口），说明部署成功；若无法访问，需检查端口放行是否正确、服务是否启动、Token是否输入正确。

3.1.3 部署后初始化向导

首次登录Clawdbot Web界面后，系统会弹出初始化向导，引导完成基础配置，步骤如下，按需配置即可：

1. 欢迎页面：点击“Next”进入下一步，无需额外操作。

2. 通信通道选择：

   1. 若需通过Telegram、WhatsApp等聊天工具交互，选择对应通道，按照提示完成绑定（后续章节详细说明）。

   2. 若暂时不需要绑定，可点击“Skip for now”跳过，后续可在后台配置页面重新绑定。

3. 基础技能启用：系统会列出常用基础技能（如对话交互、日程管理、邮件提醒），勾选需要启用的技能，点击“Next”；也可全部勾选，后续可在“Skills”模块调整。

4. 个人偏好设置：设置语言（默认英文，可后续在汉化版中调整为中文）、时间 zone（选择对应时区，如Asia/Shanghai），点击“Finish”，完成初始化配置。

初始化完成后，即可进入Clawdbot Web主界面，开始使用核心功能。

3.1.4 注意事项

• 服务器实例创建后，建议立即重置默认密码，设置复杂度较高的密码（字母+数字+特殊符号），避免服务器被入侵。

• API Key与访问Token需妥善保存，若不慎泄露，需立即在对应平台（阿里云百炼）注销旧密钥，重新创建新密钥，并更新Clawdbot配置。

• 若选择国内地域服务器，后续需绑定域名，需完成ICP备案，否则无法通过域名访问；若无需绑定域名，直接使用公网IP访问即可。

• 阿里云轻量应用服务器默认有流量限制（不同套餐限制不同），需注意监控流量使用情况，避免流量耗尽导致服务中断。

方案二：阿里云ECS实例手动部署（技术用户）

该方案适合有Linux基础、熟悉命令行操作的技术用户，可自定义配置环境、调整服务参数，灵活性更高，适合需要个性化部署、集成自定义工具的场景；核心是手动安装依赖、部署Clawdbot服务，步骤比一键部署复杂，但可控性更强。

3.2.1 部署前额外准备

• 阿里云账号（已完成实名认证），并购买ECS实例（符合硬件要求：2核2GiB以上、SSD存储、带宽≥2Mbps）。

• ECS实例操作系统：Ubuntu 20.04+/CentOS 8+（推荐Ubuntu 22.04，兼容性更好）。

• AI API Key（阿里云百炼/Claude/OpenAI，按需选择）。

• 远程连接工具（FinalShell/Xshell/终端），用于登录ECS实例执行命令。

3.2.2 具体部署步骤

步骤1：登录阿里云ECS实例

1. 获取ECS实例信息：登录阿里云控制台，进入“产品→弹性计算→云服务器ECS”，在实例列表中找到目标ECS实例，记录实例的公网IP地址、默认登录账号（root）、登录密码（或密钥）。

2. 远程连接实例：

   1. Windows用户：打开FinalShell，点击“新建连接→SSH连接”，输入公网IP、登录账号（root）、密码，点击“确定”，连接成功后将进入Linux终端界面。

   2. Mac/Linux用户：打开终端，执行以下命令，输入密码后登录（密码输入时不显示，直接输入即可）：

   3. 阿里云Web连接：在ECS实例详情页面，点击“远程连接→Workbench远程连接”，输入账号密码，即可直接登录终端，无需安装本地工具。

3. 更新系统依赖：登录成功后，执行以下命令，更新系统软件包，确保环境兼容（Ubuntu/CentOS命令不同，按需选择）：

步骤2：安装核心依赖组件

Clawdbot依赖Node.js、Git（用于下载源码），可选Docker（容器化部署），需手动安装，步骤如下：

2.1 安装Node.js（≥22.0.0）

参考第二章2.3.1节，通过nvm方式安装Node.js（ECS实例推荐此方式，便于后续版本切换），具体命令如下（适配Linux系统，Ubuntu/CentOS通用）：

1. 安装nvm：执行以下命令，下载并安装nvm（v0.39.0稳定版）：

2. 生效nvm配置：执行以下命令，使nvm立即生效（无需重启终端）：

3. 安装并切换Node.js 22版本：执行以下命令，安装最新稳定版Node.js 22，并设置为默认版本，避免后续使用时版本切换异常：

4. 验证安装：执行以下命令，确认Node.js和npm版本符合要求，若输出Node.js版本≥22.0.0（如v22.12.0）、npm版本≥10.0.0，即为安装成功：

注意：若执行curl命令报错“curl: command not found”，说明ECS实例未安装curl工具，需先执行对应命令安装：Ubuntu系统执行sudo apt install curl -y，CentOS系统执行sudo yum install curl -y，安装完成后再重新执行nvm安装命令。

2.2 安装Git（源码下载必备）

Clawdbot源码托管在GitHub，需通过Git工具下载，ECS实例默认未安装Git，需手动安装，步骤如下（区分Ubuntu和CentOS系统）：

1. 安装Git： Ubuntu系统（推荐）：执行以下命令，更新软件源并安装Git：

2. CentOS系统：执行以下命令，安装Git：

3. 验证安装：执行以下命令，若输出Git版本信息（如git version 2.34.1），即为安装成功：

2.3 安装可选依赖（Docker相关，按需安装）

若后续计划采用“Docker容器化部署Clawdbot”（ECS实例推荐，便于环境隔离和后续维护），可参考第二章2.3.2节，在ECS实例上安装Docker及Docker Compose；若仅需手动部署，可跳过此步骤。

简化安装Docker命令（适配ECS Linux实例，Ubuntu/CentOS通用）：

1. 执行官方一键安装脚本：

2. 启动Docker并设置开机自启，避免ECS重启后Docker服务失效：

3. 验证Docker安装：执行docker --version和docker run hello-world，若能正常输出hello-world测试信息，即为安装成功。

步骤3：下载Clawdbot（Moltbot）源码

依赖安装完成后，通过Git下载Clawdbot官方源码，建议将源码放在/root目录下（便于后续管理，也可自定义路径），步骤如下：

1. 进入目标目录（以/root为例）：

2. 克隆Clawdbot官方GitHub仓库（2026年最新源码地址，实测可访问）：

3. 等待源码下载完成，下载速度取决于ECS实例带宽，一般1-5分钟即可完成；若下载报错“fatal: unable to access 'https://github.com/...'”，可检查ECS实例网络连接，或更换GitHub镜像地址重新克隆：

4. 进入源码目录，确认源码结构：

步骤4：配置Clawdbot核心参数

源码下载完成后，需修改配置文件，填写AI API Key、设置端口、配置访问权限等，确保Clawdbot能正常启动，步骤如下：

1. 复制默认配置文件，生成自定义配置文件（避免直接修改默认文件，便于后续版本更新）：

2. 编辑配置文件（使用vim编辑器，ECS实例默认自带，若未安装可执行sudo apt install vim -y/Ubuntu 或 sudo yum install vim -y/CentOS）：

3. 修改核心配置项（按i键进入编辑模式，修改完成后按Esc键，输入:wq保存并退出）：配置AI模型与API Key（国内用户优先配置阿里云百炼，国外用户配置Claude/OpenAI）： - 阿里云百炼配置：找到aiProviders下的aliyunBailian，填写accessKeyId和accessKeySecret（前文保存的阿里云百炼API Key），并将default设置为'aliyunBailian'。 - Claude配置：找到anthropic，填写apiKey（Claude API Key），将default设置为'anthropic'。 - OpenAI配置：找到openai，填写apiKey（OpenAI API Key），将default设置为'openai'。

4. 配置端口（默认18789，可自定义，需与后续ECS防火墙放行端口一致）：找到server下的port，保持默认18789即可，无需修改。

5. 配置访问Token（登录Clawdbot Web界面必备）：找到auth下的token，自定义设置一串复杂字符（如字母+数字+特殊符号，建议不少于16位），或后续通过命令自动生成，记录此Token，后续登录需使用。

6. 验证配置文件（可选）：执行以下命令，若无报错，说明配置文件格式正确：

步骤5：安装Clawdbot依赖包并启动服务

配置完成后，进入Clawdbot源码目录，安装项目依赖包，启动服务并设置开机自启，确保ECS重启后Clawdbot能自动运行，步骤如下：

1. 进入源码目录（若已退出，重新执行）：

2. 安装项目依赖包（使用npm安装，依赖包较多，耐心等待1-3分钟）：

3. 启动Clawdbot服务（测试启动，确认无报错）：

4. 设置后台运行与开机自启（关键步骤，避免关闭终端后服务停止）： 安装pm2（Node.js进程管理工具，用于后台运行Clawdbot）：

5. 使用pm2启动Clawdbot，并设置开机自启：

6. 验证pm2启动状态：执行pm2 status，若clawdbot对应的status为“online”，即为启动成功。

步骤6：ECS防火墙端口放行（关键，避免无法访问）

与阿里云轻量应用服务器类似，ECS实例需放行Clawdbot的Web访问端口（80，若后续配置反向代理可使用）和通信端口（18789，默认），步骤如下：

1. 登录阿里云ECS控制台，进入目标实例详情页面，左侧导航栏找到“网络与安全→安全组”，点击进入安全组配置页面。

2. 点击“配置规则→入方向→添加规则”，依次添加两个端口规则： 规则1（通信端口）：协议类型选择“TCP”，端口范围填写“18789”，授权对象填写“0.0.0.0/0”（允许所有IP访问，也可根据需求限制指定IP），备注“Clawdbot通信端口”，点击“确定”。

3. 规则2（可选，Web访问端口）：协议类型选择“TCP”，端口范围填写“80”，授权对象填写“0.0.0.0/0”，备注“Clawdbot Web访问端口”，点击“确定”。

4. 验证端口放行：在ECS终端执行以下命令，确认端口已放行：

步骤7：部署验证（确认ECS手动部署成功）

完成端口放行后，即可通过以下步骤验证ECS手动部署是否成功，核心验证3个关键点：服务在线、端口可访问、AI模型可正常调用，步骤清晰可落地，便于快速排查问题：

1. 第一步：验证Clawdbot服务状态（确认服务未异常停止） 回到ECS远程终端（若已断开，重新远程连接），执行以下命令，查看pm2管理的Clawdbot服务状态：

2. 若输出结果中，名称为“clawdbot”的进程status为“online”，且cpu、memory有正常占用，说明服务运行正常；若为“errored”或“stopped”，需执行pm2 restart clawdbot重启服务，并检查之前的启动日志排查问题（执行pm2 logs clawdbot查看日志）。

3. 第二步：验证端口可访问（确认防火墙放行生效） 方式1：ECS终端本地验证（优先，排除外部网络干扰）：执行以下命令，测试18789端口是否正常监听：

4. 若输出包含“0.0.0.0:18789”或“:::18789”，说明端口已正常监听，防火墙放行生效；若无输出，需重新检查安全组规则配置，或重启防火墙（CentOS执行sudo systemctl restart firewalld，Ubuntu执行sudo ufw reload）。

5. 方式2：本地电脑验证（模拟外部访问）：打开本地电脑的终端（Mac/Linux）或PowerShell（Windows），执行以下命令，测试端口连通性：

6. 若telnet提示“Connected to ...”，或curl返回类似“Clawdbot Gateway”的页面内容，说明端口可正常访问；若提示“Connection refused”，需重新检查服务状态和安全组规则。

7. 第三步：验证Web界面访问与AI交互（核心验证，确认部署可用） 打开本地电脑浏览器（推荐Chrome、Edge），在地址栏输入“http://ECS实例公网IP:18789”（若配置了80端口反向代理，可直接输入ECS公网IP，无需加端口）。

8. 页面会跳转至Clawdbot（Moltbot）登录界面，提示输入“Access Token”，将步骤4中配置文件里设置的访问Token粘贴至输入框，点击“Login”（登录）。

9. 若能成功进入Clawdbot Web主界面（左侧为功能菜单，中间为对话窗口，右侧为工具列表），说明Web访问正常；此时可进行AI交互测试，在对话窗口输入简单指令（如“你好，测试连接”），点击发送。

10. 若能收到AI的正常回复（回复内容与输入指令对应，无报错提示），说明AI模型调用成功，ECS手动部署完全生效；若提示“AI provider error”，需检查API Key填写是否正确、ECS实例是否能正常访问AI平台（国内用户需确认阿里云百炼API Key有效，无需跨境网络）。

11. 异常补充说明：若上述步骤均验证失败，优先按以下顺序排查：① 服务是否正常运行（pm2 status）；② 安全组18789端口是否放行（检查阿里云控制台安全组规则）；③ API Key是否填写正确（重新编辑config.js确认）；④ Node.js版本是否≥22.0.0（node -v）。

验证完成后，Clawdbot已成功部署在阿里云ECS实例上，可正常使用Web界面交互，后续可根据需求配置通信通道（如Telegram、钉钉）、启用自动化工具等。

Clawdbot依赖Node.js、Git（用于下载源码），可选Docker（容器化部署），需手动安装，步骤如下：

2.1 安装Node.js（≥22.0.0）

参考第二章2.3.1节，通过nvm方式安装Node.js（ECS实例推荐此方式，便于后续版本切换），具体命令如下（适配Linux系统，Ubuntu/CentOS通用）：

1. 安装nvm：执行以下命令，下载并安装nvm（v0.39.0稳定版）：

2. 生效nvm配置：执行以下命令，使nvm立即生效（无需重启终端）：

3. 安装并切换Node.js 22版本：执行以下命令，安装最新稳定版Node.js 22，并设置为默认版本，避免后续使用时版本切换异常：

4. 验证安装：执行以下命令，确认Node.js和npm版本符合要求，若输出Node.js版本≥22.0.0（如v22.12.0）、npm版本≥10.0.0，即为安装成功：

注意：若执行curl命令报错“curl: command not found”，说明ECS实例未安装curl工具，需先执行对应命令安装：Ubuntu系统执行sudo apt install curl -y，CentOS系统执行sudo yum install curl -y，安装完成后再重新执行nvm安装命令。

2.2 安装Git（源码下载必备）

Clawdbot源码托管在GitHub，需通过Git工具下载，ECS实例默认未安装Git，需手动安装，步骤如下（区分Ubuntu和CentOS系统）：

1. 安装Git： Ubuntu系统（推荐）：执行以下命令，更新软件源并安装Git：

2. CentOS系统：执行以下命令，安装Git：

3. 验证安装：执行以下命令，若输出Git版本信息（如git version 2.34.1），即为安装成功：

2.3 安装可选依赖（Docker相关，按需安装）

若后续计划采用“Docker容器化部署Clawdbot”（ECS实例推荐，便于环境隔离和后续维护），可参考第二章2.3.2节，在ECS实例上安装Docker及Docker Compose；若仅需手动部署，可跳过此步骤。

简化安装Docker命令（适配ECS Linux实例，Ubuntu/CentOS通用）：

1. 执行官方一键安装脚本：

2. 启动Docker并设置开机自启，避免ECS重启后Docker服务失效：

3. 验证Docker安装：执行docker --version和docker run hello-world，若能正常输出hello-world测试信息，即为安装成功。

步骤3：下载Clawdbot（Moltbot）源码

依赖安装完成后，通过Git下载Clawdbot官方源码，建议将源码放在/root目录下（便于后续管理，也可自定义路径），步骤如下：

1. 进入目标目录（以/root为例）：

2. 克隆Clawdbot官方GitHub仓库（2026年最新源码地址，实测可访问）：

3. 等待源码下载完成，下载速度取决于ECS实例带宽，一般1-5分钟即可完成；若下载报错“fatal: unable to access 'https://github.com/...'”，可检查ECS实例网络连接，或更换GitHub镜像地址重新克隆：

4. 进入源码目录，确认源码结构：

步骤4：配置Clawdbot核心参数

源码下载完成后，需修改配置文件，填写AI API Key、设置端口、配置访问权限等，确保Clawdbot能正常启动，步骤如下：

1. 复制默认配置文件，生成自定义配置文件（避免直接修改默认文件，便于后续版本更新）：

2. 编辑配置文件（使用vim编辑器，ECS实例默认自带，若未安装可执行sudo apt install vim -y/Ubuntu 或 sudo yum install vim -y/CentOS）：

3. 修改核心配置项（按i键进入编辑模式，修改完成后按Esc键，输入:wq保存并退出）： 配置AI模型与API Key（国内用户优先配置阿里云百炼，国外用户配置Claude/OpenAI）： - 阿里云百炼配置：找到aiProviders下的aliyunBailian，填写accessKeyId和accessKeySecret（前文保存的阿里云百炼API Key），并将default设置为'aliyunBailian'。 - Claude配置：找到anthropic，填写apiKey（Claude API Key），将default设置为'anthropic'。 - OpenAI配置：找到openai，填写apiKey（OpenAI API Key），将default设置为'openai'。

4. 配置端口（默认18789，可自定义，需与后续ECS防火墙放行端口一致）：找到server下的port，保持默认18789即可，无需修改。

5. 配置访问Token（登录Clawdbot Web界面必备）：找到auth下的token，自定义设置一串复杂字符（如字母+数字+特殊符号，建议不少于16位），或后续通过命令自动生成，记录此Token，后续登录需使用。

6. 验证配置文件（可选）：执行以下命令，若无报错，说明配置文件格式正确：

步骤5：安装Clawdbot依赖包并启动服务

配置完成后，进入Clawdbot源码目录，安装项目依赖包，启动服务并设置开机自启，确保ECS重启后Clawdbot能自动运行，步骤如下：

1. 进入源码目录（若已退出，重新执行）：

2. 安装项目依赖包（使用npm安装，依赖包较多，耐心等待1-3分钟）：

3. 启动Clawdbot服务（测试启动，确认无报错）：

4. 设置后台运行与开机自启（关键步骤，避免关闭终端后服务停止）： 安装pm2（Node.js进程管理工具，用于后台运行Clawdbot）：

5. 使用pm2启动Clawdbot，并设置开机自启：

6. 验证pm2启动状态：执行pm2 status，若clawdbot对应的status为“online”，即为启动成功。

步骤6：ECS防火墙端口放行（关键，避免无法访问）

与阿里云轻量应用服务器类似，ECS实例需放行Clawdbot的Web访问端口（80，若后续配置反向代理可使用）和通信端口（18789，默认），步骤如下：

1. 登录阿里云ECS控制台，进入目标实例详情页面，左侧导航栏找到“网络与安全→安全组”，点击进入安全组配置页面。

2. 点击“配置规则→入方向→添加规则”，依次添加两个端口规则： 规则1（通信端口）：协议类型选择“TCP”，端口范围填写“18789”，授权对象填写“0.0.0.0/0”（允许所有IP访问，也可根据需求限制指定IP），备注“Clawdbot通信端口”，点击“确定”。

3. 规则2（可选，Web访问端口）：协议类型选择“TCP”，端口范围填写“80”，授权对象填写“0.0.0.0/0”，备注“Clawdbot Web访问端口”，点击“确定”。

4. 验证端口放行：在ECS终端执行以下命令，确认端口已放行：

步骤7：部署验证（确认ECS手动部署成功）

完成上述所有步骤后，验证Clawdbot是否能正常访问，步骤如下：

1. 打开本地浏览器，地址栏输入“http://ECS实例公网IP:18789”（若配置了80端口反向代理，可直接输入公网IP）。

2. 页面跳转至Clawdbot登录界面，输入配置文件中设置的访问Token，点击“登录”。

3. 若能成功进入Clawdbot Web对话界面，且能正常发送消息、调用AI模型（如输入“你好”，能收到AI回复），说明ECS手动部署成功；若无法访问，依次检查：ECS实例是否运行、安全组端口是否放行、Clawdbot服务是否在线（pm2 status）、Token是否输入正确。