安装小龙虾

三步完成安装与配置

「小龙虾」是开源 AI 智能体工具 OpenClaw 的中文昵称。它是一款开源、本地优先的 AI 智能体工具，可执行 Shell 命令、控制浏览器、读写文件，通过自然语言完成实际任务。安装后配合本平台的 Skill，即可用自然语言直接调用平台数据能力。

OpenClaw 官网：openclaw.ai，可查看官方文档、安装脚本与更新信息；安装脚本也通过该域名在线下载。
安装主线只有三步：① 以管理员身份打开 PowerShell → ② 粘贴一行安装命令 → ③ 初始化配置并填入密钥。卸载与常见问题请查看本章末尾「卸载与常见问题」。

安装教程

开始前准备

正式安装前只需确认两件事：① 软硬件环境满足要求（见下方「软硬件环境要求」）；② 已提前创建好大模型密钥（见上一节「准备大模型密钥」）。大模型密钥用于安装完成后的首次配置，提前准备好可避免配置中断。

软硬件环境要求
  • 系统：Windows 10 / 11（64 位）。本教程仅针对 Windows 环境，macOS 与 Linux 用户请参考 OpenClaw 官方文档。
  • 内存：建议 4GB 及以上
  • 磁盘：可用空间 1GB 以上
  • 网络：可正常访问 openclaw.ai（安装脚本需在线下载）

第一步：以管理员身份打开 PowerShell

安装命令需要以管理员身份运行才有足够权限。以下两种方式均可打开管理员 PowerShell：

如何以管理员身份运行 PowerShell

PowerShell 是 Windows 自带的命令行工具。安装命令需要以管理员身份运行才有足够权限，以下是两种最常用的打开方式。

方法一：开始菜单搜索

  1. 点击任务栏左下角「开始」按钮，或按键盘 Win 键
  2. 输入 powershell，在搜索结果中右键点击「Windows PowerShell」
  3. 选择「以管理员身份运行」

方法二：快捷菜单（Win + X）

  1. 同时按下 Win + X 键
  2. 在弹出菜单中点击「终端（管理员）」或「Windows PowerShell（管理员）」
两种方式都会弹出「用户账户控制（UAC）」窗口，点击「是」即可继续。

如何确认已是管理员身份

管理员窗口的标题栏通常会显示「管理员」字样（如「管理员: Windows PowerShell」）；若不确定，可执行以下命令，返回 True 即为管理员身份：

([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
在 PowerShell 中粘贴命令：可直接 Ctrl + V，或右键点击窗口空白处（Windows 10 及以上均支持）。

第二步：执行一行命令安装

若需自定义安装目录，先按下方提示执行可选命令；随后在管理员 PowerShell 中粘贴执行下面的安装命令：

可选：指定安装目录。默认数据会安装在 C 盘用户目录（%USERPROFILE%\.openclaw）。若希望安装到其他盘（如 D 盘），请先执行下方两条命令指定安装目录，然后重新打开一个 PowerShell 窗口，再执行安装命令。
指定安装目录为 D 盘（可选）
# 指定安装目录为 D 盘（路径可按需修改；执行后需重新打开 PowerShell 窗口再安装）
[Environment]::SetEnvironmentVariable("OPENCLAW_STATE_DIR", "D:\.openclaw", "User")
[Environment]::SetEnvironmentVariable("OPENCLAW_WORKSPACE_DIR", "D:\.openclaw\workspace", "User")
iwr -useb https://openclaw.ai/install.ps1 | iex
在 PowerShell 中输入一行安装命令

执行后等待脚本自动检测环境并完成安装（脚本会先检测并安装 Node.js 等依赖，请耐心等待），随后进入初始化配置。

可选但推荐：允许运行本地脚本。npm 安装的 openclaw 命令是一个 PowerShell 脚本，部分电脑的 Windows 默认禁止运行脚本，安装完成后执行 openclaw 命令会提示「无法加载 openclaw.ps1，因为在此系统上禁止运行脚本」，网关启动与开机自启同样依赖此设置。执行下方命令可提前避免该问题（仅对当前用户生效、执行一次长期有效，无需管理员权限）：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

第三步：初始化配置并填入密钥

安装完成后按提示依次输入并确认，完成初始化与密钥配置：

  1. 按提示输入 yes，继续初始化设置
  2. 再次输入 yes，进入模型厂商选择阶段
  3. 选择模型厂商（如 DeepSeek），粘贴密钥并选择模型
安装完成，输入 yes 开始初始化
进入模型厂商选择阶段
选择模型厂商、输入密钥并选择模型

安装完成后配置密钥

若安装时未填写密钥，或后续需要更换模型厂商，可执行 openclaw config 打开配置文件，将密钥填入对应厂商配置项即可。

打开浏览器 UI

初始化配置完成后，输入 exit 退出向导。首次使用前需先注册并启动网关服务，再打开管理界面，依次执行以下命令：

# 1. 注册网关服务（创建计划任务、开机自启；需管理员权限，仅首次执行一次）
openclaw gateway install

# 2. 启动网关服务
openclaw gateway start

# 3. 打开浏览器管理界面
openclaw dashboard

网关服务注册并启动后会在后台持续运行（开机自启）。之后再使用无需执行命令，直接在浏览器访问 127.0.0.1:18789 即可打开管理界面（建议收藏为书签）。

安装主流程至此结束。如需彻底移除 OpenClaw 或遇到安装/使用问题，可查看本章末尾「卸载与常见问题」。