Cara Membuat Custom Skill OpenClaw

Intinya

Kekuatan OpenClaw terletak pada ekstensibilitasnya melalui skills. Dengan lebih dari 700 skills yang dibangun komunitas tersedia melalui ClawHub dan kemampuan untuk membuat skills kustom menggunakan file SKILL.md atau TypeScript, Anda dapat mengubah asisten OpenClaw Anda menjadi alat khusus untuk hampir semua tugas. Panduan ini mencakup segala hal mulai dari menginstal skills yang ada hingga membangun dan menerbitkan skills Anda sendiri.

Pendahuluan

OpenClaw sudah menyediakan kemampuan canggih secara bawaan, tetapi potensi sebenarnya terbuka melalui skills. Baik Anda membutuhkan bantuan pengkodean khusus, otomatisasi DevOps, alat penelitian, atau fungsionalitas spesifik industri, kemungkinan ada skill untuk itu—dan jika tidak, Anda dapat membangunnya.

💡

Saat membangun skills kustom yang berinteraksi dengan API eksternal, memiliki alat yang tepat untuk menguji integrasi tersebut sangat penting. Apidog membantu Anda menguji dan men-debug endpoint API yang menjadi ketergantungan skills Anda, memastikan integrasi yang andal.

tombol

Dengan lebih dari 700 skills yang dibangun komunitas tersedia melalui ClawHub dan kemampuan untuk membuat skills kustom, OpenClaw menjadi asisten AI apa pun yang Anda butuhkan.

Dalam panduan komprehensif ini, kami akan membahas:

Cara menemukan dan menginstal skills dari ClawHub
Mengelola dan mengatur skills Anda
Membangun skills kustom dari awal
Menerbitkan skills Anda untuk komunitas
Praktik terbaik keamanan

Memahami Skills OpenClaw

Apa Itu Skills?

Skills adalah ekstensi modular yang menambahkan kemampuan spesifik ke OpenClaw. Bayangkan mereka sebagai plugin yang memberikan kemampuan baru kepada asisten AI Anda—mulai dari mengirim jenis email tertentu hingga berinteraksi dengan API tertentu.

Jenis-Jenis Skills

1. Skills Bahasa Alami (SKILL.md)
Bentuk paling sederhana—ditulis dalam Markdown dengan frontmatter YAML. Ini mendefinisikan runbook operasional yang diikuti OpenClaw ketika kondisi tertentu terpenuhi.

2. Skills TypeScript
Skills berfitur lengkap yang dibangun dengan TypeScript yang dapat mengakses API, menjalankan logika kompleks, dan berintegrasi secara mendalam dengan layanan eksternal.

3. Skills Berbasis CLI
Skills yang membungkus alat baris perintah, memungkinkan OpenClaw untuk menggunakan alat apa pun yang tersedia di sistem Anda.

Cara Kerja Skills

Skills dimuat secara dinamis saat dibutuhkan (pemuatan just-in-time), yang menjaga penggunaan memori tetap terkendali. Ketika permintaan pengguna cocok dengan pemicu (triggers) skill, OpenClaw menjalankan tindakan yang ditentukan skill tersebut.

Kategori Skills

ClawHub menampung skills di berbagai kategori:

Agen Pengkodean & IDE (133+ skills)
DevOps & Cloud (212+ skills)
Pencarian & Penelitian (253+ skills)
AI & LLM (287+ skills)
Produktivitas (150+ skills)
Data & Analitik (100+ skills)
Dan masih banyak lagi...

Menginstal Skills dari ClawHub

Mencari Skills

Jelajahi marketplace ClawHub di clawhub.ai atau cari langsung melalui OpenClaw:

# Cari skills
openclaw skills search "github"

# Daftar skills populer
openclaw skills popular

# Jelajahi kategori
openclaw skills browse devops

Menginstal Skill

Setelah Anda menemukan skill yang Anda inginkan, menginstalnya sangat mudah:

# Instal skill tertentu
openclaw skills install github-actions

# Instal dengan versi tertentu
openclaw skills install github-actions@1.2.0

# Instal dari penerbit tertentu
openclaw skills install @username/skill-name

Menginstal Semua Skills yang Direkomendasikan

# Instal skills pemula populer
openclaw skills install-recommended

Memverifikasi Instalasi

# Daftar semua skills yang terinstal
openclaw skills list

# Periksa detail skill
openclaw skills info github-actions

Mengelola Skills yang Terinstal

Mengaktifkan dan Menonaktifkan Skills

# Nonaktifkan skill (membuatnya terinstal tetapi tidak digunakan)
openclaw skills disable github-actions

# Aktifkan skill yang dinonaktifkan
openclaw skills enable github-actions

Memperbarui Skills

# Perbarui skill tertentu
openclaw skills update github-actions

# Perbarui semua skills
openclaw skills update-all

Menghapus Skills

# Copot pemasangan skill
openclaw skills uninstall github-actions

Konfigurasi Skill

Banyak skills mendukung konfigurasi kustom:

# Konfigurasi skill
openclaw skills config github-actions --set token=your-github-token

Atau edit file konfigurasi skill secara langsung:

# ~/.openclaw/skills/github-actions/config.yaml
token: your-github-token
default-branch: main
auto-merge: false

Membangun Skills Kustom

Kapan Membangun Skills Kustom

Bangun skill kustom saat Anda membutuhkan:

Integrasi API spesifik yang tidak dicakup oleh skills yang ada
Alur kerja otomatisasi kustom
Fungsionalitas spesifik industri
Alat internal proprietary

Struktur Skill

Skill dasar terdiri dari:

my-custom-skill/
├── SKILL.md          # Definisi skill (untuk skills bahasa alami)
├── config.yaml       # Skema konfigurasi
└── icon.svg          # Ikon skill (opsional)

Untuk skills TypeScript:

my-typescript-skill/
├── src/
│   └── index.ts      # Kode skill utama
├── package.json
├── tsconfig.json
├── config.schema.json
└── skill.yaml        # Manifest skill

Membuat Skills SKILL.md

Struktur SKILL.md Dasar

Berikut adalah file SKILL.md minimal:

---
name: weather-alert
description: Dapatkan peringatan cuaca untuk lokasi Anda
triggers:
  - "weather"
  - "weather alert"
  - "forecast"
requires:
  - location
actions:
  - name: get_weather
    api: https://api.weather.com/v3
    params:
      location: "{location}"
---

# Skill Peringatan Cuaca

Skill ini menyediakan peringatan cuaca dan prakiraan untuk lokasi Anda.

## Konfigurasi

Atur lokasi Anda dalam konfigurasi skill:
- city: Nama kota Anda
- units: metrik atau imperial

Contoh Lengkap: Skill Ringkasan Email

---
name: daily-email-summary
description: Terima ringkasan harian email penting Anda
triggers:
  - "email summary"
  - "daily emails"
  - "summarize my emails"
requires:
  - email_access
  - api_key
actions:
  - name: fetch_emails
    method: gmail.users.messages.list
    params:
      q: "is:unread"
      maxResults: 10
  - name: summarize
    model: gpt-4
    prompt: "Ringkas email ini dalam bentuk poin-poin"
---

# Skill Ringkasan Email Harian

Tetap terinformasi tentang kotak masuk Anda dengan ringkasan harian otomatis.

## Fitur

- Mengambil email yang belum dibaca dari Gmail
- Menggunakan AI untuk meringkas poin-poin penting
- Mengirim ringkasan ke saluran pilihan Anda

## Pengaturan

1. Konfigurasi akses Gmail API di pengaturan OpenClaw Anda
2. Atur waktu ringkasan pilihan Anda
3. Pilih saluran pengiriman Anda (Telegram, Discord, dll.)

## Contoh Penggunaan

Anda: Kirimkan ringkasan email saya
OpenClaw: Berikut ringkasan 8 email Anda yang belum dibaca:

Permintaan rapat dari John tentang perencanaan Q3
Konfirmasi pesanan dari Amazon
Newsletter dari TechCrunch...


### Pemicu Lanjutan

Gunakan pemicu yang lebih canggih:

```markdown
---
name: smart-reminder
triggers:
  # Frasa tepat
  - "ingatkan saya untuk {tindakan}"
  # Pola
  - "ingatkan saya dalam {durasi}"
  # Kontekstual
  context:
    - channel: work
      patterns: ["rapat", "tenggat waktu", "proyek"]
---

# Skill Pengingat Pintar

Menangani semua permintaan pengingat dengan penguraian cerdas.

Membangun Skills TypeScript

Untuk integrasi yang lebih kompleks, skills TypeScript memberikan kontrol penuh.

Menyiapkan Lingkungan Pengembangan Anda

# Buat proyek skill baru
openclaw skills create my-awesome-skill

# Navigasi ke direktori skill
cd my-awesome-skill

# Instal dependensi
npm install

# Mulai server pengembangan
npm run dev

Struktur Skill TypeScript

// src/index.ts
import { Skill, SkillContext, SkillResult } from '@openclaw/skill-sdk';

export default class MyAwesomeSkill implements Skill {
  name = 'my-awesome-skill';
  description = 'Skill yang melakukan sesuatu yang luar biasa';

  // Dipanggil saat skill dimuat
  async onLoad(context: SkillContext): Promise<void> {
    console.log('Skill dimuat!');
  }

  // Dipanggil saat skill cocok dengan pemicu
  async execute(context: SkillContext): Promise<SkillResult> {
    const { userMessage, config } = context;

    // Logika skill Anda di sini
    const result = await this.doSomethingAwesome(userMessage.content);

    return {
      message: result,
      actions: []
    };
  }

  private async doSomethingAwesome(input: string): Promise<string> {
    // Implementasikan logika skill Anda
    return `Anda mengatakan: ${input}`;
  }
}

Manifest Skill (skill.yaml)

name: my-awesome-skill
version: 1.0.0
description: Skill yang melakukan sesuatu yang luar biasa
author:
  name: Nama Anda
  email: you@example.com

triggers:
  - pattern: "lakukan sesuatu yang luar biasa"
    type: exact

config:
  apiKey:
    type: string
    required: true
    description: Kunci API untuk layanan

permissions:
  - network
  - filesystem

runtime: nodejs18

Skema Konfigurasi (config.schema.json)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Kunci API untuk layanan"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    }
  },
  "required": ["apiKey"]
}

Membangun dan Menguji

# Bangun skill
npm run build

# Jalankan tes
npm test

# Paketkan untuk distribusi
npm run package

Contoh: Skill Integrasi GitHub

Berikut adalah contoh yang lebih lengkap yang menunjukkan integrasi API:

import { Skill, SkillContext, SkillResult } from '@openclaw/skill-sdk';
import axios from 'axios';

export default class GitHubSkill implements Skill {
  name = 'github';
  description = 'Berinteraksi dengan repositori GitHub';

  async execute(context: SkillContext): Promise<SkillResult> {
    const { userMessage, config } = context;
    const message = userMessage.content.toLowerCase();

    if (message.includes('daftar repo')) {
      return this.listRepositories(config);
    } else if (message.includes('buat isu')) {
      return this.createIssue(context);
    }

    return {
      message: 'Saya dapat membantu dalam mendaftar repo, membuat isu, dan lainnya.',
      actions: []
    };
  }

  private async listRepositories(config: any): Promise<SkillResult> {
    const response = await axios.get('https://api.github.com/user/repos', {
      headers: {
        Authorization: `token ${config.githubToken}`
      }
    });

    const repos = response.data.slice(0, 5).map((r: any) => r.name).join('\n');

    return {
      message: `Repositori terbaru Anda:\n${repos}`,
      actions: []
    };
  }

  private async createIssue(context: SkillContext): Promise<SkillResult> {
    // Ekstrak detail isu dari pesan pengguna
    return {
      message: 'Saya butuh lebih banyak detail untuk membuat isu. Mohon sebutkan repositori, judul, dan deskripsi.',
      actions: [
        {
          type: 'request_input',
          fields: ['repo', 'title', 'description']
        }
      ]
    };
  }
}

Menerbitkan Skills ke ClawHub

Mempersiapkan Skill Anda untuk Diterbitkan

Uji secara menyeluruh: Pastikan skill Anda berfungsi dalam berbagai skenario
Tambahkan dokumentasi: SKILL.md yang jelas dengan contoh
Atur izin yang tepat: Hanya minta akses yang diperlukan
Tambahkan ikon: Buat ikon SVG sederhana
Pembarsian Versi: Gunakan pembarsian versi semantik (1.0.0, 1.1.0, dll.)

Proses Penerbitan

# Login ke ClawHub
openclaw skills login

# Periksa apakah skill Anda siap
openclaw skills validate

# Terbitkan skill Anda
openclaw skills publish

Persyaratan Penerbitan

Manifest skill yang valid (skill.yaml)
Wajib: nama, versi, deskripsi, penulis
Setidaknya satu pemicu terdefinisi
Pemindaian VirusTotal (dilakukan secara otomatis)
Verifikasi identitas

Manajemen Versi

# Tingkatkan versi
openclaw skills version patch  # 1.0.0 -> 1.0.1
openclaw skills version minor  # 1.0.0 -> 1.1.0
openclaw skills version major  # 1.0.0 -> 2.0.0

# Terbitkan versi baru
openclaw skills publish

Praktik Terbaik Keamanan

Menginstal Skills Pihak Ketiga

Catatan Keamanan Penting: Insiden ClawHavoc pada awal 2026 mengungkapkan skills berbahaya di ClawHub. Selalu ikuti tindakan pencegahan ini:

Verifikasi penerbit: Hanya instal skills dari penerbit tepercaya dan terverifikasi
Tinjau izin: Periksa izin apa yang diminta skill
Audit kode: Untuk skills TypeScript, tinjau kode sumbernya
Mulai secara terisolasi: Uji skills di lingkungan terpisah terlebih dahulu

# Periksa izin skill sebelum menginstal
openclaw skills inspect github-actions

Membangun Skills yang Aman

Saat membangun skills Anda sendiri:

# Selalu tentukan izin minimum yang diperlukan
permissions:
  - network  # Hanya jika diperlukan
  - filesystem  # Hanya jika diperlukan

# Jangan pernah menempatkan rahasia secara hardcode
# BURUK:
const apiKey = "sk-1234567890";

# BAIK:
const apiKey = process.env.API_KEY;

Konfigurasi Keamanan yang Direkomendasikan

# ~/.openclaw/security.yaml
skill_security:
  membutuhkan_virustotal: true
  membutuhkan_penerbit_terverifikasi: false  # Atur ke true untuk produksi
  audit_izin: true
  mode_sandbox: true

Pengembangan Skill Tingkat Lanjut

Dependensi Skill

Skills dapat bergantung pada skills lain:

# skill.yaml
dependencies:
  - name: github
    version: ">=1.0.0"
  - name: slack
    version: ">=2.0.0"

Skills Berbasis Peristiwa

Bereaksi terhadap peristiwa OpenClaw:

export default class EventSkill implements Skill {
  async onMessage(context: SkillContext): Promise<SkillResult> {
    // Dipanggil pada setiap pesan
  }

  async onTimer(context: SkillContext): Promise<SkillResult> {
    // Dipanggil berdasarkan jadwal
  }

  async onStartup(context: SkillContext): Promise<void> {
    // Dipanggil saat OpenClaw dimulai
  }

  async onShutdown(context: SkillContext): Promise<void> {
    // Dipanggil saat OpenClaw berhenti
  }
}

Menggunakan MCP dengan Skills

Gabungkan skills dengan server MCP:

# skill.yaml
mcpServers:
  - name: filesystem
    command: npx @modelcontextprotocol/server-filesystem ./data
  - name: github
    command: npx @modelcontextprotocol/server-github

Pemecahan Masalah

Skill Tidak Dimuat

# Periksa status skill
openclaw skills status my-skill

# Lihat log skill
openclaw logs --skill my-skill

Penyebab umum:

Dependensi hilang
Konfigurasi tidak valid
Masalah izin

Pemicu Tidak Cocok

# Uji pencocokan pemicu
openclaw skills test-trigger "frasa pemicu Anda"

Masalah Kinerja

# Periksa penggunaan sumber daya skill
openclaw skills monitor

# Nonaktifkan skills yang boros sumber daya untuk sementara
openclaw skills disable heavy-skill

Kesimpulan

Sistem skill OpenClaw mengubahnya dari asisten AI sederhana menjadi platform yang kuat dan dapat diperluas. Baik Anda menginstal skills yang dibangun komunitas dari ClawHub atau membangun solusi kustom Anda sendiri, kemungkinannya hampir tak terbatas.

Ekosistem OpenClaw tumbuh lebih kuat dengan setiap skill baru. Mulai bangun sekarang!

💡

Siap membangun aplikasi AI profesional? Unduh Apidog secara gratis untuk menguji dan mengelola integrasi layanan AI Anda dengan antarmuka visual yang dirancang untuk pengembang.

tombol