Một khung gỡ lỗi hệ thống được thiết kế để xác định và giải quyết các lỗi của agent AI, vòng lặp vô hạn và các nút thắt tài nguyên.
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 agent-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 agent-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.
Agent Debugger là gì?
Agent Debugger là một bộ công cụ chuyên dụng trong thư viện Openclaw Skills được xây dựng để xử lý các thách thức độc đáo trong quá trình phát triển agent AI. Nó cung cấp một cách tiếp cận có cấu trúc để chẩn đoán các sự cố agent tự trị phổ biến như tràn ngữ cảnh, giới hạn tốc độ và lỗi quyền truy cập. Bằng cách triển khai các giao thức gỡ lỗi này, các nhà phát triển có thể đảm bảo các agent của họ luôn đáng tin cậy, hiệu quả và có khả năng phục hồi sau các lỗi công cụ hoặc vòng lặp logic không mong muốn.
Kỹ năng này đóng vai trò là người bạn đồng hành thiết yếu cho bất kỳ ai đang xây dựng các quy trình làm việc của agent phức tạp, cung cấp cả các mô hình chẩn đoán và các đoạn mã cụ thể để khắc phục. Cho dù bạn đang đối mặt với một chuỗi lập luận bị bế tắc hay bộ nhớ bị phân mảnh, Agent Debugger đều cung cấp các rào chắn kỹ thuật cần thiết để ổn định hiệu suất của agent và tối ưu hóa việc tiêu thụ token.
Trường hợp sử dụng Agent Debugger
- Giải quyết các vòng lặp vô hạn nơi agent lặp lại cùng một lần gọi công cụ hoặc mẫu đầu ra.
- Gỡ lỗi các lỗi công cụ do không khớp schema, thiếu quyền hoặc hết thời gian chờ API.
- Quản lý tràn ngữ cảnh và lỗi 'context length exceeded' trong các cuộc hội thoại kéo dài.
- Triển khai exponential backoff và hàng đợi yêu cầu để xử lý giới hạn tốc độ của nhà cung cấp.
- Khắc phục các sự cố bộ nhớ nơi agent mất dấu các quyết định trước đó hoặc không tải được MEMORY.md.
Cách thức hoạt động của Agent Debugger
- Tái hiện: Tài liệu hóa các bước và đầu vào chính xác gây ra hành vi sai trái hoặc lỗi.
- Cô lập: Đơn giản hóa nhiệm vụ, vô hiệu hóa các Openclaw Skills không cần thiết và giảm thiểu ngữ cảnh để tìm điểm lỗi cụ thể.
- Chẩn đoán: Phân tích nhật ký, kiểm tra việc sử dụng token hiện tại và xác minh các cài đặt cấu hình công cụ.
- Khắc phục: Áp dụng các biện pháp khắc phục như thêm giới hạn vòng lặp, logic thử lại hoặc nén ngữ cảnh.
- Ngăn ngừa: Cập nhật hướng dẫn của agent với các rào chắn mới và tài liệu hóa giải pháp trong bộ nhớ của agent để tránh tái diễn.
Cài đặt Agent Debugger
Để bắt đầu sử dụng các giao thức gỡ lỗi được cung cấp bởi kỹ năng này, hãy đảm bảo workspace của bạn được cấu hình chính xác cho việc phát triển Openclaw Skills:
# Xác minh cấu trúc workspace của bạn
ls -la ~/.openclaw/workspace/
# Đảm bảo các tệp bộ nhớ có mặt
touch ~/.openclaw/workspace/MEMORY.md
Cấu hình agent của bạn với tư duy chi tiết (verbose thinking) để lộ ra lập luận nội bộ trong giai đoạn gỡ lỗi:
{
"thinking": "verbose",
"reasoning": "on"
}
Lược đồ dữ liệu & Hệ thống phân loại của Agent Debugger
Agent Debugger sử dụng một cách tiếp cận có cấu trúc để phân loại và theo dõi các lỗi của agent. Dưới đây là bảng ánh xạ lỗi chính được sử dụng bởi kỹ năng này:
| Mã lỗi | Nguyên nhân chính | Chiến lược khắc phục |
|---|---|---|
context_length_exceeded |
Dữ liệu lịch sử/tệp quá mức | Tóm tắt & Cắt bớt |
rate_limit_exceeded |
Giới hạn tần suất API | Backoff & Hàng đợi |
tool_not_found |
Không khớp đăng ký | Kiểm tra cài đặt & Đường dẫn |
permission_denied |
Hạn chế hộp cát | Điều chỉnh chính sách |
invalid_parameters |
Vi phạm Schema | Xác thực đầu vào |
Tính năng Nâng cao của Agent Debugger
- Giới hạn vòng lặp: Xác định maxIterations và hành vi onLimit để tự động phá vỡ các vòng lặp vô hạn.
- Nén ngữ cảnh thích ứng: Sử dụng động các offset và limit cho các lần đọc tệp lớn để ngăn tràn ngữ cảnh.
- Logic thử lại tùy chỉnh: Triển khai các chiến lược thử lại chi tiết đặc biệt cho các lỗi 5xx hoặc hết thời gian chờ.
- Tối ưu hóa công cụ song song: Kết hợp nhiều thao tác đọc thành các lần gọi duy nhất để giảm độ trễ.
- Checkpointing: Định kỳ lưu trạng thái agent để cho phép tiếp tục trong các nhiệm vụ chạy lâu.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Tự động hóa tác vụ
Một bộ công cụ toàn diện để tự động hóa các công việc lặp đi lặp lại thông qua các tập lệnh, tác vụ được lập lịch và quy trình làm việc nhiều bước phức tạp.
Protein Mining Skill
Một đường ống tự động từ đầu đến cuối để khám phá protein, chuyển đổi từ khảo sát tài liệu sang phân tích cấu trúc và ưu tiên thực nghiệm.
Baidu Hot Topics Monitor
Một công cụ tinh gọn để giám sát các tìm kiếm thịnh hành, thứ hạng và chỉ số phổ biến theo thời gian thực của Baidu trực tiếp từ quy trình làm việc của AI agent.
Chuyên gia Mô hình hóa AI & Công thức Optimacros
Một trợ lý AI chuyên biệt cho các nhà phát triển Optimacros tập trung vào các công thức phức tạp, kiến trúc mô hình và bảo mật truy cập cấp doanh nghiệp.
Biểu đồ USD tiền điện tử thời gian thực
Nguồn cấp dữ liệu WebSocket thời gian thực hiệu suất cao cung cấp các tick OHLC 1 giây và giá USD cho hàng nghìn token trên tám mạng blockchain lớn.
Multi Search Engine
Một kỹ năng tổng hợp tìm kiếm toàn diện hỗ trợ 17 công cụ toàn cầu và trong nước với bộ lọc nâng cao và không yêu cầu khóa API.
SEO Article Agent
Một tác nhân viết AI chuyên dụng giúp chuyển đổi từ khóa thành các bài viết dài, có cấu trúc và được tối ưu hóa SEO.
Đặc sắc*
