最近不少同行在群里聊起 OpenClaw,这个从年初就开始火的开源项目,到现在热度不仅没降,反而在程序员和技术爱好者圈子里越传越广。大家都在拿它搞自动化、搭智能体,甚至有人直接拿它跟 WorkBuddy 这类商业工具对比。作为从零开始踩过一遍坑、在 Windows、Ubuntu、手机上都折腾过的实战玩家,我觉得有必要把自己试过的方案、遇到的问题和最终的配置思路整理出来。这篇不打算写成官方文档的复读版,就把我实际操作的流程、参数选择逻辑和排查过程摊开讲,希望能给正在部署或者准备跑起来的你一点参考。
OpenClaw 本质上是一个开源的个人 AI 助理框架,它对标的是那些“需要一个大脑来控制你的电脑、手机和各类软件”的场景。你可以把 IMA(智能体管理架构)理解成一个接线员系统:它负责接住模型输出的自然语言指令,再把指令翻译成具体的工具调用和系统操作。如果你正好有一台服务器、一台旧电脑,或者干脆就是想在本地 Windows 环境里跑个自动化助手,这项目就很对胃口。
1. 项目概述:OpenClaw 是什么,它能替你做哪些事
OpenClaw 这个项目最近在 GitHub 上相当活跃。它的核心设计思路,是把大模型的能力跟本地系统的操作直接连接起来。说直白点,就是让模型不仅能“聊”,还能“干活”。你可以通过向它发出自然语言指令,让它帮你写文件、读邮件、操作浏览器、整理目录、甚至调用第三方 API 完成长链路任务。
1.1 从名字聊起,它到底解决什么问题
Claw 这个词在英文里有“抓取、钳制”的意思,OpenClaw 这个名字带点“把主动权抓在自己手里”的意味。这个项目解决的,正是很多开发者使用智能体时的痛点:云端的 AI 对话产品管不到你本地的文件系统,也碰不到你的应用窗口,更没法在断网环境下帮你处理本地任务。
它把大模型当作决策引擎,把工具集当成手脚。你告诉它“帮我把下载目录里所有的图片文件按月份归类”,它会先判断需要用到文件操作工具,再拆分任务,最后调用 Node.js 封装好的脚本去执行。跟纯聊天的模型比,OpenClaw 更接近“数字合伙人”的形态。
1.2 核心能力拆解:为什么它被拿来对标一堆商业工具
热词里提到 WorkBuddy 这类工具是否参考了 OpenClaw,这个话题我先不展开,留到后文专门讲。这里先把 OpenClaw 的核心能力拆出来看:
- 多模型接入:它本身不内置模型,而是通过 API 方式对接各种 LLM,包括 OpenAI 兼容接口、Ollama 本地模型等。这意味着你也可以直接用 qwen2.5 这类开源模型驱动它。
- 工具调用(Skills / MCP):支持动态加载技能模块,每个技能就是一段可以被模型调用和编排的代码逻辑,覆盖浏览器、文件系统、终端、微信等日常操作。
- 跨平台跑:Node.js 写的,Windows、macOS、Linux 都能跑,甚至在 Termux 环境下也能安装,算把手机变成智能终端的一种新玩法。
- 会话与记忆:能保存多轮对话的上下文,对长时间、多步骤的任务拆解支持比较友好。
所以你要问“OpenClaw 能做什么”,我会回答:凡是你能通过命令行和 API 实现的自动化,它基本都能以自然语言为入口编排出来。这才是它吸引程序员的核心点——因为天花板不在软件上,在于你对工具链的想象空间。
1.3 一个典型的 OpenClaw 应用场景
我前几天跑通的一个例子,可能更能说明问题。我要写一份周末露营装备清单,同时还要确认当地天气。传统做法是去天气网站查,再复制到笔记软件。用 OpenClaw,我只输入:“帮我生成露营装备清单,并告知周日晚上是否有雨。”
内部的执行逻辑是:先调用 Web Search Skill 查询当地周日天气,然后通过 Prompt 模板生成清单文本,最后调用 File Skill 把内容存到指定目录的 Markdown 文件里。整个过程不需要我手工介入一个步骤,它的价值就体现在这:把需要 3~5 个软件协作完成的工作,压缩成一个自然语言的指令。
正是基于以上这些判断,我建议对自动化、智能体开发、本地方案落地感兴趣的开发者都值得上手玩一玩。接下来直接进正题,讲部署过程中最关键的几道门槛。
2. 环境准备:部署前必须先过这几道坎
很多人一上来就卡在环境上,还没看到安装成功的控制台输出就放弃了。其实 OpenClaw 的运行环境要求不算高,但有几个前置项确实容易出问题。这里先讲最容易踩坑的三个环节。
2.1 Node.js 版本与包管理器的选择
新版 OpenClaw 对 Node.js 的版本有明确要求。太老的版本会直接报语法错误,太新的版本又会跟部分原生依赖有兼容性问题。经过多次实际测试,我建议锁定 Node.js 18 LTS 或 20 LTS,不要用最新的 21+ 跑生产用途,除非你就想折腾。
安装 Node.js 时,我推荐用 nvm 而不是系统自带的包管理器直接装。原因很简单:nvm 可以同时保留多个版本,出问题时瞬间切换。在 Ubuntu 上的操作是:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 18 nvm use 18Windows 环境则直接去官网下载安装包,但注意安装后要确认 PATH 环境变量里包含 node.exe 所在目录。有个小技巧:在 PowerShell 里运行node -v能正常返回版本号,才代表环境变量没问题。
包管理器方面,项目使用的 npm 和 pnpm 都能跑。我建议 pnpm,因为它的依赖安装速度确实比 npm 快不少,而且能省空间。装上 pnpm 后,安装 OpenClaw 依赖的命令会更快、更稳,别因小失大。
提示:如果非要用 npm,请在安装前清掉 npm 缓存,
npm cache verify一下,再执行安装,能少很多莫名报错。
2.2 Windows 上的 WSL2 环境坑点(此处放热词中的报错)
平台环境坑主要出现在 Windows。我看到热词里有一条:“无法安全验证 WSL2 环境。请在 PowerShell 中运行 wsl -- status,解决报告的问题。”这个报错我在第一次部署时也撞见过,印象很深刻。
当时我在 Windows 11 上用 PowerShell 装 OpenClaw,装到一半系统提示需要 WSL2 环境,但检查状态时发现 WSL 根本没启用。排查过程很简单:
- 打开 PowerShell(管理员模式)。
- 运行
wsl --status,结果输出提示未安装 WSL 内核。 - 执行
wsl --install,它会自动安装最新内核并启用虚拟化平台。 - 重启电脑,再次打开 PowerShell 运行
wsl --status,看到“默认版本: 2”即为正常。
这个问题之所以让很多人卡住,是因为 OpenClaw 的部分自动化工具(尤其是容器和浏览器操作相关组件)依赖 WSL2 提供 Linux 子系统环境。你要是在普通 Windows 环境下跑,这些组件会静默失败,甚至不报错,导致后续安装流程中断。好,WSL2 弄好之后,还有个小细节是 Windows 下跑 OpenClaw 的路径兼容问题。
2.3 Windows 原生运行与路径兼容的小细节
在 Windows 上,即便你通过 WSL2 解决了 Linux 子系统问题,主程序的运行目录选择也有讲究。OpenClaw 会读取当前工作目录来生成配置文件和技能目录,如果目录带中文名、空格或特殊符号,部分工具会发生路径解析错误。我之前把它放在C:\Program Files (x86)下,结果 File Skill 一直找不到默认目录,后来移到D:\dev\openclaw就正常了。
建议把所有 OpenClaw 相关目录保持纯英文路径,避免 Unicode 兼容问题。这一点对后续部署技能模块尤其重要,因为不少技能内部会调用 shell 命令拼接路径,空格容易被当成参数分隔符。
另外 Windows 下建议直接用 Windows Terminal 跑,比老旧的 CMD 对彩色输出和长路径支持好得多。环境这块准备好,就可以进入安装阶段了。
3. 安装与配置流程:三种主流方式实操对比
安装方式取决于你的运行平台和需求场景。我三种都试过:Ubuntu 服务器模式最轻量、最稳定;Windows 本地模式适合日常操作自动化和个人助理;手机 Termux 模式则比较极客,适合远程轻量任务。把它们放在一起对比,你更好判断自己该走哪条路线。
3.1 Ubuntu / Debian 下的标准安装步骤
我的主力实验机是 Ubuntu 22.04,这套安装流程我已经跑过两遍,可以放心抄作业。前提是你已经装好 Node.js 18 和 pnpm。
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install cp .env.example .env # 编辑 .env,填入模型 API 配置 pnpm start第一次启动后,OpenClaw 会在目录下生成data文件夹,里面存放会话记录、日志和技能配置。如果你是在云服务器上部署,记得用 firewall 放行服务端口,默认地址是127.0.0.1:3000,外网访问需要改 HOST 和防火墙规则。
这里有个容易忽视的点:不要用 root 用户直接跑pnpm start。某些技能模块在检测到 root 权限时会切换受限模式,导致功能不完整。如果你只有 root 账号,建议新建一个普通用户再操作。安全起见,建议不要把凭据、密钥写死在.env文件里,如果只是本地开发还好,一旦涉及服务器,一定要校验好文件权限。
3.2 Windows 原生安装与 Companion 配置
Windows 原生安装分两步:一是安装主程序,二是配置 Windows Companion 组件。很多人跳过第二步,导致“能用但没法操作窗口”。
Companion 是 OpenClaw 在 Windows 下执行 GUI 自动化时依赖的桥梁服务。安装方式是在项目目录下运行:
node setup-windows-companion.js它会检查 WSL2 状态、安装必要的 Visual C++ Redistributable、并注册一个 Windows 服务。配置完成后,Companion 服务默认监听127.0.0.1:18080,OpenClaw 会通过这个端口发送窗口控制指令。
我实测过没装 Companion 时,OpenClaw 能正常对话,但一旦下达“打开记事本并输入内容”这类需要真实窗口操作的指令,就会返回错误码。装了之后,这类操作才算真正跑通。
3.3 手机 Termux 上的运行玩法
热词里提到 Termux 手机版安装 OpenClaw,我在备用安卓机上测试过,结论是:能跑,但只适合轻量任务,别指望手机上处理复杂 PDF 或者高强度运算。
Termux 安装的坑主要是依赖权限和 Node 编译。至少需要 Android 10 及以上系统,在 F-Droid 或 GitHub 下载 Termux(不建议用 Play 商店版,太旧)。
pkg update pkg install nodejs nodejs-lts git git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm start手机的存储空间有限,建议把 OpenClaw 目录放到~/storage/shared/下,也就是共享存储位置,这样文件操作技能能访问到手机上的真实文件。跑起来后,手机相当于一个随身智能终端,你可以在电脑上通过局域网 IP 访问它的控制台。
不过说句实在话,手机版本的实用性上限目前还是偏低。主要原因在于 ARM 架构下部分工具编译需要交叉编译,稳定性打折,长时间运行机身发热也比较明显。如果只是尝鲜,完全可以跑通;如果想跑 7x24 小时服务,还是上云服务器或者老旧笔记本更省心。
3.4 .env 配置文件里的关键参数解读
安装跑起来只是第一步,配置才是决定体验的核心。.env这个文件是 OpenClaw 命令中枢的参数表,几乎所有的模型配置、服务参数、API 端点、日志级别都在这里定义。就像一份电器的电路接线图,你接错一条线,表面上可能没冒烟,但某个功能就是永远不工作。
最关键的几项配置我在下方列出解说:
| 配置项 | 我的推荐值 | 说明 |
|---|---|---|
LLM_PROVIDER | openai | 模型服务类型,兼容 OpenAI 协议的都可以填 |
LLM_API_KEY | sk-xxxx | 你的 API 密钥,不要泄露,也别提交到 Git 仓库 |
LLM_BASE_URL | 按服务商提供 | 自定义端点地址,接本地 Ollama 时填http://localhost:11434 |
LLM_MODEL | qwen2.5-3b或gpt-4o-mini | 模型名,要和你的服务商实际支持列表一致 |
HOST | 127.0.0.1 | 监听地址,局域网访问需改0.0.0.0 |
PORT | 3000 | 控制台端口 |
LOG_LEVEL | info | 调试时改为debug,能拿到更多线索 |
2025 年你这套配置没升级的话,OpenClaw 在启动时会警告模型列表里没有匹配项,但不会拒绝启动。真正的问题出在对话时——它会反复报 401 或 404。所以配置模型名的时候,一定要去你用的服务商后台确认准确的模型标识符。
注意:.env 文件属于高敏感信息,务必确认它被
.gitignore忽略。如果公开仓库里出现 API Key,不仅会产生不必要的计费风险,还可能被爬虫扫描侧录。
好,预编译环境、系统目录、配置参数都备齐了,接下来就到了最关键的一步——模型接入。相信这也是很多从“API 只能云端调用”这个疑虑中走出来的开发者最关心的部分。
4. 模型接入:API 调用与本地 Ollama 部署
热词里有一条很醒目:“OpenClaw 只能用接入 API 的方式使用算力吗?”答案是否定的。它可以直接接本地模型,把推理算力拉到自己的机器上跑。我分别试过云端 API 和本地 Ollama 两种路线,各有适用场景,直接把过程和取舍心得写出来。
4.1 为什么 OpenClaw 不限定单一模型
从架构设计上看,OpenClaw 在设计时就把模型层抽象出来了,好处是可以随时切换到不同厂商的服务,不用改业务逻辑。你把底层模型从 GPT 换成通义千问,再从通义千问换成本地 Llama,对上层技能来说,接口都是兼容的,无感切换。
当然这种灵活性也带来一个新问题:模型能力直接影响整个智能体的言行。OpenClaw 本身不算“大脑”,它更像调度员。模型太弱,你让它调用工具就会漏参数;模型强一些,就算指令模糊它也能猜出你要干嘛。所以配置模型这一环节,与其说是技术部署,不如说是给整个系统选智商基线。
4.2 OpenAI 兼容 API 的配置方式(线上算力)
以接入 OpenAI 兼容 API 为例,你在.env里这样设置:
LLM_PROVIDER=openai LLM_API_KEY=你的Key LLM_BASE_URL=https://api服务商地址 LLM_MODEL=gpt-4o-mini它内部会通过 HTTP 发送 Chat Completions 请求,OpenClaw 拿到流式返回后按工具调用格式解析。之所以云 API 方案最稳,是因为主流厂商的模型推理能力持续在线,你本地不用占用显卡和内存资源,OpenClaw 启动速度、响应速度都不错,适合生产或 7x24 小时服务。
不过用云端 API 也有两个需要注意的点:
- 延迟把关:OpenClaw 要求工具调用结果必须在“限时窗口”内返回。云端 API 如果遇到高峰期排队,可能造成超时重试,拖慢链路。根据我的测试,网络延迟低于 200ms 才是比较舒服的体验区间。
- 上下文窗口:长任务的上下文会越滚越长,小窗口模型容易丢历史信息。建议选择至少 16K 上下文窗口的模型,效果会好很多。
4.3 用 Ollama 部署 qwen2.5 等本地模型的实操(本地算力)
如果你追求数据不出本机,或者想不依赖外网 API,直接上 Ollama 就成了。Ollama 是一个本地大模型跑推理的工具,安装之后可以快速拉取 qwen2.5 等开源模型。
Ollama 安装(Linux / macOS 都可以):
curl -fsSL https://ollama.com/install.sh | sh ollama pull qwen2.5:3b运行 Ollama 服务之后,回到 OpenClaw 的.env:
LLM_PROVIDER=ollama LLM_BASE_URL=http://127.0.0.1:11434 LLM_MODEL=qwen2.5:3b接好之后,需要确认 Ollama 是否真正允许跨进程访问。如果 OpenClaw 和 Ollama 在同一台机器上,默认配置就能通;如果不在同一台机器,例如 Ollama 跑在 Windows 宿主机,OpenClaw 跑在 WSL2 里,你要给 Ollama 设环境变量OLLAMA_HOST=0.0.0.0才能让 Linux 子系统访问到。这个坑我花了半小时才定位到。
选择 qwen2.5 这个模型来驱动 OpenClaw,并不是因为它最强,而是因为它在小参數量级下工具调用成功率较高。我实测下来,写代码、读文件、生成结构化 JSON 这些任务表现及格,尤其适合个人服务器和终端场景。如果你有 RTX 4090 这种大显存设备,可以换更大的模型,例如 qwen2.5:14b,或者 Llama 3 系,效果会有明显提升。
4.4 什么时候该选哪种算力方案
这里给出一个直观的判断表,考虑因素包括数据隐私、C 端成本、响应速度和硬件投入:
| 维度 | 云端 API | 本地 Ollama |
|---|---|---|
| 部署难度 | 低,填 Key 就能跑 | 中,要装 Ollama 且配置模型 |
| 数据隐私 | 数据要上传到第三方 | 数据留在本地 |
| 单次成本 | 按 Token 计费,需持续付费 | 只有电费,无 API 增量费用 |
| 离线可用 | 不行 | 可以 |
| 延迟 | 依赖网络 | 依赖本地硬件 |
| 推荐场景 | 正式服务、高精度任务、快速上手 | 内网环境、隐私敏感任务、学习折腾 |
回到那个“能不能只用 API”的疑问,我这里很明确:OpenClaw 不存在“只能接 API 才能用算力”的说法。之所以很多教程默认 API,是因为配置起来最短路径,不需要跟本地模型打交道。但如果你想玩得更透,本地推理才是完整形态。给模型接了头,下一步就是把 OpenClaw 的能力上限进一步打开。它的 Skill 机制就是干这个的,也是很多人津津乐道的,说它能“长出手脚”的部分。
5. 深度玩法:Skill 机制与 WorkBuddy 式工具链的关联
配置好模型,OpenClaw 只能算“能对话”。真正让它跟普通聊天机器人拉开差距的,是 Skill(技能)机制。这也是你在热搜词里看到的 “openclaw skill” 频繁被提到的原因。从我的角度看,Skill 有点像是给机器人增加外挂功能包,每个 Skill 都包含了一套特定指令的执行逻辑。
5.1 Skill 到底是怎么工作的
从开发者视角看,一个 Skill 其实是一个文件夹,里面包含一个skill.md,主要描述技能用途和参数,以及对应的 JavaScript 或者调用外部命令的脚本。OpenClaw 在收到用户指令后,会在系统提示词里注入所有已安装 Skills 的描述信息,模型根据描述判断哪个 Skill 适合当前任务,再生成对应的调用请求。
拿我装过的file-managerSkill 举例,它的目录结构大致如下:
skills/ file-manager/ SKILL.md index.jsSKILL.md是让模型理解技能的地方:
# 文件管理技能 支持列出目录、读取文件内容、写入文件、复制/移动/删除文件。 参数: path, action, contentindex.js则负责真正执行文件操作逻辑。当我说“帮我把下载目录下所有 PNG 图片移动到图片备份目录”,模型会识别出应该调用 file-manager,并把参数传给它,最后由 JS 脚本跑完整个移动动作。我测试下来,这种“模型负责决策、脚本负责执行”的分层结构的好处是:模型不怕算错路径,脚本保证操作安全。
5.2 如何安装和编写自己的 Skill
安装一个 Skill 非常简单,把文件夹放进skills目录并重启即可。如果是网上找的 Skill,通常是 Git 仓库格式,直接克隆:
git clone https://github.com/example/openclaw-skill-web-search.git skills/web-search然后重启 OpenClaw,再看日志里是否出现Loaded skill: web-search。
但如果你想自己写一个,就要注意模型限制这一步。Skill 描述写得好不好,直接决定触发率。一个 Skill 如果描述模糊,模型容易忽略它或者误触。好的描述应当包含“什么时候用”“能做什么”“参数是什么”,比如:
# 天气查询技能 当用户询问天气情况时使用,支持城市名称查询、未来 7 天预报。 参数: city (required), days (optional)伪代码逻辑示例:
module.exports = async function weather({ city, days = 1 }) { const response = await fetch(`https://api.example.com/weather?city=${city}&days=${days}`); return response.json(); };写 Skill 的难点不在代码本身,而在于让工具输入/输出严格遵循 JSON 格式。模型喜欢把参数以字符串形式传递,如果代码里没做类型校验,就会生成一个 “今天下雨” 的字符串字符串塞进对象里,引发解析错误。所以稳妥写法是在入口处做参数清洗,比如将String转小写、去空格、转数字等。这类细节建议在标准技能模板里提前写好,避免后期反复修。
5.3 把它变成 WorkBuddy 式工具,时间线是否对得上
热词里有一条很有意思:“WorkBuddy 这种是不是也都参考了 OpenClaw 才搞出来的?你觉得时间对得上吧?”这类工具的时间线我没法下断言,但可以说,这类“自然语言指挥电脑干活”的产品形态在 2024~2025 年之间确实集中爆发。OpenClaw 不是第一个这么做,但它是少数把架构做开源而且社区生态做起来的项目。
从功能层面看,WorkBuddy 式的商业工具通常提供:浏览器自动化、表单填写、信息提取、桌面窗口操作、邮件处理、日历管理。这些能力大多数在 OpenClaw 的 Skill 生态里都能找到对应,核心差异更多是在产品化封装上:商业工具往往提供更友好的界面、更完善的错误提示和客户支持,而开源项目则给了你完全的自由去改代码和设计自己的流程。
如果你不想用现成商业工具,想自己攒一套“WorkBuddy 式”的工作流,思路很简单:
- 基础:装好 OpenClaw,接入适合你场景的模型(建议本地部署)。
- 扩展:安装浏览器操作相关的 Skills(如 Playwright 驱动),赋予它操控网页的能力。
- 定制:按你的业务习惯写一批特定 Skills,比如财务单据识别、项目进度汇报、会议纪要生成。
- 集成:通过 Webhook 或者定时任务,把 OpenClaw 接入到现有的钉钉、企业微信或飞书机器人上。
其实从时间线判断,开源社区和商业化产品之间互相参考是很正常的事。不用太纠结谁先谁后,你只要记住:OpenClaw 提供的是底层能力,你把 Skill 组合到极致,就能得到一个完全属于你自己的智能工作助理。这一点,目前还是同价位商业工具给不了的。
6. 常用问题排查与经验技巧:实测避坑清单
最后这部分是整套文章含金量最高的地方。我在部署、配置、卸载和长期运行过程中攒了一批问题和解法,这里整理成实战记录。你可以直接收藏,遇到问题翻出来对照处理。
6.1 “无法安全验证 WSL2 环境”:最快处理路径
回到热词里那条最具体的报错:openclaw 无法安全验证 WSL2 环境。请在 PowerShell 中运行 wsl -- status,解决报告的问题。这报错常见于 Windows 原生安装的 Companion 校验阶段。处理路径我总结成三条:
- 确认虚拟化开启:进入 BIOS,确认 Intel VT-x 或 AMD-V 已开启。没开的话,WSL2 无论如何都无法启动。
- 完整重装 WSL:
wsl --unregister Ubuntu之后再wsl --install -d Ubuntu,能解决大部分环境残留问题。 - 判断用户权限:PowerShell 必须“以管理员身份运行”,否则
wsl --status无法修改内核参数和注册系统服务。
提醒:和 Docker Desktop 的冲突也需要留意。部分版本 Docker 会接管 WSL 发行版,导致 OpenClaw 的 WSL 判断异常。解决办法是设置 Docker 只使用自定义发行版,或者索性把 OpenClaw 放进 Docker 容器中运行。你如果还没到这么复杂的阶段,呢专注于 WSL 即可。
6.2 模型一直不响应:Key 与 base_url 核对清单
OpenClaw 连上模型服务以后,最常遇见的,就是“能聊但命令永远不执行”。这种情况多半不是代码问题,而是模型配置与服务的 API 协议细节对不上。按这张表逐项排查,能解决八成问题。
| 现象 | 根因 | 解法 |
|---|---|---|
| 401 Unauthorized | API Key 配错或有泄漏被平台拒绝 | 重新生成 Key 并检查 .env |
| 404 Not Found | base_url 指错路径 | 去服务商文档核实/v1/chat/completions |
| 工具调用参数变成字符串 | 模型理解弱,把 JSON 转成了描述文本 | 换更大参数模型,或优化 System Prompt 强调输出格式 |
| 超时无响应 | 模型负载高或网络阻塞 | 调高LLM_TIMEOUT值,或切换到本地 Ollama |
| 出现乱码回复 | 上下文窗口不够,截断了输出 | 减小 SYSTEM_PROMPT 长度,或换长上下文模型 |
排查的优先顺序是:Key → base_url → 模型名 → 上下文长度。每一步都能通过控制台日志和直接 curl 调用 API 的方式验证。先确认底层 API 能返回合法 JSON,再谈 OpenClaw 的上层解析。
6.3 卸载 OpenClaw:干净彻底的方法
这里的热词出现了“怎么卸载 openclaw”,说明想卸载的人也不少。我在测试不同平台时,同样经历过清理不干净的场面。所谓“卸载”,不只是删目录,还包括环境变量、服务注册和缓存数据。
Linux 下建议这样清理:
# 停掉 OpenClaw 相关进程 pkill -f openclaw # 删除主目录 rm -rf /path/to/openclaw # 清理 npm 全局链接 npm uninstall -g openclaw 2>/dev/null # 清理日志目录(按需) rm -rf ~/.openclawWindows 环境下,先在“服务”控制台里停止 OpenClaw Companion,然后:
sc.exe delete OpenClawCompanionTermux 手机上则直接删目录,不用太纠结全局链接。
提示:如果你添加过自定义 Skill,记得留一份备份到独立 Gist 或者网盘。我觉得后续你还会回头再玩的,因为这类项目的版本迭代特别快,过几个月安装方式可能完全不一样。
6.4 实用经验:跑 OpenClaw 的三个日常建议
最后分享三个让我少走弯路的小习惯:
第一,多用 Docker 而不是裸机进程。我第一次部署时直接跑在 Ubuntu 宿主机上,结果日志文件膨胀得飞快,一周占了几 GB 磁盘。后来改成容器化部署,挂载独立卷,做日志轮转,机器一直保持“干净”状态。如果你只是临时体验,就用裸机;长期用或者放到服务器上生产,优先 Docker Compose 方案。
第二,给每个 Skill 都要写“失败返回模板”。这一点是我自己写 Skill 踩痛点后的深度总结。OpenClaw 在模型调度时经常会把执行失败归因于模型超时,如果技能本身能在出错时返回结构化错误 JSON,例如{status: "error", code: "FILE_NOT_FOUND"},上层就能顺利感知并重新生成修正方案,形成闭环。
第三,关注项目的 Release Notes。这个项目迭代节奏很快,间隔两周就可能有 breaking change。切记不要直接用git pull覆盖本地修改过的 Skill 代码,否则会遇到提交冲突。我在一次大版本更新后,本地改了三个 Skill 的文件,结果一个都没保留,只能重新写,损失了一晚上的时间。
文章写到这里,我更想强调的是:OpenClaw 这类工具的能力上限,并不取决于框架本身,而是你能不能为它设计出贴合自身工作流的技能组合。你可以从一个简单的文件整理技能开始,跑通流程后再加浏览器操作、再加微信联动、再加数据汇总,它就能不断适应你的工作习惯,成为一个像团队成员一样的执行端。我实际用下来的体会是,最难的不是安装,也不是环境配置,而是培养自己“把想到的任务拆成技能丢给机器去做”的思维方式。一旦你习惯了这种协作模式,就很难再回到以前那种手动点开的重复操作里了。最后再分享一个小技巧:刚接触 OpenClaw 时不必贪多,保持模型精简,先稳定跑通关键的 3 个 Skill,后续再根据实际使用中遇到的重复事务,逐步扩展技能库——这样既不会把自己淹没在工具配置的汪洋里,又能最快感受到自动化带来的生产率变化。