openclaw安装教程

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

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

核心依赖：Node.js 版本需 22 或更高 。

    你可以从 Node.js 中文官网 下载 LTS 版本，安装时所有选项保持默认即可 。

    安装完成后，请务必打开一个全新的 PowerShell 或命令提示符窗口，输入 node -v 并回车。如果显示版本号（如 v22.14.0），则说明安装成功 。

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

配置国内镜像源（关键一步）     为了防止下载缓慢或超时，建议配置淘宝镜像源。在 PowerShell 中执行以下命令 ：

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

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

bashnpm install -g openclaw-cn@latest

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

验证安装     安装完成后，输入以下命令验证 CLI 是否可用 ：

bashopenclaw-cn --version

    如果显示版本号，则恭喜你，核心程序安装成功！若提示命令未找到，请参考文末的常见问题解决。

    安装好程序后，需要通过向导来完成大模型 API、通讯渠道等核心设置。

启动向导并安装守护进程     在终端执行以下命令，这会启动配置流程，并建议将 OpenClaw 安装为后台服务（守护进程），让它能一直在后台运行 ：

bashopenclaw-cn onboard --install-daemon

跟随向导完成基础配置     向导启动后，是一个交互式的界面，你需要根据提示进行选择 ：

安全确认：阅读风险提示后，选择 YES。

配置模式：新手选择 QuickStart (快速开始)。

配置大模型 (AI 的大脑)：这是最关键的一步。

    选择你使用的模型平台（例如：国内的 Qwen (通义千问)、DeepSeek 等）。

    输入你的 API Key。你可以去对应平台的官网（如阿里云百炼、DeepSeek 开放平台）免费申请。

配置通讯渠道：这里可以选择将 AI 助手接入哪个聊天软件。例如选择 FeiShu (飞书)。如果暂时不想接入，也可以选择“暂时跳过”，后续再配置 。

技能配置：选择 YES 安装默认技能，让助手拥有基础能力 。

启动方式：选择 Open the Web UI 或类似选项，向导结束后会自动打开管理界面。

启动网关服务     配置完成后，OpenClaw 的核心服务（网关）可能还未运行。你需要手动启动它 ：

bashopenclaw-cn gateway

    保持这个终端窗口开启，看到类似 Listening on http://127.0.0.1:18789 的信息，就说明启动成功了。

开始对话

网页端：打开浏览器，访问 http://127.0.0.1:18789/，你就可以在网页上和你的 AI 助手对话了 。

飞书端：如果你在配置向导中接入了飞书，现在可以去飞书应用目录找到你创建的机器人，给它发送消息，它会通过你电脑上正在运行的 OpenClaw 网关来回复你 。

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