OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Get started

Khắc phục sự cố

Khắc phục sự cố

clawhub login mở trình duyệt nhưng không bao giờ hoàn tất

CLI khởi động một máy chủ callback cục bộ tồn tại trong thời gian ngắn khi đăng nhập bằng trình duyệt.

  • Đảm bảo trình duyệt của bạn có thể truy cập http://127.0.0.1:<port>/callback.
  • Kiểm tra các quy tắc tường lửa cục bộ, VPN và proxy nếu callback không bao giờ đến.
  • Trong môi trường không giao diện, hãy tạo token API trong giao diện web ClawHub và chạy:
bash
clawhub login --token clh_...

whoami hoặc publish trả về Unauthorized (401)

  • Đăng nhập lại bằng clawhub login.
  • Nếu bạn sử dụng đường dẫn cấu hình tùy chỉnh, hãy xác nhận CLAWHUB_CONFIG_PATH trỏ đến tệp chứa token hiện tại của bạn.
  • Nếu bạn sử dụng token API, hãy xác nhận token đó chưa bị thu hồi trong giao diện web.

Tìm kiếm hoặc cài đặt trả về Rate limit exceeded (429)

Đọc thông tin thử lại trong phản hồi:

  • Retry-After: số giây cần chờ trước khi thử lại.
  • RateLimit-Limit: giới hạn được áp dụng cho yêu cầu này.
  • RateLimit-Remaining: hạn mức chính xác còn lại của bạn khi có tiêu đề này. Trên 429, giá trị là 0.
  • RateLimit-Reset hoặc X-RateLimit-Reset: thời điểm đặt lại.

Nếu nhiều người dùng dùng chung một IP đầu ra, giới hạn IP ẩn danh có thể bị chạm đến ngay cả khi mỗi người chỉ gửi một vài yêu cầu. Hãy đăng nhập khi có thể và thử lại sau khoảng thời gian trì hoãn được báo cáo.

Tìm kiếm hoặc cài đặt thất bại khi dùng proxy

CLI tuân theo các biến proxy tiêu chuẩn:

bash
export HTTPS_PROXY=http://proxy.example.com:3128clawhub search "my query"

Các tên được hỗ trợ gồm HTTPS_PROXY, HTTP_PROXY, https_proxy và http_proxy.

Một skill không xuất hiện trong kết quả tìm kiếm

  • Kiểm tra slug chính xác hoặc trang của chủ sở hữu nếu bạn biết.
  • Xác nhận bản phát hành ở chế độ công khai và không bị giữ lại do quét hoặc kiểm duyệt.
  • Nếu bạn sở hữu skill, hãy đăng nhập và kiểm tra skill đó:
bash
clawhub inspect @openclaw/demo

Thông tin chẩn đoán chỉ chủ sở hữu có thể xem có thể giải thích trạng thái quét, cổng tải lên hoặc kiểm duyệt.

Đăng tải thất bại vì thiếu siêu dữ liệu bắt buộc

Đối với skill, hãy kiểm tra frontmatter SKILL.md. Các biến môi trường và công cụ bắt buộc phải được khai báo để người dùng và trình quét có thể hiểu gói.

Đối với plugin, hãy kiểm tra siêu dữ liệu tương thích package.json. Việc đăng tải code-plugin cần các trường tương thích với OpenClaw như openclaw.compat.pluginApi và openclaw.build.openclawVersion.

Trước tiên, hãy xem trước tải trọng đăng tải:

bash
clawhub package publish <source> --family code-plugin --dry-run

Đăng tải thất bại do lỗi chủ sở hữu hoặc nguồn GitHub

ClawHub sử dụng danh tính GitHub và thông tin ghi nhận nguồn để liên kết các gói với nhà phát hành của chúng.

  • Đảm bảo bạn đã đăng nhập bằng tài khoản GitHub sở hữu hoặc có thể đăng tải gói.
  • Kiểm tra xem URL nguồn có công khai hoặc ClawHub có thể truy cập hay không.
  • Đối với nguồn GitHub, hãy sử dụng owner/repo, owner/repo@ref hoặc URL GitHub đầy đủ.

Đăng tải thất bại vì không gian tên đã được xác nhận quyền sở hữu hoặc được dành riêng

Nếu việc đăng tải thất bại vì tên định danh chủ sở hữu, không gian tên tổ chức, phạm vi gói, slug skill hoặc tên gói đã được xác nhận quyền sở hữu hoặc dành riêng, trước tiên hãy xác nhận rằng bạn đang đăng tải bằng chủ sở hữu khớp với không gian tên. Đối với các gói plugin, các tên có phạm vi như @example-org/example-plugin phải được đăng tải dưới chủ sở hữu example-org tương ứng.

Nếu bạn cho rằng tổ chức, dự án hoặc thương hiệu của mình là chủ sở hữu hợp pháp của không gian tên nhưng không thể quản lý chủ sở hữu ClawHub hiện tại, hãy mở một vấn đề xác nhận quyền sở hữu tổ chức / không gian tên kèm bằng chứng công khai, không nhạy cảm. Xem Xác nhận quyền sở hữu tổ chức và không gian tên để biết hướng dẫn về bằng chứng và nội dung không nên đưa vào các vấn đề công khai.

sync cho biết không tìm thấy skill nào

sync tìm các thư mục chứa SKILL.md hoặc skill.md.

Hãy trỏ lệnh đến các thư mục gốc bạn muốn quét:

bash
clawhub sync --root /path/to/skills

Nếu bạn không chắc nội dung nào sẽ được đăng tải, hãy xem trước:

bash
clawhub sync --all --dry-run --no-input

update từ chối vì có thay đổi cục bộ

Các tệp cục bộ không khớp với bất kỳ phiên bản nào mà ClawHub biết. Hãy chọn một phương án:

  • Giữ các chỉnh sửa cục bộ và bỏ qua bản cập nhật.
  • Ghi đè bằng phiên bản đã đăng tải:
bash
clawhub update @openclaw/demo --force
  • Đăng tải bản sao đã chỉnh sửa của bạn dưới dạng một slug mới hoặc fork.

Cài đặt plugin thất bại trong OpenClaw

  • Sử dụng nguồn ClawHub rõ ràng:
bash
openclaw plugins install clawhub:<package>
  • Kiểm tra trang chi tiết gói để xem trạng thái quét và siêu dữ liệu tương thích.
  • Xác nhận phiên bản OpenClaw của bạn đáp ứng phạm vi tương thích mà gói công bố.
  • Nếu gói bị ẩn, giữ lại hoặc chặn, gói có thể không cài đặt được cho đến khi chủ sở hữu giải quyết vấn đề.

Yêu cầu API công khai thất bại

  • Tuân thủ các tiêu đề thử lại 429 và lưu vào bộ nhớ đệm các phản hồi danh sách/tìm kiếm công khai.
  • Liên kết người dùng trở lại trang niêm yết ClawHub chính thức.
  • Không sao chép nội dung bị ẩn, riêng tư, giữ lại hoặc bị chặn do kiểm duyệt ra ngoài bề mặt API công khai.

Xem API HTTP để biết chi tiết về endpoint.

Was this useful?
On this page

On this page