Plugins

Plugins mở rộng khả năng của OpenClaw với các tính năng mới: kênh, nhà cung cấp mô hình, công cụ, kỹ năng, giọng nói, tạo hình ảnh và nhiều hơn nữa. Một số plugin là core (đi kèm với OpenClaw), số khác là external (được cộng đồng phát hành trên npm).

Bắt đầu nhanh

Xem những gì đã được tải

openclaw plugins list

Cài đặt một plugin

# Từ npm
openclaw plugins install @openclaw/voice-call

# Từ thư mục hoặc tệp lưu trữ cục bộ
openclaw plugins install ./my-plugin
openclaw plugins install ./my-plugin.tgz

Khởi động lại Gateway

openclaw gateway restart

Sau đó cấu hình dưới plugins.entries.\<id\>.config trong file cấu hình của bạn.

Các loại plugin

OpenClaw nhận diện hai định dạng plugin:

Định dạng	Cách hoạt động	Ví dụ
Native	`openclaw.plugin.json` + module runtime; thực thi trong quá trình	Plugin chính thức, gói npm cộng đồng
Bundle	Bố cục tương thích Codex/Claude/Cursor; ánh xạ tới các tính năng OpenClaw	`.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/`

Cả hai đều xuất hiện dưới openclaw plugins list. Xem Plugin Bundles để biết chi tiết về bundle.

Plugin chính thức

Có thể cài đặt (npm)

Plugin	Gói	Tài liệu
Matrix	`@openclaw/matrix`	Matrix
Microsoft Teams	`@openclaw/msteams`	Microsoft Teams
Nostr	`@openclaw/nostr`	Nostr
Voice Call	`@openclaw/voice-call`	Voice Call
Zalo	`@openclaw/zalo`	Zalo
Zalo Personal	`@openclaw/zalouser`	Zalo Personal

Core (đi kèm với OpenClaw)

Nhà cung cấp mô hình (bật mặc định)

anthropic, byteplus, cloudflare-ai-gateway, github-copilot, google, huggingface, kilocode, kimi-coding, minimax, mistral, modelstudio, moonshot, nvidia, openai, opencode, opencode-go, openrouter, qianfan, qwen-portal-auth, synthetic, together, venice, vercel-ai-gateway, volcengine, xiaomi, zai

Plugin bộ nhớ

memory-core — tìm kiếm bộ nhớ đi kèm (mặc định qua plugins.slots.memory)
memory-lancedb — cài đặt theo yêu cầu bộ nhớ dài hạn với tự động nhớ lại/ghi lại (đặt plugins.slots.memory = "memory-lancedb")

Nhà cung cấp giọng nói (bật mặc định)

elevenlabs, microsoft

Khác

copilot-proxy — cầu nối VS Code Copilot Proxy (tắt mặc định)

Tìm kiếm plugin bên thứ ba? Xem Community Plugins.

Cấu hình

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: ["untrusted-plugin"],
    load: { paths: ["~/Projects/oss/voice-call-extension"] },
    entries: {
      "voice-call": { enabled: true, config: { provider: "twilio" } },
    },
  },
}

Trường	Mô tả
`enabled`	Công tắc chính (mặc định: `true`)
`allow`	Danh sách cho phép plugin (tùy chọn)
`deny`	Danh sách từ chối plugin (tùy chọn; từ chối sẽ ưu tiên)
`load.paths`	Tệp/thư mục plugin bổ sung
`slots`	Bộ chọn slot độc quyền (ví dụ: `memory`, `contextEngine`)
`entries.\<id\>`	Công tắc và cấu hình cho từng plugin

Thay đổi cấu hình yêu cầu khởi động lại gateway.

Trạng thái plugin: tắt, thiếu, không hợp lệ

Tắt: plugin tồn tại nhưng quy tắc bật tắt đã tắt nó. Cấu hình được giữ lại.
Thiếu: cấu hình tham chiếu đến một id plugin mà không tìm thấy.
Không hợp lệ: plugin tồn tại nhưng cấu hình không khớp với schema đã khai báo.

Khám phá và ưu tiên

OpenClaw quét tìm plugin theo thứ tự này (khớp đầu tiên sẽ thắng):

Đường dẫn cấu hình

plugins.load.paths — đường dẫn tệp hoặc thư mục rõ ràng.

Mở rộng không gian làm việc

\<workspace\>/.openclaw/extensions/*.ts và \<workspace\>/.openclaw/extensions/*/index.ts.

Mở rộng toàn cầu

~/.openclaw/extensions/*.ts và ~/.openclaw/extensions/*/index.ts.

Plugin đi kèm

Đi kèm với OpenClaw. Nhiều plugin được bật mặc định (nhà cung cấp mô hình, giọng nói). Các plugin khác yêu cầu bật rõ ràng.

Quy tắc bật tắt

plugins.enabled: false tắt tất cả plugin
plugins.deny luôn ưu tiên hơn cho phép
plugins.entries.\<id\>.enabled: false tắt plugin đó
Plugin nguồn gốc từ không gian làm việc bị tắt mặc định (phải được bật rõ ràng)
Plugin đi kèm tuân theo bộ mặc định bật sẵn trừ khi bị ghi đè
Slot độc quyền có thể buộc bật plugin đã chọn cho slot đó

Slot plugin (danh mục độc quyền)

Một số danh mục là độc quyền (chỉ có một hoạt động tại một thời điểm):

{
  plugins: {
    slots: {
      memory: "memory-core", // hoặc "none" để tắt
      contextEngine: "legacy", // hoặc một id plugin
    },
  },
}

Slot	Điều khiển gì	Mặc định
`memory`	Plugin bộ nhớ hoạt động	`memory-core`
`contextEngine`	Động cơ ngữ cảnh hoạt động	`legacy` (tích hợp)

Tham khảo CLI

openclaw plugins list                    # danh sách gọn
openclaw plugins inspect <id>            # chi tiết sâu
openclaw plugins inspect <id> --json     # định dạng máy đọc được
openclaw plugins status                  # tóm tắt hoạt động
openclaw plugins doctor                  # chẩn đoán

openclaw plugins install <npm-spec>      # cài đặt từ npm
openclaw plugins install <path>          # cài đặt từ đường dẫn cục bộ
openclaw plugins install -l <path>       # liên kết (không sao chép) cho phát triển
openclaw plugins update <id>             # cập nhật một plugin
openclaw plugins update --all            # cập nhật tất cả

openclaw plugins enable <id>
openclaw plugins disable <id>

Xem tham khảo CLI openclaw plugins để biết chi tiết đầy đủ.

Tổng quan API Plugin

Plugins xuất ra một hàm hoặc một đối tượng với register(api):

export default definePluginEntry({
  id: "my-plugin",
  name: "My Plugin",
  register(api) {
    api.registerProvider({
      /* ... */
    });
    api.registerTool({
      /* ... */
    });
    api.registerChannel({
      /* ... */
    });
  },
});

Các phương thức đăng ký phổ biến:

Phương thức	Đăng ký cái gì
`registerProvider`	Nhà cung cấp mô hình (LLM)
`registerChannel`	Kênh chat
`registerTool`	Công cụ agent
`registerHook` / `on(...)`	Hook vòng đời
`registerSpeechProvider`	Chuyển văn bản thành giọng nói / STT
`registerMediaUnderstandingProvider`	Phân tích hình ảnh/âm thanh
`registerImageGenerationProvider`	Tạo hình ảnh
`registerWebSearchProvider`	Tìm kiếm web
`registerHttpRoute`	Endpoint HTTP
`registerCommand` / `registerCli`	Lệnh CLI
`registerContextEngine`	Động cơ ngữ cảnh
`registerService`	Dịch vụ nền

Liên quan

Xây dựng Plugins — tạo plugin của riêng bạn
Plugin Bundles — tương thích gói Codex/Claude/Cursor
Plugin Manifest — schema manifest
Đăng ký Công cụ — thêm công cụ agent trong một plugin
Nội bộ Plugin — mô hình khả năng và quy trình tải
Community Plugins — danh sách bên thứ ba

Tổng quan cài đặt

Chạy qua Container

Triển khai (Hosting)

Bảo trì & Nâng cấp

Plugins

Plugins

Bắt đầu nhanh

Các loại plugin

Plugin chính thức

Có thể cài đặt (npm)

Core (đi kèm với OpenClaw)

Cấu hình

Khám phá và ưu tiên

Quy tắc bật tắt

Slot plugin (danh mục độc quyền)

Tham khảo CLI

Tổng quan API Plugin

Liên quan

​Plugins

​Bắt đầu nhanh

​Các loại plugin

​Plugin chính thức

​Có thể cài đặt (npm)

​Core (đi kèm với OpenClaw)

​Cấu hình

​Khám phá và ưu tiên

​Quy tắc bật tắt

​Slot plugin (danh mục độc quyền)

​Tham khảo CLI

​Tổng quan API Plugin

​Liên quan

Plugins

Bắt đầu nhanh

Các loại plugin

Plugin chính thức

Có thể cài đặt (npm)

Core (đi kèm với OpenClaw)

Cấu hình

Khám phá và ưu tiên

Quy tắc bật tắt

Slot plugin (danh mục độc quyền)

Tham khảo CLI

Tổng quan API Plugin

Liên quan