本地安装 OpenClaw(龙虾)的极简、安全、可复现步骤

一套 Windows 本地安装 OpenClaw（龙虾）的极简、安全、可复现步骤，从 0 到能用，全程照着做即可。

一、系统要求（先确认）

• Windows 10/11 64 位
• 内存 ≥4GB（推荐 8GB）
• 磁盘 ≥2GB 空闲
• 网络能正常联网（仅首次装依赖 & 调用 AI）

二、方法一：一键安装（推荐，新手首选）

1）以管理员身份打开 PowerShell

• 开始菜单搜索 PowerShell
• 右键 → 以管理员身份运行 → 点“是”

2）放行脚本执行（必须）

粘贴并回车：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

提示时输入 Y 回车。

3）执行国内镜像一键安装（速度快）

粘贴并回车：

iwr -useb https://clawd.org.cn/install.ps1 | iex

• 脚本会自动：装 Node.js 22、装 OpenClaw、配环境
• 等待 3–8 分钟，出现 OpenClaw installed successfully 即成功

三、方法二：手动安装（适合想控版本/防网络问题）

1）安装 Node.js 22（必须 ≥22.0.0）

• 官网下载 LTS 版：https://nodejs.org/
• 选 Windows 64-bit .msi
• 安装时全程默认，勾选自动装工具

验证（新 PowerShell）：

node -v   # 应显示 v22.x.xnpm -v

2）安装 Git（可选但推荐）

• 下载：https://git-scm.com/
• 安装全程默认

3）全局装 OpenClaw

npm install -g openclaw

国内慢就用镜像：

npm config set registry https://registry.npmmirror.com/npm install -g openclaw

验证：

openclaw --version

四、首次配置（Onboarding，关键！）

安装成功后自动进入向导，或手动运行：

openclaw onboard

步骤（一路回车/选 Yes）：

1. 确认继续 → Yes
2. 选模式 → QuickStart（新手）
3. 选模型 → Moonshot（Kimi）/ DeepSeek（国内稳定）
4. 填 API Key：
• Moonshot：https://platform.moonshot.cn/console → API Key 管理 → 新建 → 复制粘贴
5. 等待配置完成 → 自动启动服务

五、启动 & 访问 Web UI

1）启动服务

openclaw start

后台常驻：

openclaw start --detach

2）打开浏览器访问

地址：http://localhost:18789

• 本地仅你能访问（未暴露公网，安全）
• 初始无密码，后续可在设置里加

六、安全加固（必做！本地也防漏）

1. 改端口（避免扫描）

openclaw config set gateway.port 18790openclaw gateway restart

以后用 http://localhost:18790 访问

1. 设置强密码（本地也加）Web UI → 设置 → 账号 → 启用密码登录 → 设复杂密码

2. 禁止公网监听（关键）

openclaw config set gateway.host 127.0.0.1openclaw gateway restart

确保只监听本机，外网完全连不上

七、安装常用 Skill（插件）

Web UI → 技能市场 → 搜索安装：

• hot-search：知乎/微博/百度 热点抓取（你正在用的）
• code-assistant：代码生成/调试
• file-manager：批量文件处理
• excel-tools：Excel 数据处理

也可手动装：

openclaw skill install hot-search

八、停止/重启/卸载

openclaw stop          # 停止服务openclaw restart        # 重启npm uninstall -g openclaw  # 卸载

九、常见问题

• “node 不是内部命令” → 重启电脑 / 检查环境变量
• 安装慢 → 换国内镜像（见上文）
• 连不上 Web UI → 检查端口是否被占用、防火墙是否拦截