在前面的測試中搞定兩個最常用的頻道 Telegram 與 LINE 之後, 接下來要安裝 Skills, 這是用來擴充 OpenClaw 能力的模組, 雖然 OpenClaw 透過 AI 模型已具有基本的通用能力, 例如回答問題, 語言翻譯, 文本生成, 以及圖像辨識等等; 但諸如播放音樂, 查詢天氣股市, 寄送 Email, 操作谷歌日曆等與外部服務互動的能力卻是 AI 模型所欠缺的, 這就需要用 Skill 來達成.
在 "
OpenClaw 超入門" 這本書中, 作者以手機來比喻, 手機自身的能力是打電話與拍照等, 但訂餐就需要安裝 Uber Eat 或 Foodpanda 等 App 才行, 這些 App 就相當於是手機的 Skills. 而 "
OpenClaw 超級龍蝦煉金術" 一書的作者則用餐廳來比擬 OpenClaw 整個系統, Gateway 相當於負責迎賓, 點菜, 上菜的外場服務生; LLM 模型 (AI Core) 相當於決定怎麼做菜的主廚; 而 Skills 則是象徵餐廳能力的食譜.
1. 安裝 Clawhub CLI 套件 :
Clawhub 是 OpenClaw 的官方 Skills 註冊網站, 網址如下 :
可見此網站除了收集 skills (技能) 外還有 plugins (外掛), 兩者的差別是 :
- Skills :
屬於 Agent 認知層的能力指令或提示詞範本, 它定義 AI 該如何思考, 遵循什麼步驟, 以什麼格式回應等等, 例如股票技術指標分析工作流, 特定風格的文本創作, 程式碼重構 SOP 等. Skills 通常是輕量級的純文字, Markdown 或 YAML 配置, 不一定包含複雜的執行程式碼, 主要依賴大模型自身的推理與既有工具來完成任務. - Plugins :
屬於 System 或 Runtime 系統層的擴充軟體包, 它賦予 OpenClaw 全新的外部執行能力或底層介面, 例如擴充新的通訊頻道, 新增硬體控制介面, 整合第三方 API (如 DALL-E 產圖, 即時金融報價爬蟲), 或掛載向量資料庫等. Plugins 包含具體的執行代碼 (Node.js, Python 等), 需要安裝套件相依性, 並直接掛載於 OpenClaw Gateway 的生命週期內.
本篇的主角是 Skills, 它是 OpenClaw 中的高階工作流程指南或教學手冊, 它本身不提供新的能力, 而是教 AI 助理如何有效組合運用 read, write, exec 或其他工具來完成特定之任務. 製作 Skills 不需要寫程式, 不需要安裝複雜套件, 只要用 Markdown 語法將執行任務的步驟描述清楚即可.
安裝 Skills 可在終端機使用內建的 openclaw skills install 指令直接安裝; 或者先安裝 clawhub CLI 套件, 再用它來安裝 skills, 若打算大量嘗試社群中現成的豐富功能建議使用 clawhub CLI 套件, 因為內建的 openclaw skills install 指令較陽春, 若 Skill 依賴特定 Plugin 或 Python/Node 套件, 通常需手動補安裝依賴, 在 Skills 管理上較不方便.
安裝 clawhub CLI 套件的指令如下 (因我用 nvm 管理的 Node.js 故不需要 sudo) :
npm install -g clawhub
pi@pi4b:~ $ npm install -g clawhub
added 47 packages in 8s
22 packages are looking for funding
run `npm fund` for details
npm notice
npm notice New major version of npm available! 11.13.0 -> 12.1.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.1.0
npm notice To update run: npm install -g npm@12.1.0
npm notice
安裝完可用 clawhub 指令附 --cli-version 參數檢視版本 :
pi@pi4b:~ $ clawhub --cli-version
0.23.3
完整的指令說明可用 --help 參數查詢 :
pi@pi4b:~ $ clawhub --help
🦞 ClawHub CLI v0.23.3
Usage: clawhub [options] [command]
install, update, search, and publish skills plus OpenClaw packages.
Options:
-V, --cli-version Show CLI version
--workdir <dir> Working directory (default: cwd)
--dir <dir> Skills directory (relative to workdir, default: skills)
--site <url> Site base URL (for browser login)
--registry <url> Registry API base URL
--no-input Disable prompts
-h, --help Display help for command
Auth:
login [options] Log in with device flow or store a token
logout Remove stored token
whoami Validate token
auth Authentication commands
Commands:
token Print stored API token
scan [options] [path] Run or download ClawHub scan reports
help [command] Display help for command
Skills:
search [options] <query...> Search skills
install [options] <skill> Install a skill into <dir>
update [options] [skill] Update installed skills
uninstall [options] <skill> Uninstall a skill
list List installed skills (tracked and manually installed)
pin [options] <skill> Pin an installed skill so update commands skip it
unpin <skill> Remove a skill pin so updates can change it again
explore [options] Browse latest updated skills from the registry
inspect [options] <skill> Fetch skill metadata and files without installing
star [options] <skill> Add a skill to your highlights
unstar [options] <skill> Remove a skill from your highlights
Publishing:
publish [options] <path> Legacy alias: publish a skill from folder
skill Manage published skills
publisher Publisher organization commands
sync [options] Scan local skills and publish new or changed ones
Moderation:
delete [options] <skill> Soft-delete a skill or withdraw one version
hide [options] <skill> Hide one of your skills
undelete [options] <skill> Restore a hidden skill or an owner-withdrawn version
unhide [options] <skill> Unhide one of your skills
transfer Transfer skill ownership
Packages:
package Browse and publish OpenClaw packages
Env:
CLAWHUB_SITE
CLAWHUB_REGISTRY
CLAWHUB_WORKDIR
(CLAWDHUB_* supported)
常用的 clawhub 指令如下表 :
|
ClawHub 指令
|
說明
|
| clawhub login |
登入 ClawHub，透過瀏覽器或 API Token 進行認證。 |
| clawhub logout |
登出目前帳號並移除本機 Token。 |
| clawhub whoami |
顯示目前登入帳號資訊並驗證 Token。 |
| clawhub search 關鍵字 |
搜尋 ClawHub 技能庫中的 Agent Skills。 |
| clawhub explore |
瀏覽最新上架或熱門 Skills。 |
| clawhub inspect @owner/skill |
查看 Skill 的詳細資訊、版本與檔案內容。 |
| clawhub install @owner/skill |
安裝指定 Skill 至本地工作區。 |
| clawhub uninstall skill |
移除已安裝 Skill。 |
| clawhub list |
列出目前工作區已安裝的 Skills。 |
| clawhub update |
更新所有已安裝 Skills 至最新版本。 |
| clawhub update skill |
更新指定 Skill。 |
| clawhub publish ./skill-folder |
將本地 Skill 發布到 ClawHub Registry。 |
| clawhub sync |
同步本地 Skills，發布新增或更新內容。 |
| clawhub star @owner/skill |
加入我的收藏。 |
| clawhub unstar @owner/skill |
取消收藏指定 Skill。 |
| clawhub token |
顯示目前儲存的 API Token。 |
| clawhub --help |
顯示完整說明與所有可用指令。 |
| clawhub --version |
顯示目前 ClawHub CLI 版本。 |
其中黃底色者為較常用的指令, 最常用的指令當屬安裝 skill 的 clawhub install, 以及用來搜尋 skill的 clawhub search.
用 clawhub list 檢視 skills 結果應該為空 :
pi@pi4b:~ $ clawhub list
No installed skills.
我在 "
OpenClaw 超級龍蝦煉金術" 這本書的第 6 章看到作者推薦了 10 個新手必裝的 skills, 我將其提交給 Gemini 評論, 結果如下 :
- self-improving-agent (自我改進代理) :
可自我修正提示詞與除錯, 但在樹莓派上若頻繁反覆自我推論會大幅增加 Token 消耗與等待延遲 (不推). - github :
可在手機上隨時請小爪追蹤 Issue, 查看 PR 狀態, 讀取 Repo 程式碼片段或提交簡短修訂等, 極為實用 (必裝). - gog :
整合 Google 行程與郵件的核心, 能直接把對話指令轉化為 Google 日曆提醒與郵件摘要, 是通訊軟體助理的靈魂外掛 (必裝). - weather :
在已經裝有 multi-search-engine 或具備聯網能力的情況下, 小爪直接搜尋就能回報天氣, 安裝此 weather 略顯多餘 (不推). - multi-search-engine :
可大幅降低 LLM 幻覺, 即時查詢最新技術規格, 新聞時事與即時資訊的核心依賴 (必裝). - nano-pdf :
輕量級 PDF 解析, 丟論文, 技術手冊或規格書給 LINE/TG 時, 能由樹莓派本地提取純文字進行重點提煉, 非常適合閱讀長文件 (必裝). - humanizer :
讓 AI 回覆更具人味, 減少生硬機器感. 在 LINE 群組對話中有助於提升互動體驗, 但對純指令/程式任務幫助不大 (不推). - obsidian :
本地 Markdown 筆記神器, 若樹莓派本地或 NAS 有掛載 Vault, 能直接將對話隨筆寫入 .md 檔案, 非常符合邊緣設備的去中心化哲學 (必裝). - notion :
與 Obsidian 高度同質, 兩者選一即可, 不建議同時啟用兩套知識庫工具, 避免系統 Prompt 負載過重且分散筆記儲存位置 (不推). - summarize :
基本上是通用的 Prompt 技巧. 若系統有配置好的 System Prompt, 通常不需要額外佔用一個 Skill 槽位, 除非該 Skill 包含特殊的長文本分塊 (Chunking) 演算法 (不推).
我也問了 Copilot, 它也強力推薦 filesystem, github, nano-pdf, multi-search-engine 為必裝.
3. 用 Clawhub CLI 安裝 Skills :
此處以 filesystem 為例, 說明在終端機介面安裝 Skills 的方法, 先搜尋此技能 :
pi@pi4b:~ $ clawhub search filesystem
filesystem @amaofx Filesystem 3 installs / 60d
filesystem @paudyyin Filesystem 0 installs / 60d
clawdbot-filesystem @gtrusler Filesystem Management 9 installs / 60d
clawdbot-filesystem-1-0-2 @lucky-2968 Clawdbot Filesystem 1.0.2 5 installs / 60d
filesystem-access @huanz Filesystem Access 2 installs / 60d
filesystem-mcp @buddhasource Filesystem MCP Server 2 installs / 60d
filesystem2 @qq258067284 filesystem-1.0.2 1 installs / 60d
... (略) ...
jpeng-file-compare @jpengcheng523-netizen file-compare 0 installs / 60d
plakar-backup @misterflop Plakar backup 0 installs / 60d
ext4-recovery @yikenan ext4-recovery 1 installs / 60d
finder @bytesagain3 Finder 1 installs / 60d
skills-sh:yaklang/hack-skills/file-access-vuln @yaklang file-access-vuln
可見有非常多名稱含有 filesystem 的 Skills, 同名的就有兩個, 第一個 (開發者 @amaofx) 在過去 60 天內有 3 次安裝紀錄; 另一個則掛 0. 選擇較多人安裝的 Skill, 但安裝之前可以用 clawhub inspect 指令來檢視其功能 :
pi@pi4b:~ $ clawhub inspect @amaofx/filesystem
┌─ inspect ───────────────────────────────────────────
│ filesystem Filesystem
│ @amaofx · v1.0.0 · latest=1.0.0
│
│ Summary Perform advanced filesystem tasks including listing, recursive searching by name or content, batch copying/moving/deleting files, and analyzing directory siz...
│ Owner @amaofx
│ Latest 1.0.0
│ License MIT-0 (Free to use, modify, and redistribute. No attribution required.)
│ Updated 2026-05-17 03:54 UTC
│ Created 2026-02-12 12:07 UTC
│ Tags latest=1.0.0
└──────────────────────────────────────────────────────
從 Summary 敘述可知, 這是一個完整的檔案管理 Skill, 支援如下功能 :
✓ 列出檔案
✓ 遞迴搜尋
✓ 內容搜尋
✓ 批次複製
✓ 批次搬移
✓ 批次刪除
✓ 目錄容量分析
不過 batch deleting files (批次刪除) 權限似乎有點大, 安裝後還要去觀察 :
- 是否有 scope 限制
- 是否只能在 workspace
- 是否能跨目錄
安裝指令如下 :
clawhub install @amaofx/filesystem
pi@pi4b:~ $ clawhub install @amaofx/filesystem
✔ Installed filesystem v1.0.0 -> /home/pi/.openclaw/workspace/skills/@amaofx/filesystem
這時用 clawhub list 檢視 Skills 列表, 就會看到此 Skills 在清單中 :
pi@pi4b:~ $ clawhub list
@amaofx/filesystem 1.0.0
用 ls 指令檢視 OpenClaw 目錄結構, 可知 Skills 是放在工作目錄 workspace/skills 下, 且會依照作者建立子目錄來存放 :
pi@pi4b:~ $ ls -ls ~/.openclaw/workspace/skills
總用量 4
4 drwxr-xr-x 3 pi pi 4096 10月 4 01:50 @amaofx
pi@pi4b:~ $ ls -ls ~/.openclaw/workspace/skills/@amaofx
總用量 4
4 drwxr-xr-x 3 pi pi 4096 10月 4 01:50 filesystem
檔案目錄結構如下圖所示 :
因此 Skill 預設會被視為 Workspace 的一部分, 這有 3 個好處 :
- AGENTS.md 與 SOUL.md 的規範比較容易影響 Agent 的行為, Agent 在呼叫 filesystem Skill 時通常也會受到這些規範影響.
- 容易備份 : 整個 Agent 環境其實只要備份 ~/.openclaw/workspace 即可.
- 容易檢查 Skill : 只要進入 skills 資料夾下該作者的子目錄即可檢查安裝了哪些 Skills.
接下來檢視所安裝的 Skill 有哪些檔案 :
pi@pi4b:~ $ cd ~/.openclaw/workspace/skills/@amaofx/filesystem
pi@pi4b:~/.openclaw/workspace/skills/@amaofx/filesystem $ find . -type f
./skill-card.md
./SKILL.md
./_meta.json
./.clawhub/origin.json
用 cat 檢視其中的 SKILL.md 檔內容 :
pi@pi4b:~/.openclaw/workspace/skills/@amaofx/filesystem $ cat SKILL.md
---
name: filesystem
description: Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
---
# Filesystem Operations
文件系统操作工具，提供目录列表、内容搜索、批量处理和目录分析功能。
## 快速开始
... (略) ...
## 安全提醒
⚠️ **批量操作前先确认**：
- 列出要操作的文件
- 确认不会误删重要文件
- 考虑先备份
⚠️ **删除操作不可逆**：
- `rm` 删除后无法恢复
- 大批量删除前仔细检查
- 考虑使用 `rm -i` 交互式删除
⚠️ **权限注意**：
- 某些操作可能需要 sudo
- 系统目录操作要谨慎
- 考虑文件权限问题
看來此 Skill 的作者也蠻顧慮到檔案操作安全問題, 正常情況 Agent 只能操作 /home/pi 底下有權限的檔案, 不會直接取得 /etc, /usr, /boot 的寫入權.
大部分的 Skill 安裝後可以直接使用, 不用重啟 Gateway, Agent 在執行任務時會動態讀取 Workspace, 所以現在就可以用 Telegram 或 LINE 輸入下列提示詞來測試看看此 Skill 是否能用 :
"請列出 workspace 下所有 md 檔"
可見 filesystem 這個 Skill 有在運作.
