Wróć

06. OpenClaw — system umiejętności Skills: szczegółowy przewodnik

Skills to rdzeń rozszerzalności OpenClaw — społeczność stworzyła ponad 5700 pakietów umiejętności. Artykuł szczegółowo omawia koncepcję Skills, metody instalacji, korzystanie z ClawHub, kategorie umiejętności, zarządzanie konfiguracją oraz wybór i wykorzystanie odpowiednich umiejętności do wzmocnienia asystenta AI.

Dotyczy OpenClaw v2026.2 | Artykuł zakłada ukończenie podstawowej instalacji i chęć rozszerzenia możliwości asystenta AI.

TL;DR: Skills to gotowe rozszerzenia możliwości. Instalacja: openclaw skill install <name>, katalog: ~/.openclaw/workspace/skills/. ClawHub zawiera 5700+ umiejętności społeczności: asystent kodowania, wyszukiwanie, DevOps, automatyzacja web itp. Każda umiejętność zawiera SKILL.md (opis + słowa wyzwalające + instrukcje) i opcjonalną implementację narzędzi. Skanowanie bezpieczeństwa przez VirusTotal.

Czym są Skills?

Wyjaśnienie koncepcji

Skills to gotowe moduły rozszerzeń zawierające:

Składowa Opis
SKILL.md Plik definicji umiejętności: opis, słowa wyzwalające, instrukcje, przykłady
Tools Wywoływalne funkcje narzędzi (opcjonalne)
Resources Powiązane pliki zasobów (opcjonalne)
Package.json Deklaracja zależności (opcjonalne)

Skills vs Tools

Cecha Skills Tools
Źródło Społeczność Wbudowane/własne
Instalacja Wymaga instalacji Dostępne domyślnie
Złożoność Mogą być złożone Zwykle proste
Udostępnianie Tak Zwykle nie
Aktualizacje Niezależne Razem z systemem

Kategorie umiejętności

Umiejętności na ClawHub zorganizowane są w kategorie:

Kategoria Liczba Przykłady
Asystent kodowania 133+ coding-agent, debug-pro, tdd-guide
Wyszukiwanie i badania 253+ web-search, deepwiki, exa-search
DevOps 212+ docker-essentials, git-workflows
Automatyzacja web 139+ browser-control, puppeteer-skill
Narzędzia produktywności 135+ calendar-skill, task-manager
Analiza danych 46+ data-analyzer, budget-variance
Inteligentny dom 56+ home-assistant, smart-home-io
Dokumenty PDF 67+ pdf-reader, doc-summarizer
Obraz i wideo 60+ image-gen, video-editor
Notatki i wiedza 100+ obsidian, notion-sync

Metody instalacji Skills

Metoda 1: ClawHub CLI (zalecana)

# Wyszukiwanie umiejętności
openclaw skill search gmail

# Instalacja umiejętności
openclaw skill install gmail

# Instalacja konkretnej wersji
openclaw skill install [email protected]

# Instalacja z GitHub
openclaw skill install github:user/skill-repo

# Instalacja ze ścieżki lokalnej
openclaw skill install ./my-skill

Metoda 2: Instalacja ręczna

# Klonowanie repozytorium umiejętności
git clone https://github.com/user/skill-repo.git

# Skopiowanie do katalogu umiejętności
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

Metoda 3: Wklejenie linku GitHub

W czacie wyślij bezpośrednio link GitHub do umiejętności — agent automatycznie rozpozna i zainstaluje:

Zainstaluj tę umiejętność: https://github.com/user/skill-repo

Struktura katalogu umiejętności

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

Przewodnik po ClawHub

Dostęp do ClawHub

Odwiedź clawhub.com, aby przeglądać wszystkie dostępne umiejętności.

Wyszukiwanie umiejętności

# Wyszukiwanie CLI
openclaw skill search <słowo_kluczowe>

# Przykłady
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

Szczegóły umiejętności

Każda strona umiejętności zawiera:

Informacja Opis
Nazwa i opis Opis funkcji umiejętności
Autor Twórca umiejętności
Wersja Aktualny numer wersji
Liczba pobrań Liczba instalacji
Zależności Wymagane inne umiejętności lub pakiety
Podgląd SKILL.md Plik definicji umiejętności
Skan bezpieczeństwa Wynik skanowania VirusTotal

Skanowanie bezpieczeństwa

ClawHub współpracuje z VirusTotal w celu skanowania każdej umiejętności:

# Sprawdzenie statusu bezpieczeństwa umiejętności
openclaw skill info gmail --security

# Przykładowy wynik:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

Sprawdzenie przed instalacją

# Sprawdzenie zależności umiejętności
openclaw skill check gmail

# Przykładowy wynik:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

Konfiguracja umiejętności

Lokalizacja pliku konfiguracyjnego

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

Szczegóły struktury SKILL.md

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

Plik konfiguracyjny umiejętności

Niektóre umiejętności wymagają dodatkowej konfiguracji:

# Konfiguracja umiejętności
openclaw skill config gmail

# Lub ręczna edycja pliku konfiguracyjnego
vi ~/.openclaw/workspace/skills/gmail/config.json

Przykład konfiguracji:

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

Zmienne środowiskowe umiejętności

# Ustawienie zmiennych środowiskowych umiejętności
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# Lub w pliku .env
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

Zarządzanie umiejętnościami

Podgląd zainstalowanych umiejętności

# Lista wszystkich umiejętności
openclaw skill list

# Przykładowy wynik:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

Włączanie/wyłączanie umiejętności

# Wyłączenie umiejętności
openclaw skill disable home-assistant

# Włączenie umiejętności
openclaw skill enable home-assistant

Aktualizacja umiejętności

# Aktualizacja pojedynczej umiejętności
openclaw skill update gmail

# Aktualizacja wszystkich umiejętności
openclaw skill update --all

# Sprawdzenie dostępnych aktualizacji
openclaw skill outdated

Odinstalowanie umiejętności

# Odinstalowanie umiejętności
openclaw skill uninstall gmail

# Odinstalowanie z wyczyszczeniem konfiguracji
openclaw skill uninstall gmail --purge

Diagnostyka umiejętności

# Diagnostyka problemu z umiejętnością
openclaw skill diagnose gmail

# Przykładowy wynik:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

Polecane umiejętności

Programowanie

Nazwa Funkcja Komenda instalacji
coding-agent Uruchamianie Claude Code, Codex itp. openclaw skill install coding-agent
debug-pro Systematyczne metody debugowania openclaw skill install debug-pro
tdd-guide Rozwój sterowany testami openclaw skill install tdd-guide
git-workflows Przepływy pracy Git openclaw skill install git-workflows
docker-essentials Podstawy Docker openclaw skill install docker-essentials

Produktywność

Nazwa Funkcja Komenda instalacji
gmail Zarządzanie Gmail openclaw skill install gmail
calendar Zarządzanie kalendarzem openclaw skill install calendar
task-manager Zarządzanie zadaniami openclaw skill install task-manager
notion-sync Synchronizacja z Notion openclaw skill install notion-sync
obsidian Notatki Obsidian openclaw skill install obsidian

Wyszukiwanie i badania

Nazwa Funkcja Komenda instalacji
web-search Wyszukiwanie w sieci openclaw skill install web-search
deepwiki Wyszukiwanie Wiki openclaw skill install deepwiki
exa-search Wyszukiwanie AI openclaw skill install exa-search
research-paper Wyszukiwanie artykułów naukowych openclaw skill install research-paper

Inteligentny dom

Nazwa Funkcja Komenda instalacji
home-assistant Sterowanie Home Assistant openclaw skill install home-assistant
smart-home-io Urządzenia inteligentnego domu openclaw skill install smart-home-io
philips-hue Philips Hue openclaw skill install philips-hue

Podstawy tworzenia umiejętności

Tworzenie nowej umiejętności

# Utworzenie szablonu umiejętności
openclaw skill create my-skill

# Wygenerowana struktura katalogów
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

Szablon SKILL.md

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

Dodawanie definicji narzędzi

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

Publikacja umiejętności

# Walidacja umiejętności
openclaw skill validate my-skill

# Publikacja na ClawHub
openclaw skill publish my-skill

# Lub przesłanie na GitHub
git add .
git commit -m "Initial skill release"
git push origin main

Bezpieczeństwo umiejętności

Najlepsze praktyki bezpieczeństwa

Zalecenie Opis
Sprawdź źródło Instaluj tylko umiejętności z zaufanych źródeł
Sprawdź uprawnienia Dowiedz się, jakich uprawnień wymaga umiejętność
Przejrzyj kod Sprawdź SKILL.md i kod implementacji
Testuj w izolacji Najpierw używaj nowej umiejętności w środowisku testowym
Regularnie aktualizuj Utrzymuj najnowsze wersje umiejętności

Uprawnienia umiejętności

# Podgląd uprawnień umiejętności
openclaw skill permissions gmail

# Przykładowy wynik:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

Ograniczanie uprawnień umiejętności

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

Rozwiązywanie konfliktów umiejętności

Typowe konflikty

Typ konfliktu Opis Rozwiązanie
Nakładanie się słów wyzwalających Wiele umiejętności reaguje na to samo słowo Doprecyzuj słowa wyzwalające lub wyłącz kolidującą umiejętność
Konflikty zależności Różne umiejętności wymagają różnych wersji zależności Użyj izolowanych środowisk
Konflikty uprawnień Umiejętności wymagają tych samych uprawnień Sprawdź, czy to konieczne

Rozwiązywanie konfliktów

# Podgląd konfliktów umiejętności
openclaw skill conflicts

# Przykładowy wynik:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# Ustawienie priorytetu umiejętności
openclaw skill priority gmail 10
openclaw skill priority outlook 5

Izolowane środowiska

Dla umiejętności z konfliktami zależności:

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

Rozwiązywanie problemów

Umiejętność nie działa

# Sprawdzenie statusu umiejętności
openclaw skill list --status

# Sprawdzenie ładowania umiejętności
openclaw skill load gmail --verbose

# Logi umiejętności
openclaw logs --filter skill:gmail

Błąd uwierzytelniania

# Ponowne uwierzytelnianie
openclaw skill auth gmail --reauth

# Sprawdzenie statusu uwierzytelniania
openclaw skill auth gmail --status

Problem z zależnościami

# Sprawdzenie zależności
openclaw skill deps gmail

# Instalacja zależności
openclaw skill deps gmail --install

# Aktualizacja zależności
openclaw skill deps gmail --update

Błąd ładowania umiejętności

# Walidacja składni SKILL.md
openclaw skill validate gmail

# Przykładowy wynik:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

Podsumowanie

System Skills to rdzeń rozszerzalności OpenClaw:

  • Bogaty ekosystem: 5700+ umiejętności społeczności na każdą okazję
  • Prosta instalacja: jedna komenda do instalacji
  • Elastyczna konfiguracja: wsparcie dla personalizacji i nadpisywania
  • Bezpieczeństwo: zarządzanie uprawnieniami i skanowanie bezpieczeństwa

Dzięki rozsądnemu doborowi i konfiguracji umiejętności możesz dać asystentowi AI niemal nieograniczone możliwości.


Podsumowanie artykułu:

  • Zrozumiałeś koncepcję i strukturę Skills
  • Opanowałeś wiele metod instalacji i zarządzania umiejętnościami
  • Nauczyłeś się korzystać z ClawHub do odkrywania i oceniania umiejętności
  • Poznałeś bezpieczeństwo i zarządzanie uprawnieniami umiejętności
  • Opanowałeś podstawy tworzenia umiejętności

Historia zmian:

  • 2026-02-26: Pierwsza wersja, na podstawie OpenClaw v2026.2

Nawigacja po serii: