经常看到有人把“养龙虾”挂在嘴边以为是搞水产养殖点进来才发现是准备折腾 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.jsOpenClaw 使用 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 之前花一分钟做个自检检查项命令预期结果Node.js 版本node -vv18.0.0 以上推荐 v20 LTSnpm 版本npm -v能输出版本号即可PATH 配置where node能看到 node.exe 的路径网络连通ping npmjs.com有响应说明可以访问包仓库如果某项不通过优先解决环境问题再继续。省得后面安装时遇到一堆莫名其妙的问题分不清是环境问题还是项目问题。3. 正式安装 OpenClaw两条路线任选3.1 路线 Anpm 全局安装最推荐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 KeyOpenClaw 本身不带大模型它需要调用外部大模型接口来理解指令和生成内容。所以你得先有一个模型服务商的 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模型接口类型。按你申请的密钥类型填写常见值是 claudeClaude 规范或 openaiOpenAI 规范。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 场景四手写一个自定义技能 ClawOpenClaw 的魅力在于可扩展给龙虾装“第二对钳子”。它的自定义技能机制叫 Claws本质上是放在.openclaw/claws/目录下的 Markdown 文件。一个最简示例--- name: 天气查询 description: 查询指定城市当前的天气情况。当用户提到天气、气温、要不要带伞时使用。 --- 用 wttr.in 服务查询天气。 1. 调用工具请求 https://wttr.in/城市名?format3 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 高频问题速查表问题现象可能原因解决办法openclaw 不是内部或外部命令npm 全局目录不在 PATH 中把%APPDATA%\npm或实际安装路径手动加入系统 PATH重开终端启动提示禁止运行脚本PowerShell 执行策略限制执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser安装时报 EACCES 权限错误全局目录无写权限用管理员身份重开终端再装对话时提示 API 认证失败API Key 填错、过期或 provider 选错检查 config.json 中的密钥和 provider 字段中文输出乱码终端编码不是 UTF-8CMD 里执行chcp 65001或设置 Windows Terminal 默认 UTF-8AI 说“我没有这个工具”功能依赖未启用的扩展或 ADB按需安装扩展、打开对应权限配置执行命令卡住无响应网络请求超时检查 API 服务连通性稍后重试必要时调大配置中的超时时间6.2 一个通用排查思路遇到问题不要上来就重装。第一步打开 OpenClaw 的调试模式通常是通过--verbose或-d参数启动openclaw --verbose这样它会输出详细的工具调用日志。第二步看输出里有没有明确报错。第三步对照速查表逐个排除。第四步带上日志到项目讨论区搜索或提问。绝大多数问题都是“环境变量没配好、密钥格式不对、权限没开”这三类真正涉及深层 bug 的很少。6.3 我的几点实操心得养了一段时间龙虾我有几个很深的体会。第一权限配置一定要收敛。我最初把fileDelete开了结果 AI 在整理文件时误删了一个临时目录虽然没造成实质损失但吓得我立刻关掉了这个权限。默认情况下建议只开shell和fileWritefileDelete保持 false涉及删除任务时手动确认。第二每次做批量操作前强制 AI 先给计划。这句话已经重复多次但它真的是最有效的防呆手段。第三API 密钥务必隔离保存。一旦泄露立刻去服务商后台吊销并重新生成。第四不同模型对工具调用的理解能力差距很大。我用同一个配置文件切换过不同模型有的能完美理解复杂指令有的在多步操作时频繁出错。如果你觉得 OpenClaw 变笨了先想想是不是模型选得不够好。最后再分享一个我最受用的小技巧把常用的、不会变的操作写成 Claws 技能文档比如“每周清空临时文件”“按项目归档截图”。积累一段时间之后OpenClaw 就不再是一个玩具而是真正懂你工作习惯的终端助理。养龙虾这事前期最花精力的是配置和调教等它稳定听话之后回报会远超你的预期。