# OpenClaw 本地部署教程

OpenClaw（原Clawdbot/Moltbot）是一个开源的中文智能体框架，支持通过飞书等渠道接入大模型，实现自动化任务处理与智能对话。以下是基于不同环境和需求的详细部署方案推演与实操指南。

1. 部署方案解构

在进行部署前，需要根据操作系统和模型选择确定具体的部署路径。OpenClaw 支持多种操作系统和模型接入方式，主要分为以下几种场景：

| 部署场景 | 适用系统/环境 | 核心依赖 | 特点 | | :— | :— | :— | :— | | 标准 Windows 部署 | Windows (PowerShell/CMD) | Node.js, npm | 适合初学者，支持一键脚本安装 [ref_1][ref_5]。 | | WSL2 部署 | Windows + WSL2 | Node.js, CMake, Git | 适合需要 Linux 环境兼容性或对接复杂后端的用户 [ref_2][ref_3]。 | | macOS/Linux 部署 | macOS / Linux | Node.js, Docker (可选) | 原生支持，性能更优，适合开发者环境 [ref_3]。 | | 云模型接入 | 上述任意环境 | 阿里云百炼/MiniMax API Key | 无需本地显卡，响应速度快，按需付费 [ref_1][ref_3][ref_5]。 | | 本地大模型接入 | 上述任意环境 | Ollama 或 vLLM | 数据隐私性好，无需联网，需本地算力支持 [ref_2][ref_4]。 |

2. 基础环境准备

无论选择哪种部署场景，Node.js 环境是必须的基础组件。建议使用 Node.js 18 或更高版本以确保兼容性 [ref_2][ref_3]。

2.1 安装 Node.js

请访问 Node.js 官网下载并安装 LTS 版本。安装完成后，在终端（Terminal、PowerShell 或 CMD）中验证安装：

# 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v 

2.2 安装 OpenClaw

OpenClaw 提供了便捷的安装脚本。在 Windows 下，可以使用 PowerShell 进行一键安装 [ref_1][ref_5]：

讯享网# Windows PowerShell 一键安装命令 irm https<em>:</em>//<em>openclaw</em>.cn/install.ps1 | iex 

对于 macOS、Linux 或 WSL2 用户，通常使用 npm 进行全局安装 [ref_3]：

# 使用 npm 全局安装 <em>OpenClaw</em> npm install -g <em>openclaw</em>-cn 

3. 核心配置流程

安装完成后，首次运行需要通过配置向导完成初始化，主要包括模型配置和飞书机器人接入。

3.1 启动配置向导

在终端中运行以下命令启动首次配置向导（CLI）：

讯享网# 启动 onboard 配置向导 <em>openclaw</em> onboard 

该向导将引导用户完成基础设置，包括选择模型提供商和配置网关端口等 [ref_1][ref_5]。

3.2 配置大模型 API

OpenClaw 支持接入云端模型（如阿里云百炼、MiniMax）和本地模型（如 Ollama、vLLM）。

• 云端模型配置： 在向导中或配置文件中填入对应的 API Key。例如，使用阿里云百炼平台获取的 API Key [ref_1][ref_5]。
• 本地模型配置： 若使用 Ollama，需先安装 Ollama 并拉取模型（如 qwen3<em>:</em>32b），然后在 <em>openclaw</em>.json 配置文件中指定模型名称和接口地址 [ref_4]。若对接远程 vLLM 服务，则需在配置中指定远程服务器的 IP 和端口 [ref_2]。

3.3 飞书机器人集成

这是实现智能体交互的关键步骤，涉及飞书开放平台的配置。

1. 创建应用：在飞书开放平台创建企业自建应用，获取 App ID 和 App Secret [ref_1][ref_3]。
2. 权限配置：必须开启 im<em>:</em>message 及 im<em>:</em>message.group_at_msg（群聊@机器人）等相关权限，并更新权限包 [ref_1][ref_5]。
3. 事件订阅：配置事件订阅，订阅 im.message.receive_v1 事件以接收消息。OpenClaw 通常会启动一个本地网关服务（默认端口 18789），需要将飞书平台的请求地址指向该本地地址（如 http<em>:</em>//127.0.0.1<em>:</em>18789/feishu）[ref_1][ref_4]。

4. 启动与验证

配置完成后，即可启动 OpenClaw 网关服务。

4.1 启动网关服务

在终端执行启动命令：

# 启动 <em>OpenClaw</em> 网关 <em>openclaw</em> gateway 

启动成功后，通常会显示 Web 可视化管理后台的地址，一般为 http<em>:</em>//127.0.0.1<em>:</em>18789。用户可以通过浏览器访问该地址查看运行状态和调试日志 [ref_4][ref_5]。

4.2 功能验证

• 私聊验证：在飞书中给机器人发送消息，检查是否收到回复。
• 群聊验证：将机器人加入飞书群聊，在群内 @机器人 提问，测试其响应能力 [ref_3]。
• 工具调用验证：尝试发送“查询磁盘”或“读取文件”等指令，验证 AI Agent 的自动化任务执行能力 [ref_3]。

5. 常见问题与卸载

5.1 常见问题排查

• 端口冲突：如果 18789 端口被占用，需在配置文件中修改端口或关闭占用进程 [ref_1]。
• 飞书消息无响应：检查飞书开放平台的事件订阅地址是否正确，以及服务器是否成功接收到了飞书的 POST 请求 [ref_1]。

5.2 卸载 OpenClaw

如果需要移除 OpenClaw，对于通过 pnpm 或 npm 全局安装的版本，可以使用以下命令进行卸载 [ref_6]：

讯享网# 使用 npm 卸载 npm uninstall -g <em>openclaw</em>-cn # 或者使用 pnpm 卸载（如果之前是用 pnpm 安装的） pnpm remove -g <em>openclaw</em>-cn 

卸载后，建议手动检查并清理全局安装目录下的残留文件夹及缓存，以确保彻底清理 [ref_6]。