Note Sync cho Openclaw

Một kỹ năng ghi chú cho phép các tác nhân AI thêm ý tưởng, lời nhắc và mục nhật ký vào các tệp Markdown cục bộ bằng công cụ Model Context Protocol (MCP).

lgwventrue
v1.0.1
Jun 11, 2026
0
511
0

Cài đặt & Tải xuống

1. ClawHub CLI

Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.

npx clawhub@latest install note-sync

2. Cài đặt Thủ công

Sao chép thư mục kỹ năng vào một trong những vị trí sau

Toàn cục
~/.openclaw/skills/
Không gian làm việc
<project>/skills/

Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn

3. Cài đặt Prompt

Sao chép prompt này vào OpenClaw để tự động cài đặt.

Giúp tôi cài đặt note-sync bằng Clawhub. Nếu Clawhub chưa

Bạn muốn tải xuống?

Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.

Note Sync là gì?

Note Sync là một tích hợp được thiết kế để thu hẹp khoảng cách giữa các cuộc hội thoại AI và quản lý tri thức cá nhân. Bằng cách sử dụng máy chủ Model Context Protocol (MCP) tùy chỉnh chạy cục bộ, kỹ năng này cho phép các trợ lý AI lưu tin nhắn trò chuyện, ý tưởng động não và các mục hành động trực tiếp vào các tệp cục bộ. Đây là một thành phần thiết yếu trong số các Openclaw Skills dành cho các nhà phát triển và người dùng nâng cao muốn giữ cho thông tin của họ được tổ chức trên đĩa mà không cần rời khỏi không gian làm việc AI của mình.

Kỹ năng này hoạt động thông qua công cụ append_note, cho phép trợ lý tương tác an toàn với bộ lưu trữ cục bộ trên máy chủ của bạn hoặc trong môi trường Windows Subsystem for Linux (WSL). Nó xử lý việc ghi tệp, thêm ghi chú trực tiếp dưới các tiêu đề được chỉ định và tự động phân loại thông tin dựa trên mục đích của người dùng. Điều này giữ cho các ghi chú cá nhân, nhật ký và danh sách công việc của bạn được cấu trúc hoàn toàn ở định dạng Markdown cục bộ.

Trường hợp sử dụng Note Sync

  • Tự động ghi lại những suy nghĩ thoáng qua, thông tin chi tiết hoặc đoạn mã trong phiên trò chuyện AI và lưu trữ trực tiếp vào nhật ký cục bộ.
  • Duy trì danh sách công việc tồn đọng hoặc danh sách việc cần làm bằng cách thêm các mục mới vào tệp chuyên dụng.
  • Tổng hợp các ghi chú nghiên cứu hoặc kế hoạch hành động nhiều bước được tạo trong quá trình phân tích AI trực tiếp vào đĩa.
  • Tổ chức nhật ký cá nhân hoặc nhật ký hàng ngày cục bộ trong các tệp Markdown mà không cần sao chép và dán thủ công.

Cách thức hoạt động của Note Sync

  1. Người dùng yêu cầu tác nhân AI lưu hoặc ghi lại thông tin (ví dụ: 'Lưu ý tưởng này vào nhật ký của tôi').
  2. Trợ lý AI kích hoạt công cụ append_note, tự động suy luận tên tệp (như 'journal' hoặc 'todo') và cấu trúc nội dung Markdown.
  3. Máy chủ note-sync MCP nhận lệnh và thêm khối văn bản mới một cách an toàn vào tệp Markdown cục bộ được chỉ định.
  4. Máy chủ trả về xác nhận thành công, cập nhật cho tác nhân AI để nó có thể thông báo cho người dùng rằng ghi chú của họ đã được lưu trữ an toàn trong không gian làm việc.

Cài đặt Note Sync

Thực hiện theo các bước sau để cấu hình Note Sync, một trong những Openclaw Skills năng suất đáng tin cậy nhất:

Bước 1: Sao chép kho lưu trữ và xây dựng tệp nhị phân MCP

Sao chép kho lưu trữ hỗ trợ vào máy của bạn (hoặc trong WSL) và biên dịch tệp thực thi Go:

git clone https://github.com/your-org/go-note-sync-mcp.git
cd go-note-sync-mcp/mcp-server
go build -o note-sync-mcp.exe

Đảm bảo rằng biến môi trường NOTE_SYNC_REPO trỏ trực tiếp đến gốc của thư mục đã sao chép này.

Bước 2: Cấu hình openclaw.json

Chỉnh sửa tệp cấu hình Openclaw của bạn (thường nằm tại ~/.openclaw/openclaw.json) để đăng ký kỹ năng và máy chủ MCP cục bộ của nó. Thay thế <WSL_REPO> bằng đường dẫn kho lưu trữ cục bộ của bạn và <SKILL_DIR> bằng vị trí ClawHub đã cài đặt kỹ năng (thường là ~/.openclaw/skills/note-sync):

{
  "skills": {
    "entries": {
      "note-sync": {
        "enabled": true,
        "env": {
          "NOTE_SYNC_REPO": "<WSL_REPO>"
        }
      }
    }
  },
  "mcp": {
    "servers": {
      "note-sync": {
        "command": "<SKILL_DIR>/scripts/note-sync-mcp.sh",
        "args": []
      }
    }
  }
}

Bước 3: Khởi động lại Gateway và xác minh

Khởi động lại quy trình gateway và kiểm tra xem kỹ năng và công cụ đã được tải đúng cách chưa:

openclaw gateway restart
openclaw skills info note-sync
openclaw mcp list

Sau khi thành công, công cụ append_note sẽ được hiển thị trong danh sách thiết bị đầu cuối.

Lược đồ dữ liệu & Hệ thống phân loại của Note Sync

Kỹ năng Note Sync quản lý dữ liệu linh hoạt trên hệ thống tệp cục bộ của bạn trong thư mục <repo>/mcp-server/notes/. Mỗi ghi chú được lưu dưới dạng một tệp Markdown (.md) riêng biệt, sử dụng tiêu đề được suy luận làm tên tệp.

Bố cục thư mục

<NOTE_SYNC_REPO>/
└── mcp-server/
    ├── notes/
    │   ├── 感悟.md
    │   ├── 待办.md
    │   └── journal.md
    └── note-sync-mcp.exe

Lược đồ tham số công cụ MCP

Giao diện công cụ chính append_note mong đợi tải trọng sau được cấu trúc dưới dạng JSON:

Đối số Loại Bắt buộc Mô tả
title string Có Tên tệp và tiêu đề của ghi chú (ví dụ: 'journal', 'todo')
content string Có Nội dung thân bài tương thích với Markdown để thêm vào tệp

Tính năng Nâng cao của Note Sync

  • Khả năng tương tác gốc giữa WSL & Windows: Được thiết kế để chạy mượt mà giữa các môi trường bằng cách sử dụng các trình bao bọc shell vượt qua ranh giới WSL để khởi chạy các tệp Windows .exe.
  • Ghi đè thư mục tùy chỉnh: Dễ dàng điều chỉnh cấu hình đường dẫn để trỏ bộ lưu trữ ghi chú của bạn trực tiếp vào các thư mục vault Obsidian hoặc đồ thị Logseq.
  • Suy luận tiêu đề động: Sử dụng trí thông minh dựa trên LLM để phân tích ngữ cảnh hội thoại và tự động phân loại ghi chú vào các tệp thích hợp mà không cần người dùng nhắc nhở.
  • Tích hợp Model Context Protocol: Tận dụng các tiêu chuẩn công cụ MCP mạnh mẽ, đảm bảo khả năng tương thích cao với các Openclaw Skills khác và các giao diện tác nhân hiện đại.

SKILL.md


Đang tải

Các kỹ năng Openclaw liên quan

METADATA

Requires
Github Stars: 0
forks: 0

Đặc sắc*