安装 OpenClaw 中文社区版openclaw-cn是在你自己的设备上私有化部署一个强大 AI 助手的必经之路。整个过程并不复杂核心就是准备环境、运行安装命令、配置模型和渠道这几步。下面是一份综合了官方指南和社区经验的安装教程你可以根据自己的操作系统和网络情况选择最适合的方式。 安装 OpenClaw-cn 的三种方式为了应对不同用户的需求和网络环境这里整理了三种主流的安装方式你可以根据自身情况选择。安装方式核心命令 / 步骤适用场景与特点官方安装脚本推荐Windows (PowerShell 管理员):iwr -useb https://clawd.org.cn/install.ps1 | iexmacOS / Linux:curl -fsSL https://clawd.org.cn/install.sh | bash新手首选全自动。脚本会自动检测并安装Node.js、下载核心文件最适合不想处理复杂依赖的初学者 。npm / pnpm 安装先配置国内镜像源加速 :npm config set registry https://registry.npmmirror.com然后执行安装 :npm install -g openclaw-cnlatest适合已有 Node.js 环境的用户。通过包管理器手动安装可控性更高。强烈建议先配置淘宝镜像源避免网络问题 。从源码构建git clone https://github.com/jiulingyun/openclaw-cn.gitcd openclaw-cn pnpm install pnpm build开发者或尝鲜用户。可以获取最新的未发布代码但过程相对复杂需要安装pnpm等额外工具 。安装完成后真正的配置工作才刚刚开始。无论你选择了哪种安装方式接下来的步骤都是通用的。⚙️ 详细配置与使用指南第一步环境准备与安装后检查确保 Node.js 环境OpenClaw-cn 要求Node.js 版本 ≥ 22。安装后打开新的终端窗口用node -v和npm -v验证是否安装成功 。处理 PATH 问题如果安装后提示找不到openclaw-cn命令通常是因为 npm 的全局安装目录不在系统的环境变量PATH中。可以通过npm prefix -g找到这个目录并把它添加到你的系统PATH里 。第二步运行配置向导这是最关键的一步它将引导你完成模型选择和基础设置。在终端中执行以下命令启动交互式配置向导 bashopenclaw-cn onboard --install-daemon在向导中你需要根据提示进行选择以下是一些核心选项的参考 安装模式选择“快速开始 (QuickStart)”可以简化流程。模型提供商选择你拥有 API Key 的平台国内用户首选Qwen(通义千问)或DeepSeek它们有不错的免费额度且网络稳定 。输入 API Key粘贴你从模型官网如阿里云百炼、DeepSeek 开放平台复制的 API Key 。渠道设置这里可以先选择“跳过”或“No”等会再单独配置飞书等聊天软件 。技能选择建议选择yes然后用空格键选中boot-md、command-logger、session-memory这三个基础但实用的技能选好后按回车确认 。session-memory尤其重要它能让你的 AI 拥有“记忆” 。第三步接入聊天渠道以飞书为例想让你的 AI 助手更方便地为你服务可以把它接入常用的聊天软件。飞书是目前国内体验最好的渠道之一 。在飞书开放平台创建应用访问飞书开放平台创建一个企业自建应用。在“凭证与基础信息”中拿到App ID和App Secret。在“权限管理”中批量导入以下权限 JSON json{ scopes: { tenant: [ im:message, im:message:send_as_bot, im:message.p2p_msg:readonly, contact:contact.base:readonly, aily:file:read, ... ] // 此处为简化示例完整内容请参考搜索结果 }在“事件订阅”中选择“使用长连接接收事件”并添加im.message.receive_v1事件 。在 OpenClaw 中添加渠道在终端中执行openclaw-cn channels add。选择Feishu并粘贴你刚才复制的App ID和App Secret。第四步启动并验证启动网关服务这是 OpenClaw 的大脑必须保持运行 。bashopenclaw-cn gateway访问管理后台打开浏览器访问http://localhost:18789你应该能看到 OpenClaw 的 Web 界面 。与你的 AI 对话在 Web 界面中可以直接开始对话 。如果配置了飞书在飞书中找到你的应用发送一条消息。第一次发送时机器人可能会回复一个配对码你需要在终端执行openclaw-cn pairing approve feishu 配对码来完成授权 。 常见问题速查安装时遇到sharp报错怎么办这是图片处理库在 Windows 上常见的问题。可以设置环境变量跳过npm install -g openclaw-cnlatest --ignore-scripts或者安装 Windows 构建工具npm install --global windows-build-tools。Web 界面报错disconnected (1006)这通常意味着网关服务断了。回到运行openclaw-cn gateway的终端窗口看看是不是意外退出了重新运行一次即可 。如何让 OpenClaw 在 Windows 开机时自动启动可以创建一个批处理文件 (openclaw-startup.bat)内容为openclaw-cn gateway然后将这个文件放入 Windows 的启动文件夹按Win R输入shell:startup即可打开。恭喜到此你已经成功拥有一个私有化部署的 AI 助手了接下来可以慢慢探索它强大的技能体系。如果在配置飞书或选择模型时遇到具体问题比如不知道在哪里获取 API Key可以随时再问我。