Moltbot本地怎么部署?Clawdbot本地怎么部署?OpenClaw本地怎么部署?

时间:2026-02-04来源:互联网作者:点心

你想了解 Moltbot、Clawdbot 与 OpenClaw 的本地安装方法,首先要明确:三者是同一开源项目的不同阶段名称,本地安装流程基本完全一致,优先推荐安装最新版 OpenClaw(向下兼容 Clawdbot/Moltbot 的所有功能与指令),下面我会提供详细、可落地的本地安装指南,分「新手快速安装」和「进阶自定义安装」,兼顾零基础用户和有技术基础的用户。

一、安装前置准备(必须满足)

1. 环境要求

运行系统:支持 macOS、Linux、Windows(仅支持 WSL2,不支持原生 Windows,建议安装 WSL2 + Ubuntu 20.04 及以上)

核心依赖:Node.js ≥ 22.0.0(必须满足版本要求,低版本会导致安装失败)

AI 模型支持(二选一即可):

云端 API:Claude Pro/Max(推荐)、OpenAI 订阅(需 API Key)

本地大模型:Ollama(推荐)、LM Studio(需配置 OpenAI 兼容端点)

可选依赖:Docker(用于开启沙箱隔离,提升安全性)、Tailscale(用于远程访问)

2. 前置环境验证(以 Linux/macOS/WSL2 为例)

bash

运行

# 1. 检查 Node.js 版本(需 ≥22.0.0)

node -v


# 2. 若 Node.js 版本过低,安装/升级 Node.js(以 nvm 为例,推荐 nvm 管理 Node 版本)

# 安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash


# 刷新环境变量

source ~/.bashrc (Ubuntu/WSL2)或 source ~/.zshrc(macOS)


# 安装 Node.js 22 稳定版

nvm install 22

nvm use 22


# 3. 验证 Node.js 版本是否达标

node -v  # 输出 v22.x.x 即合格

二、核心安装流程(优先最新版 OpenClaw)

方式一:新手快速安装(5 分钟搞定,推荐零基础用户)

该方法通过官方一键向导完成安装,自动配置守护进程,无需手动修改配置。

bash

运行

# 1. 全局安装最新版 OpenClaw(兼容 Moltbot/Clawdbot 指令)

npm install -g openclaw@latest


# 补充:若想安装旧版 Moltbot/Clawdbot,可执行对应命令(不推荐,仅兼容测试用)

# npm install -g moltbot@latest

# npm install -g clawdbot@latest


# 2. 运行官方初始化向导(自动安装守护进程、配置基础环境)

openclaw onboard --install-daemon


# 执行后会出现交互式引导,按提示操作:

# - 同意用户协议

# - 选择默认安装目录(建议直接回车使用默认路径)

# - 配置是否开启自动启动(新手推荐开启)

方式二:进阶手动安装(适合需要自定义配置的用户)

bash

运行

# 1. 全局安装 OpenClaw

npm install -g openclaw@latest


# 2. 创建专属配置目录(手动管理配置文件)

mkdir -p ~/.openclaw/config


# 3. 生成基础配置文件

openclaw init --config ~/.openclaw/config/openclaw.json


# 4. (可选)修改配置文件(自定义 AI 模型、消息平台等,后续详细说明)

# 可使用 vim 或记事本编辑配置文件

vim ~/.openclaw/config/openclaw.json


# 5. 安装守护进程(可选,实现后台运行)

openclaw daemon install

3. 消息平台配对(关键步骤,实现设备与 AI 助手通信)

无论哪种安装方式,都需要配对消息平台才能正常使用,以最常用的 WhatsApp 为例,Telegram 次之:

bash

运行

# 1. 启动消息平台配对工具

openclaw channels login


# 2. 选择要配对的平台(按回车选择 WhatsApp,输入对应数字选择其他平台)

# - WhatsApp:会在终端生成二维码,用手机 WhatsApp 「设置-链接设备」扫描即可配对

# - Telegram:需提前在 Telegram 中创建 Bot(@BotFather 获取 Bot Token),按提示输入 Token 即可完成配对


# 3. 验证配对是否成功

openclaw channels list  # 输出已配对的平台及状态,显示「online」即成功

4. 启动 OpenClaw 核心服务(网关)

bash

运行

# 1. 快速启动网关(默认端口 18789)

openclaw gateway --port 18789


# 2. 进阶启动(指定配置文件、开启日志记录)

openclaw gateway --config ~/.openclaw/config/openclaw.json --log ~/.openclaw/logs/openclaw.log --port 18789


# 3. 后台运行(通过守护进程,避免终端关闭后服务停止)

openclaw daemon start


# 验证服务是否启动成功

openclaw daemon status  # 显示「running」即成功

5. 首次交互验证(确认安装成功)

通过已配对的 WhatsApp/Telegram 给 OpenClaw 发送消息:

plaintext

消息内容:嗨,你能做什么?

若收到 OpenClaw 的回复(列出核心功能,如日历管理、浏览器自动化等),说明本地安装与配置全部成功。

三、旧名称(Clawdbot/Moltbot)的兼容与迁移

指令兼容:安装 OpenClaw 后,旧指令 moltbot、clawdbot 仍可使用(为兼容旧脚本保留的别名),例如:

bash

运行

moltbot gateway  # 等价于 openclaw gateway

clawdbot channels login  # 等价于 openclaw channels login

配置文件迁移:若之前安装过 Moltbot/Clawdbot,可直接将旧配置文件复制到 OpenClaw 配置目录,无需重新配置:

bash

运行

# 复制 Moltbot 配置到 OpenClaw

cp ~/.clawdbot/moltbot.json ~/.openclaw/config/openclaw.json

升级建议:旧版本不再维护安全补丁,建议尽快通过 npm install -g openclaw@latest 升级到最新版,避免安全风险。

四、本地大模型配置(无需云端 API,完全私有化)

若不想依赖 Claude/OpenAI 云端 API,可搭配 Ollama 实现完全本地部署,步骤如下:

安装 Ollama:前往 Ollama 官方网站 下载对应系统版本,完成安装后启动 Ollama 服务。

拉取支持工具调用的本地模型(推荐 GLM-4.7-Flash 或 Llama 3.1):

bash

运行

ollama pull glm-4:7b-flash

修改 OpenClaw 配置文件,指定本地模型:

编辑 ~/.openclaw/config/openclaw.json,修改 agent 节点配置:

json

{

"agent": {

"model": "ollama/glm-4:7b-flash",

"endpoint": "http://127.0.0.1:11434/v1",  // Ollama 默认 OpenAI 兼容端点

"apiKey": "ollama"  // 固定值,无需修改

},

"channels": {

"whatsapp": {

"allowFrom": ["+1234567890"]

}

}

}

重启 OpenClaw 服务,即可使用本地大模型完成所有任务,无需消耗云端 API 额度。

五、常见安装问题排查

Node.js 版本过低报错:提示 Unsupported engine,解决方案:通过 nvm 安装 Node.js 22 及以上版本(参考前置环境配置)。

端口 18789 被占用:启动网关时提示 EADDRINUSE,解决方案:更换端口,例如 openclaw gateway --port 18790。

WhatsApp 配对失败:二维码过期或扫描无反应,解决方案:关闭网关后重新执行 openclaw channels login,确保手机网络与电脑在同一局域网。

npm 安装权限不足:提示 Permission denied,解决方案:添加 --unsafe-perm 参数,npm install -g openclaw@latest --unsafe-perm。

总结

三者是同一项目的不同阶段,优先安装最新版 OpenClaw,向下兼容 Moltbot/Clawdbot 的所有功能与指令。

本地安装核心步骤:满足 Node.js ≥22 环境 → 全局安装包 → 消息平台配对 → 启动网关服务。

零基础选「一键向导安装」,需私有化部署选「Ollama + 本地模型」配置,避免依赖云端 API。

旧版本用户可直接迁移配置文件,通过新指令启动,无需重新搭建环境。

本资讯来自互联网,如有侵权强联系删除~

相关文章更多>>