Chuyển đến nội dung chính

​
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

1

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

openclaw plugins list
2

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
3

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ạngCách hoạt độngVí dụ
Nativeopenclaw.plugin.json + module runtime; thực thi trong quá trìnhPlugin chính thức, gói npm cộng đồng
BundleBố 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)

PluginGóiTài liệu
Matrix@openclaw/matrixMatrix
Microsoft Teams@openclaw/msteamsMicrosoft Teams
Nostr@openclaw/nostrNostr
Voice Call@openclaw/voice-callVoice Call
Zalo@openclaw/zaloZalo
Zalo Personal@openclaw/zalouserZalo Personal

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

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
  • 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")
elevenlabs, microsoft
  • 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ườngMô tả
enabledCông tắc chính (mặc định: true)
allowDanh sách cho phép plugin (tùy chọn)
denyDanh sách từ chối plugin (tùy chọn; từ chối sẽ ưu tiên)
load.pathsTệp/thư mục plugin bổ sung
slotsBộ 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.
  • 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):
1

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

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

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

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

Mở rộng toàn cầu

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

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
memoryPlugin bộ nhớ hoạt độngmemory-core
contextEngineĐộng cơ ngữ cảnh hoạt độnglegacy (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ì
registerProviderNhà cung cấp mô hình (LLM)
registerChannelKênh chat
registerToolCông cụ agent
registerHook / on(...)Hook vòng đời
registerSpeechProviderChuyển văn bản thành giọng nói / STT
registerMediaUnderstandingProviderPhân tích hình ảnh/âm thanh
registerImageGenerationProviderTạo hình ảnh
registerWebSearchProviderTìm kiếm web
registerHttpRouteEndpoint HTTP
registerCommand / registerCliLệnh CLI
registerContextEngineĐộng cơ ngữ cảnh
registerServiceDịch vụ nền

​
Liên quan

Last modified on March 22, 2026