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

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw có thể tạo một tệp zip chẩn đoán cục bộ cho báo cáo lỗi. Tệp này kết hợp trạng thái Gateway đã được làm sạch, tình trạng hoạt động, nhật ký, hình dạng cấu hình và các sự kiện ổn định gần đây không chứa payload. Hãy xem các gói chẩn đoán như bí mật cho đến khi bạn đã rà soát chúng. Chúng được thiết kế để bỏ qua hoặc biên tập lại payload và thông tin xác thực, nhưng vẫn tóm tắt nhật ký Gateway cục bộ và trạng thái runtime ở cấp máy chủ.

​
Bắt đầu nhanh

openclaw gateway diagnostics export
Lệnh này in ra đường dẫn zip đã ghi. Để chọn đường dẫn: 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
Cho tự động hóa: 
openclaw gateway diagnostics export --json

​
Lệnh chat

Chủ sở hữu có thể dùng /diagnostics [note] trong chat để yêu cầu xuất Gateway cục bộ. Dùng lệnh này khi lỗi xảy ra trong một cuộc trò chuyện thực tế và bạn muốn có một báo cáo có thể sao chép-dán cho bộ phận hỗ trợ:
  1. Gửi /diagnostics trong cuộc trò chuyện nơi bạn nhận thấy vấn đề. Thêm một ghi chú ngắn nếu hữu ích, ví dụ /diagnostics bad tool choice.
  2. OpenClaw gửi phần mở đầu chẩn đoán và yêu cầu một phê duyệt exec rõ ràng. Phê duyệt này chạy openclaw gateway diagnostics export --json. Không phê duyệt chẩn đoán thông qua quy tắc cho phép tất cả.
  3. Sau khi được phê duyệt, OpenClaw trả lời bằng một báo cáo có thể dán, chứa đường dẫn gói cục bộ, tóm tắt manifest, ghi chú quyền riêng tư và các ID phiên liên quan.
Trong chat nhóm, chủ sở hữu vẫn có thể chạy /diagnostics, nhưng OpenClaw không đăng chi tiết chẩn đoán trở lại chat chung. Nó gửi phần mở đầu, lời nhắc phê duyệt, kết quả xuất Gateway và phân tách phiên/luồng Codex cho chủ sở hữu thông qua tuyến phê duyệt riêng tư. Nhóm chỉ nhận được một thông báo ngắn rằng luồng chẩn đoán đã được gửi riêng tư. Nếu OpenClaw không tìm thấy tuyến chủ sở hữu riêng tư, lệnh sẽ đóng an toàn và yêu cầu chủ sở hữu chạy lệnh từ DM. Khi phiên OpenClaw đang hoạt động dùng harness OpenAI Codex native, cùng phê duyệt exec đó cũng bao gồm một lần tải phản hồi OpenAI lên cho các luồng runtime Codex mà OpenClaw biết. Lần tải lên đó tách biệt với tệp zip Gateway cục bộ và chỉ xuất hiện cho các phiên harness Codex. Trước khi phê duyệt, lời nhắc giải thích rằng việc phê duyệt chẩn đoán cũng sẽ gửi phản hồi Codex, nhưng không liệt kê ID phiên hoặc ID luồng Codex. Sau khi phê duyệt, phản hồi chat liệt kê các kênh, ID phiên OpenClaw, ID luồng Codex và các lệnh resume cục bộ cho những luồng đã được gửi đến máy chủ OpenAI. Nếu bạn từ chối hoặc bỏ qua phê duyệt, OpenClaw không chạy xuất, không gửi phản hồi Codex và không in các ID Codex. Điều đó làm cho vòng lặp gỡ lỗi Codex phổ biến trở nên ngắn gọn: nhận thấy hành vi không đúng trong Telegram, Discord hoặc kênh khác, chạy /diagnostics, phê duyệt một lần, chia sẻ báo cáo với bộ phận hỗ trợ, rồi chạy lệnh codex resume <thread-id> đã in cục bộ nếu bạn muốn tự kiểm tra luồng Codex native. Xem harness Codex để biết quy trình kiểm tra đó.

​
Nội dung bản xuất chứa gì

Tệp zip bao gồm:
  • summary.md: tổng quan dễ đọc cho con người dành cho bộ phận hỗ trợ.
  • diagnostics.json: tóm tắt dạng máy đọc được về cấu hình, nhật ký, trạng thái, tình trạng hoạt động và dữ liệu ổn định.
  • manifest.json: siêu dữ liệu bản xuất và danh sách tệp.
  • Hình dạng cấu hình đã được làm sạch và chi tiết cấu hình không bí mật.
  • Tóm tắt nhật ký đã được làm sạch và các dòng nhật ký gần đây đã được biên tập lại.
  • Ảnh chụp nhanh trạng thái và tình trạng hoạt động Gateway theo nỗ lực tốt nhất.
  • stability/latest.json: gói ổn định đã được lưu bền vững mới nhất, khi có.
Bản xuất vẫn hữu ích ngay cả khi Gateway không khỏe. Nếu Gateway không thể trả lời yêu cầu trạng thái hoặc tình trạng hoạt động, nhật ký cục bộ, hình dạng cấu hình và gói ổn định mới nhất vẫn được thu thập khi có.

​
Mô hình quyền riêng tư

Chẩn đoán được thiết kế để có thể chia sẻ. Bản xuất giữ lại dữ liệu vận hành giúp gỡ lỗi, chẳng hạn như:
  • tên hệ thống con, ID Plugin, ID nhà cung cấp, ID kênh và các chế độ đã cấu hình
  • mã trạng thái, thời lượng, số byte, trạng thái hàng đợi và chỉ số bộ nhớ
  • siêu dữ liệu nhật ký đã được làm sạch và thông báo vận hành đã được biên tập lại
  • hình dạng cấu hình và thiết lập tính năng không bí mật
Bản xuất bỏ qua hoặc biên tập lại:
  • văn bản chat, prompt, chỉ dẫn, thân Webhook và đầu ra công cụ
  • thông tin xác thực, khóa API, token, cookie và giá trị bí mật
  • thân yêu cầu hoặc phản hồi thô
  • ID tài khoản, ID tin nhắn, ID phiên thô, tên máy chủ và tên người dùng cục bộ
Khi một thông báo nhật ký trông giống văn bản payload của người dùng, chat, prompt hoặc công cụ, bản xuất chỉ giữ lại thông tin rằng một thông báo đã bị bỏ qua và số byte.

​
Bộ ghi ổn định

Gateway mặc định ghi lại một luồng ổn định có giới hạn, không chứa payload khi chẩn đoán được bật. Luồng này dành cho các dữ kiện vận hành, không phải nội dung. Cùng Heartbeat chẩn đoán đó ghi lại các mẫu liveness khi Gateway vẫn chạy nhưng vòng lặp sự kiện Node.js hoặc CPU có vẻ bão hòa. Các sự kiện diagnostic.liveness.warning này bao gồm độ trễ vòng lặp sự kiện, mức sử dụng vòng lặp sự kiện, tỷ lệ lõi CPU, số lượng phiên đang hoạt động/đang chờ/đã xếp hàng, pha khởi động/runtime hiện tại khi biết, các khoảng pha gần đây và nhãn công việc đang hoạt động/đã xếp hàng có giới hạn. Các mẫu nhàn rỗi vẫn nằm trong telemetry ở cấp info. Mẫu liveness chỉ trở thành cảnh báo Gateway khi có công việc đang chờ hoặc đã xếp hàng, hoặc khi công việc đang hoạt động chồng lấn với độ trễ vòng lặp sự kiện kéo dài. Các đột biến độ trễ tối đa thoáng qua trong khi công việc nền vẫn khỏe mạnh sẽ ở lại nhật ký debug. Chúng không tự khởi động lại Gateway. Các pha khởi động cũng phát sự kiện diagnostic.phase.completed với thời gian đồng hồ treo tường và thời gian CPU. Chẩn đoán embedded-run bị kẹt đánh dấu terminalProgressStale=true khi tiến trình bridge cuối cùng trông có vẻ kết thúc, chẳng hạn như một mục phản hồi thô hoặc sự kiện hoàn tất phản hồi, nhưng Gateway vẫn xem lần chạy nhúng là đang hoạt động. Kiểm tra bộ ghi trực tiếp: 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
Kiểm tra gói ổn định đã lưu bền vững mới nhất sau khi thoát nghiêm trọng, hết thời gian chờ tắt hoặc lỗi khởi động lại: 
openclaw gateway stability --bundle latest
Tạo tệp zip chẩn đoán từ gói đã lưu bền vững mới nhất: 
openclaw gateway stability --bundle latest --export
Các gói đã lưu bền vững nằm trong ~/.openclaw/logs/stability/ khi có sự kiện.

​
Tùy chọn hữu ích

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>: ghi vào một đường dẫn zip cụ thể.
  • --log-lines <count>: số dòng nhật ký đã làm sạch tối đa cần đưa vào.
  • --log-bytes <bytes>: số byte nhật ký tối đa cần kiểm tra.
  • --url <url>: URL WebSocket Gateway cho ảnh chụp nhanh trạng thái và tình trạng hoạt động.
  • --token <token>: token Gateway cho ảnh chụp nhanh trạng thái và tình trạng hoạt động.
  • --password <password>: mật khẩu Gateway cho ảnh chụp nhanh trạng thái và tình trạng hoạt động.
  • --timeout <ms>: thời gian chờ ảnh chụp nhanh trạng thái và tình trạng hoạt động.
  • --no-stability-bundle: bỏ qua tra cứu gói ổn định đã lưu bền vững.
  • --json: in siêu dữ liệu bản xuất dạng máy đọc được.

​
Tắt chẩn đoán

Chẩn đoán được bật theo mặc định. Để tắt bộ ghi ổn định và thu thập sự kiện chẩn đoán: 
{
  diagnostics: {
    enabled: false,
  },
}
Tắt chẩn đoán làm giảm chi tiết báo cáo lỗi. Việc này không ảnh hưởng đến ghi nhật ký Gateway bình thường.

​
Liên quan