Một người bạn đồng hành gỡ lỗi toàn diện giúp tự động hóa phân tích nhật ký, đề xuất các điểm ngắt chiến lược và lập bản đồ luồng thực thi để xác định nguyên nhân gốc rễ.
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 openclaw-debugger
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
~/.openclaw/skills/ <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 openclaw-debugger 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.
Trợ lý Gỡ lỗi là gì?
Trợ lý Gỡ lỗi là một công cụ mạnh mẽ được thiết kế để tăng tốc quá trình khắc phục sự cố trong khung Openclaw Skills. Nó đóng vai trò là cầu nối giữa các nhật ký lỗi thô và các giải pháp có thể thực hiện bằng cách thực hiện phân tích chuyên sâu về dấu vết ngăn xếp (stack trace), xác định các mẫu lỗi phổ biến và cung cấp thông tin chi tiết về cấu trúc hành vi của ứng dụng. Bằng cách tích hợp kỹ năng này, các nhà phát triển có thể chuyển từ kiểm tra thủ công sang quy trình chẩn đoán tự động bao gồm mọi thứ từ lỗi cú pháp đơn giản đến các vấn đề kết nối cơ sở dữ liệu phức tạp.
Kỹ năng này đặc biệt có giá trị để duy trì chất lượng mã và độ tin cậy của hệ thống. Nó không chỉ chỉ ra lỗi; nó giải thích lý do cơ bản, gợi ý những nơi tốt nhất để tạm dừng thực thi nhằm kiểm tra và trực quan hóa phân cấp lệnh gọi để ngăn ngừa các hồi quy (regression) trong tương lai. Cho dù bạn đang xử lý sự cố nghiêm trọng trong môi trường sản xuất hay nút thắt hiệu suất khó nắm bắt, thành phần này của Openclaw Skills đều cung cấp sự rõ ràng về mặt kỹ thuật cần thiết để giải quyết vấn đề một cách hiệu quả.
Trường hợp sử dụng Trợ lý Gỡ lỗi
- Phân tích các traceback Python phức tạp để xác định chính xác dòng và hàm gây ra lỗi kết nối cơ sở dữ liệu.
- Tạo danh sách các vị trí điểm ngắt ưu tiên cao trước khi thực hiện tái cấu trúc lớn trên các cơ sở mã cũ.
- Trực quan hóa biểu đồ gọi của một trình xử lý yêu cầu API cụ thể để xác định việc thiếu xử lý lỗi trong các hàm hạ nguồn (downstream).
- Lọc các tệp nhật ký lớn để tìm các mẫu lỗi cụ thể như KeyError hoặc TimeoutError bằng cách sử dụng các tập lệnh Openclaw Skills tự động.
- Khắc phục các nút thắt hiệu suất bằng cách theo dõi các đường dẫn thực thi qua các điểm cuối chậm.
Cách thức hoạt động của Trợ lý Gỡ lỗi
- Người dùng cung cấp nhật ký lỗi thô hoặc đường dẫn đến tệp nhật ký cho lệnh analyze-error, lệnh này sẽ xác định loại ngoại lệ và mức độ nghiêm trọng.
- Trợ lý quét mã nguồn liên quan để xác định nguyên nhân gốc rễ, chẳng hạn như kết nối cơ sở dữ liệu bị đóng hoặc giá trị null chưa được xử lý.
- Để gỡ lỗi cấu trúc, công cụ này phân tích logic của tệp để đề xuất các điểm ngắt tại các điểm nhập, nhánh điều kiện và các lệnh gọi API bên ngoài.
- Bộ theo dõi (tracer) tạo ra một biểu đồ gọi cho hàm đã chỉ định, hiển thị phân cấp các lệnh gọi nội bộ và bên ngoài để tiết lộ các điểm lỗi tiềm ẩn.
- Tất cả các phát hiện được tóm tắt cùng với các đề xuất có thể thực hiện, bao gồm các bản sửa lỗi mã cụ thể và việc triển khai kiểm tra sức khỏe.
Cài đặt Trợ lý Gỡ lỗi
Để bắt đầu sử dụng công cụ này trong môi trường Openclaw Skills của bạn, hãy đảm bảo rằng bạn có các tập lệnh cần thiết trong thư mục dự án của mình.
# Phân tích một thông báo lỗi cụ thể trực tiếp từ CLI
python3 scripts/main.py analyze-error "Traceback (most recent call last):..."
# Phân tích tệp nhật ký lỗi để chẩn đoán chuyên sâu hơn
python3 scripts/main.py analyze-error --file path/to/error.log
# Nhận các vị trí điểm ngắt được đề xuất cho một tệp cụ thể
python3 scripts/main.py suggest-breakpoints --file src/logic.py
# Theo dõi luồng thực thi của một hàm cụ thể
python3 scripts/main.py trace --file src/app.py --function process_data
Lược đồ dữ liệu & Hệ thống phân loại của Trợ lý Gỡ lỗi
Kỹ năng Gỡ lỗi tổ chức logic và cấu hình của nó thông qua một tập hợp các tệp có cấu trúc và JSON schemas để đảm bảo khả năng tương thích với các Openclaw Skills khác.
| Tệp | Mục đích | Loại dữ liệu |
|---|---|---|
.debugging.json |
Cấu hình toàn cục cho logic điểm ngắt và lọc lỗi. | JSON |
error_analyzer.py |
Công cụ cốt lõi để phân tích traceback và xác định nguyên nhân gốc rễ. | Python |
tracer.py |
Xử lý việc tạo biểu đồ gọi và lập bản đồ đường dẫn thực thi. | Python |
SKILL.md |
Tài liệu và thông số kỹ thuật cho kỹ năng. | Markdown |
Schema Cấu hình (.debugging.json):
breakpoints: Kiểm soát thời điểm các đề xuất được kích hoạt (ví dụ: trước các lệnh gọi bên ngoài).error_patterns: Cho phép người dùng bỏ qua các cảnh báo cụ thể hoặc làm nổi bật các lỗi bảo mật nghiêm trọng.
Tính năng Nâng cao của Trợ lý Gỡ lỗi
- Nhận dạng mẫu lỗi có thể tùy chỉnh cho phép người dùng xác định các cảnh báo ưu tiên cao cho các ngoại lệ bảo mật hoặc mất dữ liệu cụ thể.
- Trực quan hóa biểu đồ gọi tự động để đơn giản hóa việc hiểu các lệnh gọi hàm lồng nhau sâu và các phụ thuộc.
- Đề xuất điểm ngắt có nhận thức logic ưu tiên các điểm nhập và tương tác dịch vụ bên ngoài để tối đa hóa hiệu quả gỡ lỗi.
- Tích hợp liền mạch với các quy trình làm việc Openclaw Skills hiện có để cung cấp giao diện khắc phục sự cố thống nhất cho các hệ thống đa tác nhân.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Phân tích và tối ưu hóa hiệu năng
Một công cụ phân tích và lập hồ sơ hiệu năng toàn diện được thiết kế để xác định các điểm nghẽn mã nguồn và cung cấp các đề xuất tối ưu hóa có thể hành động.
Trình quản lý Bản ghi Quyết định Kiến trúc (ADR)
Một công cụ toàn diện để tạo, theo dõi và lint các Bản ghi Quyết định Kiến trúc (ADR) nhằm duy trì một lịch sử minh bạch và có thể tìm kiếm được về các quyết định kỹ thuật.
Coding Agent
Một kỹ năng meta-agent mạnh mẽ giúp ủy quyền các tác vụ phát triển phức tạp cho các AI agent chuyên dụng như Codex và Claude Code bằng cách sử dụng các quy trình bash nền.
ClawTipShopTester
Một trợ lý viết nội dung AI chuyên dụng và công cụ kiểm tra tích hợp thanh toán cho hệ sinh thái Openclaw.
Tạo và chỉnh sửa video Wan 2.7
Một bộ công cụ tạo và chỉnh sửa video mạnh mẽ được cung cấp bởi các mô hình Wan 2.7 của Alibaba để tạo ra nội dung điện ảnh độ phân giải cao 720P và 1080P.
Công cụ Tối ưu hóa Luồng công việc OSOP
Một công cụ chuyên dụng phân tích lịch sử thực thi để tự động cải thiện hiệu suất và độ tin cậy của các luồng công việc OSOP.
Đặc sắc*
