这是一份为你整理的 OpenClaw（小龙虾） 安装手册。这只“小龙虾”是一个非常强大的本地 AI 智能体，能帮你自动整理文件、操作软件、甚至帮你写文案。

为了让你能顺利“请”它回家，我结合了最新的官方指南，为你整理了最简单的安装方案。请根据你的设备类型，选择对应的步骤操作。

1.安装步骤

核心安装步骤（任选其一）

重要提示： 无论哪种方式，安装路径都不要包含中文或空格，否则可能会报错。

1. Windows 用户（最简单的一键安装）

这是目前最推荐给新手的方式，脚本会自动帮你配置环境。

1. 打开管理员权限的 PowerShell
   • 点击左下角搜索框，输入 PowerShell。
   • 右键点击 “Windows PowerShell”，选择 “以管理员身份运行”。
   • 弹出提示时点击“是”（这一步最关键，权限不足会报错）。
2. 复制并执行安装命令
   • 复制下面的命令，粘贴到蓝色窗口中，按回车：

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

   • 国内网络加速（如果上面慢）：

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

3. 等待安装完成
   • 全程约 3-8 分钟，不要关闭窗口。
   • 看到 OpenClaw installed successfully 字样即表示安装成功。

2. macOS / Linux 用户

1. 打开终端
   • Mac：通过 Command + 空格 聚焦搜索“终端”。
   • Linux：通常按 Ctrl+Alt+T。
2. 复制并执行安装命令
   • 粘贴以下命令并回车

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

             2.Mac 可能需要输入开机密码（输入时屏幕不显示字符，输完直接回车）。

3. 安卓手机用户

• 官方 APK 直装（最简单）：
  1. 在手机浏览器访问 OpenClaw 官方社区安卓页。
  2. 下载最新 APK 文件。
  3. 安装时允许“未知来源应用”权限。
  4. 打开 APP，按引导完成初始化。
• 云端方案（iOS 及低配手机推荐）：
  • 苹果 iOS 暂不支持直接安装 APP。
  • 建议使用“OpenClaw 官方云端”或“红手指”等云手机应用，在云端环境打开。

2.安装后操作

安装完成不代表能直接用，还需要两步启动服务。

2.1 初始化配置

1. 打开新的终端窗口（PowerShell 或终端），输入：

   openclaw onboard

2. 按提示设置管理员密码、选择 AI 服务（新手选云端 API 即可）、配置端口（默认 18789）。

2.2 启动服务

• 方式一（推荐）： 输入命令启动网关：

  openclaw gateway --port 18789

  （不要关闭这个窗口，否则服务会停止）

• 方式二： 直接输入 

  openclaw start

2.3 打开控制台

保持服务窗口打开，另开一个终端窗口，输入：

openclaw dashboard

浏览器会自动跳转。如果没跳转，手动输入：http://localhost:18789

3.常见问题与避坑指南

为了防止你卡在最后一步，我整理了几个高频问题的解决方案：

问题现象	可能原因	解决方案
提示“禁止执行脚本”	Windows 默认安全策略	在管理员 PowerShell 中执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，输入 Y 确认。
提示“不是内部或外部命令”	环境变量未生效	1. 重启电脑。2. 检查 Node.js 安装时是否勾选了 Add to PATH。
网页打不开 (127.0.0.1)	端口被占用或防火墙拦截	1. 检查 18789 端口是否被占用。2. 暂时关闭防火墙/杀毒软件测试。
安装卡住/下载失败	网络波动	尝试使用国内加速命令安装，或者换个时间段重试。
中文路径报错	路径含中文	将安装路径改为纯英文，例如直接放在 D:\ 盘下。

4. 如何让它真正“干活”？

安装好后，它只是一个框架，你需要给它装上“技能”（Plugins）和“大脑”（API Key）：

1. 安装必装技能：在终端依次运行以下命令，安装核心技能：

   claw install browser        # 浏览器操作
   claw install desktop-control # 电脑控制
   claw install vector-memory   # 记忆功能

2. 配置 API Key：
   • OpenClaw 本身免费，但需要连接大模型（如通义千问、Kimi 等）。
   • 去对应平台（如阿里云百炼）注册账号，获取 API Key。
   • 在控制台或通过命令 openclaw config set 输入你的 Key。

现在，你的“小龙虾”应该已经准备就绪了！试着对它说：“帮我整理桌面文件”，看看它能不能帮你干活吧。