OpenClaw中文社区版安装指南：基于Node.js的AI助手本地部署与飞书集成

OpenClaw 的中文社区版（openclaw-cn）针对国内网络环境进行了优化，解决了因访问 GitHub 等海外资源导致的安装难题。整个安装流程主要分为环境准备、安装核心程序、配置模型与渠道、启动运行四个步骤，文末附有视频教程。

第一步：环境准备工作

在开始安装前，请确保你的电脑满足以下基础条件：

操作系统：Windows 10/11 (强烈建议使用 WSL2)、macOS 或 Linux。本教程将以最普及的 Windows 系统环境为例。

核心依赖：Node.js 版本需 22 或更高。你可以从 Node.js 官方网站下载 LTS 版本，安装时保持默认选项即可。

安装完成后，请务必打开一个全新的 PowerShell 或命令提示符窗口，输入以下命令并回车，以验证安装是否成功：

node -v

如果终端显示出版本号（例如 v22.14.0），则说明 Node.js 环境已就绪。

第二步：安装 OpenClaw-CN 核心程序

这一步的核心是配置国内镜像源以规避网络问题，然后快速完成主程序的安装。

配置国内镜像源（关键步骤）

为了防止下载缓慢或超时，建议先配置淘宝的 npm 镜像源。在 PowerShell 中执行以下命令：

npm config set registry https://registry.npmmirror.com

执行安装命令

使用 Node.js 的包管理器 npm，全局安装 OpenClaw 中文社区版：

npm install -g openclaw-cn@latest

等待终端显示安装完成即可。如果遇到 sharp 模块相关的报错，通常不影响核心功能，可以暂时忽略。

验证安装

安装完成后，输入以下命令来验证命令行工具是否可用：

openclaw-cn --version

如果终端成功显示出版本号，那么恭喜你，核心程序已安装成功！若提示“命令未找到”，请检查环境变量或参考文末的常见问题解决方法。

第三步：运行配置向导

安装好程序后，需要通过一个交互式向导来完成大模型 API、通讯渠道等核心设置，这是让你的 AI 助手“活”起来的关键。

启动向导并安装守护进程

在终端执行以下命令，这将启动配置流程。建议在此过程中将 OpenClaw 安装为后台服务（守护进程），以便它能持续在后台运行：

openclaw-cn onboard --install-daemon

跟随向导完成基础配置

向导启动后，是一个交互式的命令行界面，你需要根据提示逐步进行选择：

1. 安全确认：阅读相关风险提示后，输入 YES 继续。
2. 配置模式：新手推荐选择 QuickStart (快速开始) 模式。
3. 配置大模型 (AI 的大脑)：这是最关键的一步。
   • 选择你使用的模型平台（例如国内的 Qwen (通义千问)、DeepSeek 等）。
   • 输入你从对应平台官网（如阿里云百炼、DeepSeek 开放平台）申请到的 API Key。
4. 配置通讯渠道：选择将 AI 助手接入哪个聊天应用。例如选择 FeiShu (飞书)。如果暂时不想配置，也可以选择“暂时跳过”，后续再通过 技术文档 补充。
5. 技能配置：选择 YES 安装默认技能包，赋予助手基础能力。
6. 启动方式：选择 Open the Web UI 或类似选项，这样向导结束后会自动在浏览器打开管理界面。

第四步：启动并使用你的 AI 助手

启动网关服务

配置向导完成后，OpenClaw 的核心服务（网关）可能需要手动启动。新开一个终端窗口，执行以下命令：

openclaw-cn gateway

保持这个终端窗口开启，当你看到类似 Listening on http://127.0.0.1:18789 的日志信息时，就说明网关服务启动成功了。

开始与助手对话

现在，你可以通过以下两种方式与你的 AI 助手互动：

• 网页端：打开浏览器，访问 http://127.0.0.1:18789/，即可在网页聊天界面中与助手对话。
• 飞书端：如果你在配置向导中成功接入了飞书，现在可以去飞书应用目录找到你创建的机器人，直接给它发送消息。它会通过你电脑上正在运行的 OpenClaw 网关来回复你。

配置视频教程：https://v.douyin.com/ajgM_BpHGik/

希望这篇详尽的指南能帮助你顺利完成 OpenClaw 的搭建。如果在实践中遇到任何问题，欢迎到 云栈社区 的相关板块与其他开发者交流探讨。