如果你最近频繁看到 OpenClaw 这个词那大概率说的就是这只“龙虾”。OpenClaw 直译过来是“开爪”因为读音顺口、图标又总被人看成一只张牙舞爪的龙虾社区里干脆就叫它龙虾了。它本质上是一个跑在终端里的开源 AI 代理你给我一句自然语言指令它去调用大模型、执行命令、读写文件、操作页面再把结果整理给你。这篇文章不打算复述官方文档而是把我从零开始装 OpenClaw、配 Windows Companion、接 Ollama 和 API、最后还跑到手机上的整个折腾过程拧成一份“六要六不要”清单。适合已经下载完 OpenClaw、正准备在 Windows、Mac 或者 Android 上把它盘活的人也适合还在观望、想知道这东西到底能干嘛的同学。1. 为什么叫“龙虾”以及它到底能帮你干什么1.1 从“开爪”到“龙虾”OpenClaw 的定位先说清楚一件事OpenClaw 不是一个聊天网页也不是一个普通聊天客户端。它是一个“代理型”工具你给它一个目标比如“帮我把这个文件夹里的 PDF 全部提取成纯文本然后按日期重新命名”它会自己拆解步骤、调用对应能力、逐步执行而不是只给你一段建议让你自己动手。很多人第一次跑起来后觉得“啥也没有”就是因为没理解这个定位。它默认的交互界面是命令行不是漂亮的可视化面板。你输入指令它展示思考过程和工具调用记录最后给你结果。这种设计的好处是透明坏处是不太符合普通用户的习惯。所以你不要指望它像个 App 一样开箱即用它更像一个“长在终端里的数字员工”。我实际用下来OpenClaw 最顺手的场景有三类一是本地文件与命令的批处理比如批量压缩、重命名、整理目录结构二是把一些重复性网页操作变成自然语言指令三是作为统一入口把本地模型、云端 API、各种小脚本都挂到同一个对话界面后面。至于网上那些“一句话让它写周报”“让它管我的日程”之类的场景也都能做但稳定性取决于你给它配置好的环境和权限。提示OpenClaw 项目迭代非常快改名、迁移仓库、命令变化都发生过。所以不管是哪篇教程包括这篇里面的安装命令都可能过期。你真正要记住的是“先看官方仓库 README”这个习惯而不是死记某条命令。1.2 算力问题API、本地模型与“只能 API 吗”“OpenClaw 只能用接入 API 的方式使用算力吗”是我在社区里看到最高频的疑问答案是不是。OpenClaw 本身只是个调度框架真正的“脑力”来自外部模型。它支持至少两类接法一类是接入云端 API比如各种大模型服务的接口优点是很聪明、能处理复杂任务缺点是按量计费、每次调用都有延迟另一类是接本地模型目前最常见的是通过 Ollama 拉一个开源模型下来全部在本机跑不花钱、隐私好但模型能力和上下文长度会明显受限。我自己是“混用派”日常读文件、改文本、整理目录这类确定性任务走本地小模型速度快、免费真正需要推理、写代码、总结长文的时候切到 API。OpenClaw 的好处恰恰在于它可以按任务或按 Skill 指定不同模型而不是全项目绑定一个。这种“重活交给大模型、轻活用小模型”的思路才是把它用顺的关键。1.3 适合谁不适合谁如果你满足下面任一条件OpenClaw 值得装喜欢折腾命令行愿意花半小时看日志每天有大量重复电脑操作想做自动化手里已经有 API 或者本地模型想找一个统一调度入口想学习 AI Agent 的工作原理。反过来如果你完全不想碰终端、看到报错就烦躁或者只想找一个“打开就能聊”的桌面软件那现阶段 OpenClaw 大概率会让你血压升高。它还没有成熟到像商业软件那样处处有引导很多配置要靠文档和社区帖子拼出来。这不算缺点但你要有这个心理预期。2. 六要照做就不会翻车的六个关键动作我把安装和使用过程中最常见的成功经验汇总成六个“要”。这六件事不是一次性做完就结束而是分别对应“规划、环境、系统、算力、扩展、运维”六个环节。2.1 要先把角色定位和算力方案写清楚我见过太多人连 OpenClaw 准备跑成什么样都没想清楚就开始执行安装命令结果装完不知道配什么模型、配完模型不知道让它干什么。搬出我自己的方法动手之前先在记事本上写三行字。第一行写“我要它帮我做什么”比如“整理下载文件夹”“定时抓取某网站公告”“把语音转文字”。第二行写“我愿意为每次调用付多少钱”如果是 0就选 Ollama 本地模型如果能接受按量付费就选 API。第三行写“它不该碰我哪些东西”比如某些目录、某些命令这个后面要落实到权限配置里。这三行字看着简单但能避免后面 80% 的纠结。OpenClaw 的配置项非常多一旦你不知道自己要什么就会被各种参数淹没。反过来目标明确的人只需要用到其中一小部分配置就能跑得很顺。2.2 要装对 Node.js 环境在社区里看到一条热词叫“node.js官网下载openclaw”这个说法其实有歧义。OpenClaw 本身不是从 Node.js 官网下载的你只是需要先装一个 Node.js 运行时然后再去 OpenClaw 官方仓库拉代码。为什么需要 Node.js因为 OpenClaw 是用 JavaScript/TypeScript 写的运行在 Node 环境上。版本不对后面会冒出一堆莫名其妙的问题。我的建议是装官方的 LTS长期支持版本不要图新鲜装最新的奇数版本也不要图省事用系统自带的旧版。装完之后一定要在终端里验证一下不要装了就当没装node -v npm -v两个命令都有正常输出版本号Node 环境才算合格。这一步没做后面所有“安装失败”都可能回溯到这里。2.3 要在 Windows 下先把 WSL2 验证好如果你是在 Windows 上部署这一步是最容易忽略、也最容易埋雷的。OpenClaw 很多能力依赖 Linux 环境官方推荐走 WSL2。不是所有 Windows 版本都默认开好了 WSL所以你需要在 PowerShell 里先确认状态。我当时第一次装完启动时被一句“无法安全验证 SL2 环境”卡了好几天后来才搞明白是 WSL 版本和内核不对。现在我会建议所有人在装 OpenClaw 之前先跑一遍这几条命令wsl --status wsl -l -vwsl --status会告诉你当前 WSL 的版本和默认发行版状态wsl -l -v会列出所有已安装的 Linux 发行版以及它们是 WSL1 还是 WSL2。如果状态不对先执行wsl --update wsl --set-default-version 2把默认版本切到 WSL2再重新检查。这一步真正做扎实了OpenClaw 在 Windows 上的体验会稳定很多。不要指望后面报错了再回头补因为很多错误提示根本不是“WSL 缺失”而是“某个功能无法安全验证”排查起来更费劲。2.4 要同步配好本地模型或 API 凭据算力渠道要在启动 OpenClaw 之前就配好而不是等它跑起来之后再想。本地模型路线推荐先用 Ollama。Ollama 的作用是把开源模型拉下来并提供一个本地接口。你可以先拉一个体积小、启动快的模型做测试比如 7B 级别甚至更小的版本。拉取命令类似ollama pull llama3 ollama listollama list能看到本地已有的模型确认模型就绪之后再去 OpenClaw 配置里把模型源指向http://localhost:11434这套本地服务。API 路线你要准备好自己的密钥并把它放到环境变量里而不是直接塞进 OpenClaw 的对话配置里。以常见的 Anthropic 风格环境变量为例export ANTHROPIC_API_KEY你的密钥Windows 用户可以在 PowerShell 里设置用户级环境变量这样每次打开终端都会自动加载。密钥配好之后在 OpenClaw 里指定模型名称和接口地址就能通过 API 方式使用算力。2.5 要让 Skill 先跑通内置再按需扩展OpenClaw 里一个非常重要的概念是 Skill。你可以把它理解成“给龙虾装配的专业工具包”有的 Skill 管文件读写有的管网页操作有的管跑脚本。Skill 不是越多越好而是越匹配越好。我的建议特别朴素先用默认自带的那几个 Skill 把一个完整任务跑通比如“帮我列出当前目录下的所有文件并按大小排序”。这个任务听起来简单但它会验证文件读写、命令行执行、模型调用三个核心链路是否正常。只有这三条链路都通了你才敢继续加新东西。跑通内置之后再按需添加自己的 Skill。自建 Skill 通常包含两部分一段描述“这个 Skill 是做什么的”的配置以及一段实际执行逻辑的代码或脚本。刚开始不要写太复杂的选一个你每周都会重复的操作把它做成 Skill才能体会到这东西的真正价值。2.6 要配置好 Windows Companion 并学会看日志Windows 用户在 OpenClaw 之外通常还需要一个叫 Windows Companion 的配套组件。它主要负责让 OpenClaw 能和 Windows 系统能力深度协作比如窗口管理、剪贴板、系统通知之类的。社区里经常有人问“Windows Companion 怎么配置”其实流程不复杂主要分三步先安装配套程序再在 OpenClaw 里启动配对向导然后按提示完成授权。配置完不要急着关终端打开日志功能看一眼。大多数运行问题都能在日志里找到线索比如某个 Skill 加载失败、某个模型接口超时、某个目录没有权限。我见过很多人出问题第一反应是去群里问但自己的日志里已经把原因写得清清楚楚了。养成“先看日志再提问”的习惯能省下大量时间。3. 六不要六个我劝你别踩的坑如果说前六条是“成功路径”那接下来这六条就是我替你蹚过的雷区。每一条都对应一个真实场景也是我在社区里反复看到的求助高发区。3.1 不要无视“无法安全验证 SL2 环境”这类报错很多人启动 OpenClaw 时看到“无法安全验证 SL2 环境。请在 PowerShell 中运行 wsl --status”这类提示第一反应是“可能没事先继续跑吧”。这个想法非常危险。我当时就这么跳过过一次结果 OpenClaw 能启动但一执行文件操作就卡死日志里的错误指向一堆第三方依赖无法加载我花了整整一个晚上才意识到根因是最开始那个 WSL 环境提示。后来我总结了一个排查链路你遇到同样问题可以直接照做第一步打开 PowerShell运行wsl --status看状态文本重点看有没有提示“默认版本”不对或内核过期。第二步运行wsl -l -v看发行版列表确认你准备给 OpenClaw 用的发行版是 WSL2而不是 WSL1。第三步如果版本不对执行wsl --set-version 发行版名 2或者干脆wsl --set-default-version 2。第四步运行wsl --update把内核更新到最新然后重启终端再启动 OpenClaw。这套链路里的每个命令都不是随便敲的先诊断、再定位、再修复、最后验证。跳过任何一步都可能只是把问题往后推。3.2 不要用旧版 Node.js也不要随便装依赖“旧版能用”是另一个大坑。很多教程写于不同时期你照着装的时候Node 版本可能已经差了一两年。OpenClaw 对 Node 版本有最低要求版本不够安装过程可能不报错但一启动就报语法错误或某个模块不存在。更隐蔽的是有些人在安装依赖时看到npm install报错就直接加--force或者--legacy-peer-deps强行跳过。我当时也这么干过确实能把依赖装上但运行时会冒出一堆兼容性问题查起来非常痛苦。正确的做法是先确认 Node 版本满足要求再删除node_modules和锁文件重新安装而不是强行动手“修”依赖关系。我的经验是安装依赖失败绝大多数时候不是网络问题而是版本不匹配。先升级 Node 到 LTS再看问题是否消失。这一步能省掉后面几个小时的排错。3.3 不要高估上下文窗口无限堆对话历史无论你用的是 API 还是本地模型都不要把一个超级长的对话历史直接丢给模型。尤其是本地模型上下文窗口本来就有限你塞得越多它越容易“遗忘”前面的指令还会让响应速度变慢。我踩过的具体场景是让 OpenClaw 读一个 1000 行的日志文件然后让它总结问题。结果它总结到一半就断掉了原因是整个日志被当成了上下文塞给模型。正确做法是先让它截取关键片段或者你自己用 grep 过滤后再交给它处理。上下文管理也是一种使用技巧。日常使用中每完成一个任务就主动开一个新会话不要让昨天的任务一直挂在同一个上下文里。这看起来是个很微小的习惯但对模型输出质量影响巨大。你少一点对话历史它就能多一点思考空间。3.4 不要把 API 密钥写死在全局配置里把密钥直接写进 OpenClaw 的全局配置文件这个操作在本地自己玩可能觉得没啥但要命的是很多人会把配置分享出去、或者把整个目录传到 GitHub 上。密钥泄露的后果不只是被刷掉额度更严重的是有人会拿着你的密钥去跑高消耗任务账单爆炸。每次想到这事我都觉得安全习惯比技术技巧更重要。我现在的要求很简单密钥一律走环境变量或者放单独的.env文件并且确保这个文件被.gitignore忽略。任何配置文件要分享出去之前先用工具扫一遍里面有没有sk-、key、token之类的字样。这个动作花不了两分钟但能避免绝大多数事故。3.5 不要一上来就装十几个 Skill 互相打架Skill 是 OpenClaw 的优势但也是新手最容易失控的地方。看到社区有人分享一个 Skill 就去复制一个装了一堆之后你会发现有的 Skill 抢占了同样的系统命令有的 Skill 加载顺序有依赖关系结果启动时一堆红色报错你根本分不清是哪出了问题。我建议你遵循“三明治原则”先只用默认 Skill 跑通一个任务再增加一个自己写的 Skill 跑通第二个任务最后把两个 Skill 放在一起跑第三个任务。如果第三个任务没问题再考虑加新东西。每次新增 Skill 之后都要做一次回归测试不是装上就完事了。很多“Skill 冲突”问题本质上是配置里对命令的声明互相覆盖。如果你发现两个 Skill 都声明了同一个操作不要保留两个选一个更明确的删掉另一个。Less is more在 OpenClaw 的 Skill 管理里尤其适用。3.6 不要在中文乱码还没处理时就开始调日志最后这个坑很小但很影响心态。Windows 终端默认编码有时候和 OpenClaw 输出的 UTF-8 字符不匹配你看到的中文日志全是乱码然后你会误以为程序坏了开始瞎改配置。我当时就是这么被误导的。后来发现只要在终端里执行一下chcp 65001把代码页切到 UTF-8日志立刻变得清清楚楚。更有意思的是乱码状态下我还以为某条日志是报错其实那只是一条普通的信息提示纯粹是编码问题让我看错了。所以在排查任何中文日志之前先确认终端编码是对的。这个动作成本几乎为零但能避免你把时间浪费在“读错日志”上。4. 复现一次完整部署从下载到跑通第一个 Skill前面说了这么多原则这一节我们把它们串起来完整走一遍部署流程。我的环境是 Windows 11 WSL2 Node.js LTS Ollama这个组合覆盖了大多数人的场景。4.1 先准备一张环境清单项目我用的版本 / 方案说明操作系统Windows 11Windows 10 也可以但 WSL2 体验不如 11 顺畅WSLWSL2 最新内核用wsl --update更新Node.js官方 LTS 版本不要用系统包管理器自带的旧版包管理器npm随 Node.js 一起安装本地模型Ollama 一个小模型先跑轻量任务再考虑更大的模型API 通道环境变量保存密钥不写死在 OpenClaw 配置里终端Windows Terminal乱码问题少还支持多标签这张表不是给你照抄的而是提醒你安装之前每一行都要能回答出“我准备用什么”。哪个格子空了就先补哪个不要带着缺口往下走。4.2 安装与初始化的完整命令流确认环境之后去 OpenClaw 官方仓库把仓库地址复制下来然后在 WSL 终端里操作。下面的命令是通用模板具体目录名以你拉到仓库时的 README 为准git clone OpenClaw官方仓库地址 cd OpenClaw目录 npm install npm run setupnpm install这一步可能会跑挺久取决于你的网速和依赖数量。期间不要开一堆并行任务去抢 CPU装完之后先运行npm run setup或 README 里指定的初始化命令它会引导你完成基础配置包括选择模型通道、填入密钥、检查环境。初始化完成之后先别急着配置几十个参数。直接跑一个最简单的能力测试比如请帮我列出当前目录下所有文件并按文件大小排序。如果它能正确完成这个操作说明命令行执行、文件读取、模型调用三条链路都通了。这是我推荐的第一个测试任务比让它写诗或者聊天更能验证核心功能。4.3 接入 Ollama 和 API 的实操流程接 Ollama 时先确认本地模型已经在跑ollama list看到目标模型后在 OpenClaw 配置里新增一个模型源指向本地接口。不同的版本配置方式不一样但核心字段无非是接口地址、模型名称、是否默认使用。我用本地模型做默认源之后日常任务响应速度非常快虽然复杂推理能力一般但胜在稳定、免费。接 API 时先把密钥写入环境变量然后在 OpenClaw 里指定对应的模型名称。这里有一个关键习惯不要把所有任务都走到 API像“列出目录”“读一下文件头部”这种操作用本地模型就够了。只有当任务需要真正的语义理解或生成内容时再切到 API。这样一个月下来API 费用会非常可控。4.4 配置 Windows Companion 并用日志验证Windows Companion 的配置入口通常在 OpenClaw 的设置面板里。你先安装配套程序然后在设置里发起配对按照提示完成授权配对成功之后它就能操作一些 Windows 系统级能力。配完立刻做一个验证让 OpenClaw 读取剪贴板内容。如果它能正确读出来说明 Windows Companion 的链路是通的。之后打开日志输出专门观察一次任务执行的完整过程。你会看到它先调用哪个 Skill、中间经过了哪些判断、最后返回了什么结果。这一步不是为了找 bug而是让你建立“它到底是怎么工作的”这个心智模型。有了这个心智模型后面任何问题你都能快速定位到具体环节而不是对着一个报错干瞪眼。5. Termux 手机版和日常使用补充OpenClaw 不只能活在电脑上也有人把它装进 Android 手机的 Termux 里实现“随身龙虾”。这个玩法适合应急场景比如你在地铁上突然想让它处理一个文本任务。5.1 手机上跑 OpenClawTermux 安装步骤Termux 是 Android 上的终端模拟器可以装 Node.js 和 npm。基本步骤是先更新包源再安装依赖pkg update pkg upgrade pkg install nodejs git node -v npm -v确认 Node 环境就绪后在 Termux 里把 OpenClaw 仓库克隆下来按同样的流程安装依赖和初始化。手机会比电脑慢很多尤其是编译类依赖所以建议选择依赖更少的轻量安装方式或者直接用官方提供的手机端脚本如果仓库里有的话。手机版的限制要认清屏幕小、键盘难用、后台进程容易被系统杀掉。它适合做“临时查看状态”“执行一个短任务”这样的轻量操作不适合长时间挂着跑复杂任务。我现在的习惯是电脑上的 OpenClaw 负责重活手机上的只用来偶尔远程看一眼日志或者应急执行一两条指令。5.2 日常使用建议把 OpenClaw 当搭档而不是搜索引擎很多人的使用模式是“像搜 Google 一样问它”问一句等结果不满意再换一种问法。这种模式不能说错但没有发挥出代理型工具的优势。更好的用法是“下目标”而不是“提问题”。比如你想整理一份资料不要问“帮我总结一下什么是 XXX”而是说“我需要一份关于 XXX 的摘要请先检查本地资料目录找到最近一周的文件提取核心观点输出成 Markdown 放到工作目录”。前者只是让它生成内容后者是让它调动工具完成一个真实任务。日常使用中常见的现象是“第一版结果往往不对”。这不一定是 OpenClaw 的问题而是它需要上下文反馈。你要像带新人一样给它补充信息“不对不要包括销售数据只保留技术指标”多轮修正之后它产出的质量会明显提升。这也解释了为什么同样的工具有人觉得好用、有人觉得是人工智障——差别大多在于使用姿势。最后再分享一点我自己的体会折腾 OpenClaw 这段时间最深的感受是它不是一个“装完就能用”的工具而是一个“养起来才有手感”的系统。前期花在 WSL 环境验证、Node 版本、模型通道上的时间后面都会以更少的排查成本回报给你。我自己因为偷懒跳过 WSL 检查搭进去一整个晚上所以才会把“六要六不要”写得这么啰嗦。如果你现在正准备动手我的建议是先从最小的闭环开始只装必装的东西只配一个模型只加一个 Skill跑通一个任务。等这个最小闭环稳定了再逐步往里面加能力。OpenClaw 真正可怕的地方不是它的报错而是它能在你面前展开一个庞大的配置宇宙——但你需要用到的可能只是其中很小一部分。最后一个小技巧每次修改配置或新增 Skill 之前先给当前能正常工作的配置做一个备份。这个习惯救过我很多次因为有些修改当时看似没问题跑几天后才会触发隐性错误。那时候你还能快速回滚而不是从头再折腾一遍。