当前位置：首页 > news >正文

国内可用OpenClaw安装教程

news 2026/3/27 4:12:38

很多朋友在安装openclaw遇到各种的问题，其实最终主要还是网络的问题为主。现在整理一个国内可用的安装方式。

OpenClaw是一款功能强大的开源个人AI助理工具，支持本地部署、多模型接入与多渠道交互。以下是适配国内网络环境的多种安装方案，涵盖不同系统与使用场景。

一、前置环境准备
通用要求
系统适配：支持Windows 10/11（64位）、macOS（Intel/Apple Silicon）、Linux（Ubuntu/Debian等主流发行版）
硬件配置：CPU为x86-64或ARM64架构，内存≥2GB，磁盘可用空间≥500MB
核心依赖：Node.js v18+（推荐v20 LTS及以上版本），部分安装方式需提前安装Git^
Node.js安装方法
官网下载安装‌：访问Node.js官网，选择对应系统版本下载，安装过程默认设置即可。安装完成后，打开终端执行node -v和npm -v，显示版本号即为成功^
版本管理器安装（Windows可选）‌：
text
Copy Code
1. 下载nvw：https://pan.quark.cn/s/9163f612cd21
2. 安装后重启电脑，执行`nvw install 22`安装Node.js 22版本
3. 执行`nvm use 22.22.0`切换版本，显示`Now using node v22.22.0`即为成功
二、主流安装方案
方案一：中文版openclaw-cn安装（推荐国内用户）
该版本为非官方中文适配版，已将GitHub依赖包转为npm包，可通过国内镜像快速下载

切换国内npm镜像‌（可选，提升下载速度）：
text
Copy Code
npm config set registry https://registry.npmmirror.com
^
全局安装‌：
text
Copy Code
npm install -g openclaw-cn@latest
或使用pnpm安装：
text
Copy Code
pnpm add -g openclaw-cn@latest
^
验证安装‌：执行openclaw-cn --version，显示版本号即为成功^
方案二：官方原版一键安装
适合追求官方版本的用户，通过国内镜像加速解决网络问题

Windows系统‌：
以管理员身份打开PowerShell，执行：
text
Copy Code
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex
^
macOS/Linux系统‌：
打开终端执行：
text
Copy Code
curl -fsSL https://openclaw.ai/install.sh | bash
^
国内网络加速‌：若直接安装失败，先切换npm镜像再执行官方安装命令：
text
Copy Code
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
^
方案三：云服务器一键部署（适合长期在线使用）
国内主流云服务商均提供OpenClaw一键部署模板，无需手动配置环境

阿里云‌：访问阿里云OpenClaw一键部署页面，可选择轻量应用服务器、ECS等多种部署方式
腾讯云‌：通过腾讯云官方部署链接，使用轻量云应用模板一键部署，支持飞书、企业微信等多渠道配置^
京东云‌：创建轻量云主机时选择【Moltbot】应用镜像，参考京东云官方教程完成配置
方案四：Cherry Studio集成安装（零基础小白友好）
通过国产AI桌面客户端Cherry Studio一键安装，无需复杂命令操作

下载Cherry Studio‌：访问官网完成安装
配置免费模型‌：
打开软件进入设置，搜索openrouter并登录OpenRouter官网创建API Key
在Cherry Studio中添加免费模型stepfun/step-3.5-flash:free并完成配置
一键安装OpenClaw‌：在软件内找到OpenClaw安装入口，跟随引导完成安装与配置
三、初始化配置
中文版openclaw-cn配置
启动安装向导‌：
text
Copy Code
openclaw-cn onboard --install-daemon
^
关键配置步骤‌：
安全提示选择Yes，引导模式可选择QuickStart（快速配置）或手动配置
模型选择：推荐国内模型如DeepSeek、千问Qwen，需提前获取对应API Key^
网关配置：默认端口18789，认证方式选择Token并设置访问凭证
渠道配置：国内用户推荐选择飞书、企业微信等，可通过官方插件一键安装配置
官方原版配置
启动配置向导‌：
text
Copy Code
openclaw onboard
^
关键配置步骤‌：
安全警告阅读后选择Yes继续
选择QuickStart模式，自动配置网关端口与绑定地址
模型选择：国内用户推荐选择MiniMax M2.5 (CN)、DeepSeek等支持国内端点的模型^
渠道配置：可选择飞书、钉钉等国内主流IM工具，通过向导完成插件安装与权限配置
四、启动与验证
启动网关服务‌：
中文版：openclaw-cn gateway --port 18789 --verbose
官方版：openclaw gateway --port 18789
^
验证安装‌：
终端显示🦞 OpenClaw Gateway vx.x.x及Web UI: http://127.0.0.1:18789即为成功
打开浏览器访问http://127.0.0.1:18789，进入Web UI即可开始使用^
五、常见问题解决
网络下载失败‌：切换国内npm镜像，推荐使用https://registry.npmmirror.com^
权限不足‌：
Windows：以管理员身份运行终端
macOS/Linux：在安装命令前添加sudo，如sudo npm install -g openclaw@latest^
依赖安装失败（如sharp）‌：执行openclaw onboard --install-daemon重新安装依赖，或重启终端/电脑确保环境变量生效
安全软件拦截‌：关闭360等第三方杀毒软件，避免Node.js、Git等组件被拦截