Windows 10养龙虾：OpenClaw安装配置与实战教程

经常看到有人把“养龙虾”挂在嘴边，以为是搞水产养殖，点进来才发现是准备折腾 OpenClaw。这名字确实容易让人误会：Claw 就是爪子的意思，龙虾最标志性的就是那一对大钳子，所以社区里都把“安装配置 OpenClaw”戏称为“养龙虾”。OpenClaw 是一个跑在终端里的开源 AI 助手，装好之后，你可以在命令行窗口里像聊天一样给它下指令，让它整理文件、执行命令、查资料、发消息，甚至通过 ADB 接管 Android 手机。这篇文章就是我在 Windows 10 上从零到一把这只龙虾养起来的完整过程，每一步的原理、命令、坑点都写清楚了，适合第一次接触终端型 AI 助手的开发者，也适合好奇 AI 到底怎么“动手干活”的效率工具爱好者。

1. 先搞清楚要养的是个什么“龙虾”——OpenClaw 的能力全景

1.1 为什么终端 AI 助手值得折腾

大多数人用 AI 停留在网页对话框里：你问它答，它给你输出文字。可问题在于，文字回答解决不了“实际动手”的需求。你说“帮我把下载文件夹整理一下”，网页版 AI 只能给你一段批处理代码，剩下的事还是你自己来。OpenClaw 这类终端 AI 助手的思路完全不同，它把大模型和本机操作能力接在一起，AI 不仅能“说”，还能“做”——你说一句话，它自己规划步骤、调用工具、读写文件、跑命令，把结果摆在你面前。

用生活里的例子打比方：网页版 AI 像一个只动嘴的顾问，OpenClaw 则像多了一双手的助理。顾问给你方案，助理直接替你执行。这正是 AI Agent（智能体）概念最直观的落地形态之一，也是为什么这个项目在开源社区里热度一直很高。终端 AI 助手把对话界面和系统操作融为一体，操作路径短、反馈直接，尤其适合批量文件处理、日志分析、临时脚本生成这类场景。

1.2 OpenClaw 能干什么、不能干什么

先说能干的事：

• 文件读写：创建、修改、移动、重命名、删除文件，也可以读取文件内容做分析。
• 终端命令执行：在 Windows 的 CMD 或 PowerShell 环境里运行命令，比如查磁盘空间、看进程列表。
• 网页访问：抓取网页内容、做简单的信息搜索和摘要。
• 消息扩展：在配置好对应服务后，可以代发邮件或消息（需要按官方文档接入）。
• 手机控制：配合 ADB 工具，可以控制 Android 手机，比如截屏、滑动、输入文字。
• 扩展技能：通过编写 Markdown 格式的“Claws”技能包，给 AI 增加自定义能力。

这里要泼一盆冷水：OpenClaw 不是一个全能的自动化平台。它擅长的是“单机操作型任务”，不适合做大规模分布式处理，也不适合做需要复杂权限审批的流程。它对 AI 模型本身的推理能力依赖很强，模型理解错了，操作就可能出错。另外，终端 AI 助手以命令行为主，没有漂亮的图形界面，对新手有一定门槛。

1.3 适合谁来养这只龙虾

我实际用下来的感受是，OpenClaw 比较适合三类人：一是开发者，平时就泡在终端里，装个 AI 助手能省掉大量重复操作；二是效率工具爱好者，喜欢研究自动化工作流，愿意花时间调教工具；三是对 AI 原理好奇的学习者，通过观察 AI 调用工具的过程，能直观理解 Agent 的工作机制。

如果是完全没碰过命令行、看到黑窗口就发慌的朋友，建议先花半小时熟悉一下 CMD 和 PowerShell 的基本操作，再开始养龙虾。不是说不能从零开始，而是先有基础会更顺畅。我下面写的每一步都尽量照顾新手，但终端操作的基本功还是越扎实越好。

2. Windows 10 环境准备：先把水缸搭好

2.1 为什么 OpenClaw 需要 Node.js

OpenClaw 使用 JavaScript/TypeScript 编写，基于 Node.js 生态发布和运行。Node.js 是一个让 JavaScript 可以脱离浏览器、直接在电脑上运行的运行时环境。选它做终端 AI 助手，好处是跨平台能力强：同一套代码在 Windows、macOS、Linux 上都能跑，而且 npm 包管理器的生态成熟，可以很方便地分发和安装应用。

你可以把 Node.js 理解为养龙虾的“水缸”。没有这个水缸，OpenClaw 这只有钳子的虾就没有生活的环境。Windows 10 上安装 Node.js 并不复杂，唯一需要注意的是版本：OpenClaw 要求 Node.js 18 以上，推荐装 LTS（长期支持）版本，比如 20.x 或 22.x。LTS 版本稳定性好，各种依赖兼容性问题少。

2.2 安装 Node.js LTS：一步步来

第一步，打开浏览器，访问 Node.js 官网，找到下载页面，选择 Windows Installer（.msi）格式的 LTS 版本下载。注意看版本号，带 LTS 字样的就是稳定版。

第二步，运行下载好的安装包。安装界面保持默认选项即可，但有一个关键勾选项一定要确认：Add to PATH。PATH 是 Windows 用来查找可执行程序的路径列表，勾选之后，你在任意目录打开命令行都能直接使用 node 和 npm 命令。如果漏了这一步，后面运行 openclaw 会提示“不是内部或外部命令”。

第三步，安装完成后，重新打开一个命令提示符窗口。注意是“重新打开”，因为旧窗口的环境变量不会自动刷新。输入以下命令验证：

node -v npm -v

如果分别输出了版本号（比如 v20.x.x 和 10.x.x），说明 Node.js 安装成功。如果提示找不到命令，大概率是 PATH 没有配好，重启电脑再试，不行就手动把 Node.js 的安装目录加到系统环境变量里。

2.3 建议顺手装的工具：Windows Terminal 和 Git

虽然 CMD 能凑合用，但我强烈推荐安装 Windows Terminal。它是微软出的现代终端工具，支持多标签页、自定义主题、更好的字体渲染，用起来比老式黑窗口舒服得多。在微软商店搜索 Windows Terminal 即可安装，免费。

Git 也建议装一下。后面如果走源码方式运行 OpenClaw，或者以后想给项目做点贡献，都离不开 Git。Git 安装包在官网下载，安装时一路默认即可，装完在命令行验证：

git --version

装好 Git 之后，你还可以获得 Git Bash 这个类 Linux 的终端环境，很多命令习惯会更顺手。不过在 Windows 上运行 OpenClaw，核心终端还是 CMD 或 PowerShell，二者选一个顺手的主力环境就行。

2.4 环境自检清单

正式开始装 OpenClaw 之前，花一分钟做个自检：

如果某项不通过，优先解决环境问题再继续。省得后面安装时遇到一堆莫名其妙的问题，分不清是环境问题还是项目问题。

3. 正式安装 OpenClaw：两条路线任选

3.1 路线 A：npm 全局安装（最推荐）

npm 是 Node.js 自带的包管理器，OpenClaw 以 npm 包的形式发布。全局安装的好处是，安装完成后 openclaw 命令在任意目录下都可以直接使用，不需要进到特定项目目录。打开管理员身份的 PowerShell 或 CMD，执行：

npm install -g openclaw

这个命令会从 npm 仓库下载 OpenClaw 及其所有依赖包，安装到全局目录。在 Windows 上，全局包的安装目录一般是%APPDATA%\npm，这个目录在安装 Node.js 时已经自动加入 PATH。

安装过程可能需要几分钟，取决于网络状况和包体积。我建议在 Windows 上始终用管理员身份运行安装命令，因为全局写入目录权限受限时，npm 会报 EACCES 错误。如果遇到权限问题，关闭命令窗口，右键“以管理员身份运行”，再执行一次。

下载速度如果比较慢，可以给 npm 配置国内镜像源。执行：

npm config set registry https://registry.npmmirror.com

镜像源只是加速下载，不影响 OpenClaw 本身的运行逻辑。介意的话，安装完成后也可以随时改回官方源。

3.2 路线 B：源码方式运行（适合想折腾的人）

如果你不满足于开箱即用，想看看项目内部结构，甚至改几行代码，可以选择源码方式。首先用 Git 克隆项目仓库：

git clone <项目开源仓库地址> cd openclaw npm install

然后查看 package.json 里的 scripts 字段，通常会提供开发模式启动命令，比如npm run dev或node src/index.js。源码方式的好处是随时可以拉取最新代码、调试内部逻辑，坏处是升级需要手动 pull，且依赖安装时可能遇到一些环境问题。

我个人建议第一次尝试的人走路线 A，先把龙虾养起来、跑通对话，再考虑要不要深入源码。毕竟工具是用来用的，不是用来折腾的。等你对 OpenClaw 了解足够多之后，自然会知道有没有改源码的必要。

3.3 验证安装是否成功

安装完成后，新开一个终端窗口，输入：

openclaw --version

如果能看到版本号，比如 v0.x.x，说明安装成功。再看一下帮助信息：

openclaw --help

帮助信息里会列出支持的子命令和参数，包括 start、config、claws 等。熟悉这个列表，等于拿到了龙虾的使用说明书。有些版本将主命令命名为 claw，如果openclaw提示找不到，可以试claw --version。

3.4 Windows 专属的安装疑难

我在 Windows 10 上装的时候遇到过几个坑，一起列出来：

第一个是 PowerShell 执行策略问题。新安装的 PowerShell 默认可能禁止运行脚本，启动 openclaw 时如果提示“禁止运行脚本”，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这个命令只影响当前用户，允许运行本机脚本和可信的远程签名脚本，不影响系统安全性。

第二个是杀毒软件误报。OpenClaw 作为终端工具，有执行命令、修改文件的权限，个别杀毒软件会把它当成可疑程序。遇到这种情况，确认是从正规渠道安装后，可以手动添加信任或白名单。

第三个是终端编码问题。如果中文输出变成乱码，在 CMD 里执行chcp 65001切到 UTF-8 编码，或者在 Windows Terminal 的配置文件里设置默认编码为 UTF-8。

4. 给龙虾投喂“大脑”：API 密钥配置与首次启动

4.1 准备模型接口的 API Key

OpenClaw 本身不带大模型，它需要调用外部大模型接口来理解指令和生成内容。所以你得先有一个模型服务商的 API Key。具体怎么申请，各家服务商的注册流程略有不同，核心步骤都差不多：注册账号、进入控制台、创建 API Key、复制保存。

这里有几个必须注意的点：

• 密钥通常只在创建时完整显示一次，一定要立刻复制保存到本地，比如密码管理器里。
• 不要把密钥发给任何人，也不要贴到公共聊天群里。
• 密钥是按量计费的，建议在服务商控制台设置好用量上限，防止意外产生高额费用。

拿到密钥后，注意一下密钥格式。OpenClaw 默认支持多种主流模型接口规范，不同规范的密钥前缀也不同。常见的是sk-开头。根据密钥格式可以判断应该选择哪种 provider 配置。

4.2 首次启动：跟着配置向导走

环境就绪、密钥到手，接下来正式启动。在终端里输入：

openclaw

首次启动时，OpenClaw 会进入交互式配置向导，问你几个问题：选择模型接口类型、输入 API Key、确认默认权限设置。整个过程像聊天一样，按提示回答即可。

如果启动时没有出现向导，而是直接进入对话界面，说明它还没有配置过模型信息，你可以输入/config手动调出配置菜单，或者直接退出后按下一节的方案手动编辑配置文件。

配置完成之后，你会看到一个交互式命令行界面，通常带有提示符和输入框。这意味着龙虾已经睁开眼睛，可以对话了。

4.3 深入理解配置文件

OpenClaw 的配置文件默认存放在用户主目录下的.openclaw文件夹里，Windows 上就是C:\Users\你的用户名\.openclaw\。核心文件是config.json。用记事本或 VS Code 打开，内容大致长这样：

{ "model": { "provider": "claude", "name": "claude-3-5-sonnet", "apiKey": "sk-你的密钥" }, "permissions": { "shell": true, "fileWrite": true, "fileDelete": false }, "adbEnabled": false, "theme": "default" }

各字段含义：

• model.provider：模型接口类型。按你申请的密钥类型填写，常见值是 claude（Claude 规范）或 openai（OpenAI 规范）。
• model.name：具体模型名称。不同服务商提供的模型名不同，填你选用的模型版本。
• model.apiKey：你的密钥。
• permissions：权限设置。shell控制是否允许 AI 执行终端命令，fileWrite控制是否允许 AI 写文件，fileDelete控制是否允许 AI 删除文件。这个字段极其关键，建议从保守配置开始，先不开fileDelete。

提示：配置文件里保存了 API 密钥，相当于龙虾的“饲养凭证”。不要把这个文件夹传到 Git 仓库、网盘或任何公开位置。

4.4 首次对话测试：确认龙虾活着

一切配置妥当，返回到 OpenClaw 对话界面，先输入一句简单的问候：

你好，介绍一下你能做什么，不要执行任何命令。

它会基于当前配置和技能列表，介绍自己的能力。接着做一个不涉及文件改动的安全测试：

检查当前目录里有哪些文件，只列出文件名就行。

如果它能正确列出目录内容，说明模型调用、工具调用链都通了。如果这一步失败，问题大概率出在 API 密钥或网络连通性上，结合后面的排查章节处理。

5. 实操场景：把龙虾放出去干点正事

5.1 场景一：自动整理下载文件夹

这是一个最能直观体会 AI Agent 价值的场景。假设我的下载文件夹乱成一团，我会这样下指令：

请扫描 D:/Downloads 目录，把里面的文件按扩展名归类：图片放到 images 文件夹，文档放到 docs 文件夹，压缩包放到 archives 文件夹，不要删除任何文件，先给我看你的计划。

OpenClaw 接收到任务后，先调用文件系统工具扫描目录，再规划移动方案，最后执行移动操作。这个过程会在终端里实时显示：它调用了什么工具、读取到什么文件、做了哪些移动。你可以像看直播一样观察 AI 的工作过程。

这里有个重要技巧：在指令里说“先给我看你的计划”，等于人为加了一道确认闸门。AI 的规划不一定总是对的，尤其涉及批量移动文件时，先确认计划再执行可以避免错误操作。等熟悉了它的工作方式，再放开让它直接执行。

5.2 场景二：让 AI 帮你跑终端命令

OpenClaw 的 shell 能力允许它直接执行系统命令。比如我想快速了解磁盘状况，输入：

帮我查看 C 盘的剩余空间和当前内存占用情况。

它会选择合适的系统命令（Windows 下可能是 PowerShell 的 Get-PSDrive 和 Get-Process），执行并将结果整理成易读的格式回给你。比自己翻命令文档高效不少。

但一定要谨慎：AI 执行删除、格式化、修改系统设置等高风险命令前，OpenClaw 通常会弹出确认提示。如果你手里的版本没有默认提示，建议在配置文件里保持"shell": true的同时，自己养成“先看计划、再放行”的习惯。我给一个保守的安全准则：凡是不理解会有什么影响的命令，一律先拒绝，改成让 AI 解释清楚再执行。

5.3 场景三：网页访问与信息摘要

OpenClaw 带有网页抓取能力。如果你想快速了解某个网页的要点，可以直接说：

打开 https://example.com 这个页面，总结三句话的核心内容。

它会抓取网页正文、提取关键信息并给出摘要。这在阅读长文档、查看技术公告时很实用，相当于给自己配了一个即时摘要助手。

需要提醒的是，AI 的摘要基于抓取内容的实时结果，如果网页本身信息有误，AI 也可能被带偏。涉及重要决策的信息，务必回原文核对。

5.4 场景四：手写一个自定义技能 Claw

OpenClaw 的魅力在于可扩展，给龙虾装“第二对钳子”。它的自定义技能机制叫 Claws，本质上是放在.openclaw/claws/目录下的 Markdown 文件。一个最简示例：

--- name: 天气查询 description: 查询指定城市当前的天气情况。当用户提到天气、气温、要不要带伞时使用。 --- 用 wttr.in 服务查询天气。 1. 调用工具请求 https://wttr.in/城市名?format=3 2. 从返回结果里提取天气、温度、风力和湿度 3. 用一句通俗的话告诉用户，并提示是否需要带伞

字段解释：name是技能名，description是给模型看的说明，模型根据它与用户需求的匹配度来决定是否调用该技能。正文部分是在告诉模型“接了这个任务之后怎么执行”。写好保存后，在对话里输入“北京天气怎么样”，如果模型判断匹配，就会按这个流程执行。

这个机制非常有想象力，它等于把“调教 AI”这件事变成了写文档，不需要写代码。我建议第一次装好 OpenClaw 后，先自己写一两个这样的小技能练手，很快就能理解 Agent 的工作范式。

5.5 场景五（进阶）：通过 ADB 接管 Android 手机

这是 OpenClaw 最有冲击力的功能之一——把手机变成 AI 的可控外设。前提条件：电脑装了 ADB 平台工具，手机开启开发者选项里的 USB 调试，用 USB 线连接电脑，并授权调试。

在终端确认设备连接：

adb devices

看到设备序列号和 device 状态后，修改 OpenClaw 配置，把adbEnabled设为true，重启 openclaw。之后你可以这样操作：

截一张手机的当前屏幕，保存到电脑桌面上。

AI 会通过 ADB 工具执行截屏命令，把手机屏幕画面传输到电脑。更复杂的操作还包括在手机上输入文字、滑动页面、点击坐标、读取应用列表等。注意，手机控制权限极大，只能在你自己信任的设备上操作，并且同样遵循“先看计划再执行”的原则。

6. 问题排查与避坑实录：龙虾跑了怎么捞回来

6.1 高频问题速查表

6.2 一个通用排查思路

遇到问题，不要上来就重装。第一步，打开 OpenClaw 的调试模式，通常是通过--verbose或-d参数启动：

openclaw --verbose

这样它会输出详细的工具调用日志。第二步，看输出里有没有明确报错。第三步，对照速查表逐个排除。第四步，带上日志到项目讨论区搜索或提问。绝大多数问题都是“环境变量没配好、密钥格式不对、权限没开”这三类，真正涉及深层 bug 的很少。

6.3 我的几点实操心得

养了一段时间龙虾，我有几个很深的体会。第一，权限配置一定要收敛。我最初把fileDelete开了，结果 AI 在整理文件时误删了一个临时目录，虽然没造成实质损失，但吓得我立刻关掉了这个权限。默认情况下，建议只开shell和fileWrite，fileDelete保持 false，涉及删除任务时手动确认。

第二，每次做批量操作前，强制 AI 先给计划。这句话已经重复多次，但它真的是最有效的防呆手段。第三，API 密钥务必隔离保存。一旦泄露，立刻去服务商后台吊销并重新生成。第四，不同模型对工具调用的理解能力差距很大。我用同一个配置文件切换过不同模型，有的能完美理解复杂指令，有的在多步操作时频繁出错。如果你觉得 OpenClaw 变笨了，先想想是不是模型选得不够好。

最后再分享一个我最受用的小技巧：把常用的、不会变的操作写成 Claws 技能文档，比如“每周清空临时文件”“按项目归档截图”。积累一段时间之后，OpenClaw 就不再是一个玩具，而是真正懂你工作习惯的终端助理。养龙虾这事，前期最花精力的是配置和调教，等它稳定听话之后，回报会远超你的预期。