OpenClaw 小龙虾零基础完整安装文档

快来领取自己的小龙虾🦞吧

本文基于 2026 年最新官方流程整理，零基础可直接照着操作，覆盖一键安装、手动安装、初始化配置、启动使用、常见问题

一、前言

OpenClaw 是一款轻量本地 AI 助手网关，支持GLM-4.7、Claude 3.5、通义千问、豆包等主流大模型，可本地部署、可视化面板管理、支持工作流与插件扩展。本文仅针对 Windows 10/11 64位 系统。

二、系统与环境要求

系统：Windows 10 / Windows 11（64位）
必须：Node.js v20 及以上，推荐 v22 LTS / v24 LTS
网络：可正常访问外网（安装依赖、模型 API 调用）
权限：安装/运行需管理员权限

三、安装 Node.js（必装）

打开 Node.js 中文官网： https://nodejs.org/zh-cn/download/
下载 Windows Installer (.msi) 64位 安装包
双击安装，一路下一步，默认配置即可
验证安装是否成功打开 PowerShell，执行：

node -vnpm -v

出现版本号即安装成功。

四、OpenClaw 三种安装方式（任选其一）

方式 1：一键脚本安装（新手首选）

以管理员身份打开 PowerShell
先执行权限放行命令（必做）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

提示选 Y 回车。

再执行临时权限命令：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

执行官方一键安装：

iwr -useb https://openclaw.ai/install.ps1 | iex

等待自动安装完成，出现成功提示即可。

方式 2：npm 手动安装

已装 Node.js 可直接全局安装：

npm install -g openclaw@latest

安装遇到 sharp 失败可使用：

npm install -g openclaw@latest

验证安装：

openclaw --version

输出版本号即成功。

方式 3：Docker 部署（可选）

docker run -d ^--name openclaw ^-p 3000:3000 ^-v %USERPROFILE%\.openclaw:/root/.openclaw ^openclaw/openclaw:latest

五、初始化配置（必做步骤）

安装完成后必须执行初始化，才能连接模型。

执行配置命令：

openclaw onboard

按向导一步步配置：

风险告知：选择 Yes 回车
模式：选择 QuickStart
模型提供商：选择 Z.AI (GLM-4.7)
输入你在智谱开放平台获取的 API Key
通讯平台：skip for now
技能安装：NO
Hooks：skip for now

配置完成提示成功。

六、启动 OpenClaw 服务

1. 启动网关

新开一个 PowerShell（保持窗口不关闭）：

openclaw gateway

出现监听端口、模型加载成功即运行正常。

2. 启动 Web 控制面板

再新开一个 PowerShell：

openclaw dashboard

自动打开浏览器访问：

http://localhost:3000

OpenClaw Web控制台

七、Windows 一键启动脚本（可选）

桌面新建文本文档，复制以下内容，保存后缀为 OpenClaw启动.bat

@echo offecho Starting OpenClaw Gateway...openclaw gateway startpause

双击即可快速启动网关。

八、常用命令汇总

# 查看版本openclaw --version# 初始化配置openclaw onboard# 启动网关openclaw gateway# 打开控制台openclaw dashboard# 重启服务openclaw restart# 停止服务Ctrl + C

九、常见问题与解决

1. 提示“不是内部或外部命令”

未装 Node 或未配置环境变量
安装后重启终端再试

2. 权限不足

必须用管理员 PowerShell 安装/运行

3. 模型调用失败

检查 API Key 是否正确
检查模型名称与提供商匹配
执行 openclaw restart 重启

4. 端口被占用

关闭占用端口程序
或在配置中修改监听端口

十、完成

部署成功后，你就可以在 Web 控制台使用 GLM-4.7/Claude 等模型，进行 AI 问答、代码辅助、工作流自动化。

建议搭配养龙虾必备-ClawX 开源 AI 研究助手这个软件一起使用，效果会更好，如果在安装过程中遇到不懂的问题，可以留言，看到就会回复！