【最新教程】OpenClaw（原Clawdbot/Moltbot）本地部署快速指南

2026-05-05阅读 0热度 0

AIGC AI编程

一、环境准备：搭建前的必要检查

在开始部署之前，先别急着动手。确保你的系统环境满足要求，能避免后续90%的报错问题。咱们先来核对一下这套基础配置清单。

1. 系统与硬件要求

操作系统：macOS、Linux、或者Windows（强烈推荐使用WSL2环境）。

最低配置：这个要求其实挺亲民的，CPU不少于2核，内存≥4GB，再给磁盘预留出10GB以上的空间就差不多了。

必备工具：Node.js 必须使用22或更高版本。Git是代码管理的基础，而Docker则是可选项——虽然不强制，但强烈建议安装，它能提供一个干净的沙箱环境，让会话之间互不干扰。

2. 依赖安装

首先，检查Node.js版本。打开终端，输入 node -v。如果版本低于22，或者你想升级到建议的24版，可以通过nvm、fnm或Homebrew（macOS）这些版本管理工具来轻松搞定。

接着是Git。直接去官网 git-scm.com（或gitforwindows.org）下载对应系统的安装包就行。当然，如果你身处国内，也可以试试评论区同学推荐的阿里镜像站，速度通常会快一些。安装过程基本就是一路“下一步”，但在配置环境变量这个环节，记得留意一下。

调整你的 path 环境变量，这里建议选择第二项

最后是Docker（可选）。安装Docker 20.10或更高版本，并确保安装后它在后台持续运行。这主要是为了后续会话的沙箱隔离功能做准备的。

二、安装部署（官方推荐流程）

好了，环境齐活，现在进入正题——安装。官方提供了一键脚本，非常方便，但不同系统命令略有不同。

对于Windows用户：请务必用管理员方式打开PowerShell，然后执行这条命令：
iwr -useb https://openclaw.ai/install.ps1 | iex

对于MacOS或Linux用户：直接在你的终端里运行：
curl -fsSL https://openclaw.ai/install.sh | bash

脚本运行后，选择 QuickStart 选项，之后跟着屏幕上的提示一步步操作即可。整个安装向导的入口在这里：
OpenClaw — Personal AI Assistanthttps://openclaw.ai/

$\"图片\"$

安装过程中，你需要选择一个AI模型。这里以选择MiniMax为例，根据提示输入你自己的API Key进行配置。

$\"图片\"$

接下来是Channel（渠道）选择。默认集成的多是国外平台，这一步我们可以先直接跳过，后面再通过插件的方式接入更符合国内使用习惯的飞书。

$\"图片\"$

同样的，Skill（技能）和Hooks（钩子）我们也暂时跳过，不进行配置，以保持初始设置的简洁。

$\"图片\"$

最后，选择通过Web UI打开界面。

$\"图片\"$

随后，你的默认浏览器会自动跳转到 http://127.0.0.1:18789。恭喜，这就是OpenClaw的Web管理端界面了。

$\"图片\"$

四、ClawBot如何接入飞书？

为了可以随时随地使用OpenClaw，我们需要接入IM通信软件。

国内的话可以考虑接入飞书，因为它生态相对开放，接入起来会比较方便，同时支持PC电脑端和手机移动端。

为了实现这个目标，我在Github找到一个专门用于OpenClaw接入飞书的插件，按照下面操作简单4步就可以接入飞书：

1. 创建飞书应用

打开飞书开放平台，创建一个新的应用，名字可以就叫 “OpenClaw”。

$\"图片\"$

创建完成后，页面会显示 App ID 和 App Secret，这两串字符至关重要，务必先复制保存好，后面配置要用到。

$\"图片\"$

2. OpenClaw安装飞书插件

这个开源插件的地址如下：
https://github.com/m1heng/clawdbot-feishu.git

按照插件仓库说明文档的指引，在终端执行相应的安装命令即可。

$\"图片\"$

安装完成后，需要修改OpenClaw的配置文件：
~/.openclaw/openclaw.json

在配置文件中加入以下内容（注意将 `App ID` 和 `App Secret` 替换成你刚才保存的）：

"channels": {
    "feishu": {
      "enabled": true,
      "appId": "上面保存的 App ID",
      "appSecret": "上面保存的 App Secret",
      "domain": "feishu",
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "requireMention": true,
      "mediaMaxMb": 30,
      "renderMode": "card"
    }
  },

配置好后，重启OpenClaw服务。然后，在Web端的Channels页面，如果看到飞书的状态显示为 Running，那就说明插件配置成功了。

$\"图片\"$