OpenClaw（龙虾[特殊字符]）AI 智能体安装教程

硬件 & 软件前置要求

硬件

内存：最低 4GB，推荐 8GB 及以上
磁盘：至少 2GB 空闲存储空间
网络：可访问外网（有能力的话最好，没也行）

必备环境

Node.js ≥ v22，版本过低会直接安装失败
Windows：PowerShell（管理员模式）
windows/Mac / Linux：系统终端

准备工作

提前申请一个大模型 API Key（智谱、硅基流动、阶跃星辰等国内平台均可），龙虾本身免费，但调用大模型需要 API Key。我以deepseek为例

网址：https://www.deepseek.com/

方式一：一键脚本安装（新手推荐）

Windows 系统

右键开始菜单，以管理员身份打开 PowerShell。
设置 PowerShell 执行策略（允许运行安装脚本）。

Windows 默认禁止运行脚本，必须修改，否则安装脚本无法执行。

在管理员 PowerShell 中输入以下命令，按回车：
bash 复制代码
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
复制下面整条命令粘贴，回车执行：
powershell 复制代码
```
iwr -useb https://openclaw.ai/install.ps1 | iex
```
等待 3‑10 分钟，网络不同耗时不一样。
看到 OpenClaw installed successfully 代表安装完成。

Mac / Linux

打开系统终端，执行一键脚本：

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

验证是否安装成功

终端输入：

bash 复制代码

openclaw -v

输出版本号，说明安装成功。

方式二：NPM 命令安装（已有 Node.js 22+ 环境）

适合已经装好 Node.js v22 以上的用户，直接全局安装最新版：

bash 复制代码

npm install -g openclaw@latest

初始化配置（安装后必做）

打开龙虾控制台，命令行输入：
bash 复制代码
```
openclaw onboard
```
Windows 终端粘贴注意：Ctrl+V 大概率无效，鼠标右键窗口，选择编辑，粘贴，避免带入多余空格导致报错。

然后会出现以下画面：

操作终端输入 yes 回车，开始初始化向导

向导会引导你填入 API Key（OpenAI / Anthropic Claude），设置 Agent 基础配置。

注意：输入 yes 代表你同意安全声明，Agent 可以操作本机文件系统。

输入 yes 后会出现这个画面：

输入 yes 程序会进入配置向导，让你填入大模型服务商 API Key（OpenAI / Anthropic Claude）。

键盘↑ ↓ 件选择，Enter确定

找到先前准备好的大模型（智谱、硅基流动、阶跃星辰等）如果没有就选择more

选择你的大模型，我选择deepseek

然后会出现一个大致是这样的界面，现在要下载插件尽量选择npm下载（Download from npm）

安装完成后会让你填写API Key复制你的API Key

如果ctrl+v没有用就鼠标右键窗口，选择编辑，粘贴，避免带入多余空格导致报错。

这里会让你选择你的模型如果不想用这个模型就选第三个选项

我这里还选deepseek-v4-flash

测试龙虾是否正常工作

在控制台输入指令测试：

bash 复制代码

帮我在桌面新建一个测试文档，写一段测试文字。

龙虾如果自动完成新建文

件、写入内容，代表部署全部完成。

常见报错与排错



问题解决办法
安装失败、依赖报错确认 Node 版本≥22，卸载旧版本 Node 重装
API 调用失败检查 Key 是否复制多余空格，确认平台有可用额度
Windows 脚本被拦截 PowerShell 管理员运行，放开系统执行策略
启动后无响应切换国内大模型，不要直接使用海外模型
openclaw 命令找不到重启终端，重启电脑刷新环境变量

启动教程

先新建一个power shell窗口
输入openclaw gateway run
等待出现
然后新建power shell窗口输入openclaw dashboard
千万不要自己输网址！！！！！！！
千万不要自己输网址！！！！！！！
千万不要自己输网址！！！！！！！

安全重要提示

OpenClaw 拥有操作本地文件、浏览器、软件的权限，不要运行陌生第三方技能脚本，防止文件被篡改、泄露密钥。

个人本地使用，不要把龙虾暴露到公网，避免被远程访问。

API 密钥属于敏感信息，不要分享、不要上传到网上。

有问题欢迎在评论区讨论