1. 为什么你的 OpenClaw 装完只会聊天
很多人第一次把 OpenClaw 跑起来,兴冲冲地打开对话框问它“今天有什么新闻”,结果它一本正经地编了一段去年的旧闻;让它帮忙整理桌面文件,它只会回复“我无法直接操作你的文件系统”。这不是 OpenClaw 不行,而是它出厂时就是个“裸机”——能理解语言,但没有手脚,也没有眼睛。
OpenClaw 本身是一个本地运行的智能体框架,它的能力边界由 Skills(技能包)决定。你可以把 OpenClaw 想象成一台刚装好系统的电脑,Skills 就是一个个软件:装了搜索技能,它才能联网查实时信息;装了浏览器技能,它才能打开网页点按钮;装了文件管理技能,它才能在你本地新建文件夹、读取文档。没有这些技能,它就只能靠训练时记住的知识跟你聊天,遇到需要“动手”或“查最新”的任务自然就卡住了。
这篇内容面向的是刚装完 OpenClaw、想让它真正干活的新手。我会带你从 Node.js 和 npm 环境检查开始,走完 Clawhub 的安装、五个必备 Skills 的逐条安装、settings.json 的骨架配置,最后接入 TaoToken 的统一 Key,让这些技能真正跑通。整个过程不需要你懂后端开发,只要会复制命令、改配置文件就行。实测下来,从零到五个技能全部可用,大概二十分钟。
2. 前置环境:Node.js 与 Clawhub 的安装确认
OpenClaw 的 Skills 生态依赖 Node.js 运行时和 Clawhub 这个包管理工具。Clawhub 相当于 Skills 的应用商店,你通过它来搜索、安装、更新技能包。所以在装任何 Skill 之前,先把这两个东西确认好。
2.1 检查 Node.js 版本
打开终端(Windows 用 PowerShell,macOS 用 Terminal),输入:
node -v如果返回的版本号低于 v18,建议去 Node.js 官网下载最新 LTS 版本覆盖安装。OpenClaw 的很多 Skills 用到了较新的 ES 模块特性,v18 以下容易在加载时直接报错。我本地跑的是 v22,兼容性没问题。
再确认一下 npm 是否可用:
npm -vnpm 是随 Node.js 一起安装的,正常情况都会有版本号输出。如果提示“命令未找到”,说明 Node.js 安装时没有勾选 npm 组件,重新安装一次即可。
2.2 安装 Clawhub
Clawhub 通过 npm 全局安装。Windows 用户建议用管理员权限打开 PowerShell,避免权限不足导致安装失败:
npm i -g clawhub安装完成后验证:
clawhub -v能输出版本号就说明 Clawhub 就绪了。如果提示“clawhub 不是内部或外部命令”,通常是 npm 全局路径没有加到系统 PATH 里。可以执行npm config get prefix查看全局安装目录,把这个目录手动加到环境变量中。
2.3 确认 Skills 存放目录
OpenClaw 默认从用户目录下的.openclaw/workspace/skills读取技能包。Windows 上大概是:
C:\Users\你的用户名\.openclaw\workspace\skillsmacOS 和 Linux 则是:
~/.openclaw/workspace/skills用 Clawhub 安装的 Skills 会自动放到这个目录,不需要你手动挪动。如果你之前手动下载过 Skill 压缩包,解压后把整个文件夹放进这个目录也能被识别。
3. 五个必备 Skills 的安装与 settings.json 骨架
下面这五个 Skills 是我认为新手最值得先装的组合:一个负责联网搜索,一个负责操作网页,一个负责记住你的偏好,一个负责长文提炼,一个负责本地文件管理。装完这五个,OpenClaw 才算真正有了“手脚”。
3.1 逐个安装五个 Skills
在终端里依次执行以下命令,Clawhub 会自动从仓库拉取最新版本并解压到 skills 目录:
clawhub install tavily-search clawhub install agent-browser clawhub install bio-memorypro clawhub install summarize clawhub install file-manager每装完一个,可以用clawhub list查看已安装列表,确认五个都出现了。如果某个技能安装时报网络超时,重试一次通常就能过,Clawhub 的源在国内访问偶尔会慢。
3.2 settings.json 骨架配置
Skills 装好后,需要在 OpenClaw 的配置文件里声明启用哪些技能,以及给需要外部 API 的技能填上 Key。配置文件位于.openclaw/settings.json,如果文件不存在就新建一个。下面是一个可直接复制的骨架:
{ "skills": { "enabled": [ "tavily-search", "agent-browser", "bio-memorypro", "summarize", "file-manager" ], "config": { "tavily-search": { "apiKey": "tvly-你的TavilyKey" }, "agent-browser": { "headless": false, "browserPath": "" }, "bio-memorypro": { "storagePath": "./memory/bio.json" }, "summarize": { "maxInputLength": 80000 }, "file-manager": { "allowedRoots": [ "C:/Users/你的用户名/Desktop", "C:/Users/你的用户名/Documents" ] } } }, "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoTokenKey", "model": "gpt-4o-mini" } }几个关键点说明。enabled数组里列出的技能才会被 OpenClaw 加载,没列出的即使装在目录里也不会生效。tavily-search需要一个 Tavily 的 API Key,去 tavily.com 注册后免费额度足够个人日常使用。agent-browser的headless设为 false 表示可以看到浏览器窗口,方便调试;如果你不需要看界面可以改成 true。file-manager的allowedRoots是安全限制,只允许 AI 操作你指定的目录,避免它误删系统文件,建议只填桌面和文档目录。
model部分就是接入 TaoToken 的地方。TaoToken 提供统一的 API 入口,兼容 OpenAI 格式,你只需要把baseUrl指向https://taotoken.net/api,填上在 TaoToken 控制台申请的 Key,就能让 OpenClaw 调用模型。这样五个 Skills 共用同一个模型入口,不用每个技能单独配一套。
3.3 申请 TaoToken Key 并填入
访问 TaoToken 控制台创建 API Key,复制后替换上面配置里的你的TaoTokenKey。如果你还没有账号,可以先在官网了解接入方式。Key 创建后建议先在一个测试文件里验证,确认能正常返回再写入正式配置。
4. 验证请求:逐条跑通 Skills 调用链
配置写好后,重启 OpenClaw,让它重新加载 settings.json。然后逐条验证每个技能是否真的可用。
4.1 验证 Tavily Search
在 OpenClaw 对话框输入:
帮我查一下今天佛山的天气如果配置正确,它会调用 tavily-search 返回实时天气数据,而不是编造一个答案。如果返回“技能未启用”或“API Key 无效”,检查 settings.json 里tavily-search的 apiKey 是否填对,以及enabled数组里有没有拼写错误。
4.2 验证 Agent-Browser
输入:
打开 example.com,把页面标题告诉我你会看到浏览器窗口弹出(如果 headless 设为 false),自动访问并读取标题。这一步常见的问题是浏览器驱动没装好,报错信息里会提示缺少 chromedriver 或 playwright 相关依赖。按照提示执行npx playwright install chromium即可补齐。
4.3 验证 Bio-MemoryPro
输入:
记住,我是做自媒体的,以后写东西要口语化一点然后新开一个对话,问它“你还记得我的写作风格吗”。如果它能复述出来,说明记忆已经写入本地文件。记忆文件默认存在./memory/bio.json,你可以打开看看结构,确认没有写入敏感信息。
4.4 验证 Summarize
找一篇长文链接丢给它:
总结一下这篇文章的三个核心结论它会调用 summarize 技能抓取正文并提炼。如果文章需要登录才能看,抓取会失败,这是正常限制,换一篇公开文章测试即可。
4.5 验证 File-Manager
输入:
在桌面上新建一个文件夹叫“测试素材”然后去桌面看是否真的出现了这个文件夹。如果报“路径不在允许范围内”,检查allowedRoots里有没有包含桌面路径,注意 Windows 路径要用正斜杠或双反斜杠。
5. 本篇常见错排查
装 Skills 的过程中,新手最容易卡在几个地方。下面按报错现象整理排查思路。
报错一:clawhub: command not found
说明 Clawhub 没有全局安装成功,或者 npm 全局路径不在 PATH 里。先执行npm i -g clawhub重装,再用npm config get prefix找到全局目录,手动加到环境变量。Windows 上这个目录通常是C:\Users\用户名\AppData\Roaming\npm。
报错二:Skill 安装成功但对话时提示“未找到技能”
九成是 settings.json 里enabled数组没写对。技能名必须和 Clawhub 安装时的名称完全一致,大小写敏感。可以用clawhub list确认实际名称,再对照修改。
报错三:Tavily 返回 401
API Key 无效或过期。去 tavily.com 后台重新生成一个,注意复制时不要带多余空格。填进 settings.json 后重启 OpenClaw 生效。
报错四:Agent-Browser 启动时报缺少浏览器
这是依赖没装全。在终端执行npx playwright install chromium,等下载完成后重试。如果网络慢,可以多试几次。
报错五:File-Manager 拒绝操作
检查allowedRoots是否包含目标路径。另外注意路径分隔符,Windows 上建议统一用正斜杠/,避免 JSON 转义问题。如果还是不行,把allowedRoots改成更具体的子目录再试。
报错六:模型调用返回 404 或超时
检查baseUrl是否写成了https://taotoken.net/api,末尾不要多加斜杠。apiKey 确认是 TaoToken 控制台生成的,不是其他平台的 Key。如果还是不通,去 TaoToken 的接入文档对照最新的 baseUrl 和模型名。
6. 让 Skills 组合起来干活
五个技能单独跑通只是第一步,真正提效的是把它们串起来用。比如你想写一篇推文,可以这样下指令:
先用 tavily-search 搜一下最近三天关于 AI 编程的新闻, 挑三条用 summarize 提炼成一句话, 然后按我之前的写作风格写成一段推文草稿, 最后在桌面新建一个“推文素材”文件夹把草稿存进去。这一条指令会依次触发搜索、提炼、记忆调用和文件写入四个技能。OpenClaw 会按顺序执行,你只需要在最后检查结果。如果中间某一步失败,它会告诉你卡在哪个技能上,对照第 5 节的排查方法处理即可。
如果你打算长期用 OpenClaw 做编码辅助或者跑自动化任务,可以考虑 TaoToken 的 Coding Plan,统一管理模型调用额度,省得每个技能单独配 Key。接入方式和上面 settings.json 里的 model 段一致,把 baseUrl 和 apiKey 换成 Coding Plan 对应的即可。模型对话可以在 TaoToken 的模型对话页面直接测试,确认 Key 和模型名没问题再写进配置。API Key 的创建和管理都在控制台完成,接入文档里有各语言的调用示例,遇到格式问题可以对照排查。