news 2026/9/27 22:44:03

新手小白玩转OpenClaw必装的五个Skills:从Clawhub到本地settings.json配置全流程

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
新手小白玩转OpenClaw必装的五个Skills:从Clawhub到本地settings.json配置全流程

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 -v

npm 是随 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\skills

macOS 和 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 的创建和管理都在控制台完成,接入文档里有各语言的调用示例,遇到格式问题可以对照排查。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/27 22:41:18

VS Code Copilot 接入第三方 GPT Reasoning 模型:TaoToken 配置与避坑记录

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/27 22:40:39

哪些AI支持团队共同查看、评论和修改成果?

企业选用AI工具时,团队协作能力往往比单次生成质量更重要。很多独立AI工具只能单人编辑内容,成果需要下载导出后再通过文件传输分享,版本混乱、评论追溯困难。企业选型这类AI,核心要考察成果是否支持多人在线查看、实时评论、协同…

作者头像 李华