Chuyển đến nội dung chính
Quy trình làm việc dành cho nhà phát triển đối với runtime của agent (src/agents/) trong kho lưu trữ OpenClaw.

Kiểm tra kiểu và lint

  • Cổng kiểm tra cục bộ mặc định: pnpm check (kiểm tra kiểu, lint, các biện pháp bảo vệ chính sách)
  • Cổng kiểm tra bản dựng: pnpm build khi thay đổi có thể ảnh hưởng đến đầu ra bản dựng, việc đóng gói hoặc các ranh giới tải lười/mô-đun
  • Cổng kiểm tra đầy đủ trước khi đẩy lên: pnpm build && pnpm check && pnpm check:test-types && pnpm test

Chạy các bài kiểm thử runtime của agent

Chạy các bộ kiểm thử đơn vị cho runtime của agent:
Mẫu glob đầu tiên cũng bao gồm các bộ kiểm thử agent-tools*, agent-settingsagent-tool-definition-adapter*. Các bài kiểm thử trực tiếp bị loại khỏi cấu hình kiểm thử đơn vị; hãy chạy chúng thông qua trình bao kiểm thử trực tiếp (thiết lập OPENCLAW_LIVE_TEST=1 và yêu cầu thông tin xác thực của nhà cung cấp):

Kiểm thử thủ công

  • Chạy Gateway ở chế độ phát triển (bỏ qua kết nối kênh thông qua OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
  • Kích hoạt một lượt agent thông qua Gateway: pnpm openclaw agent --message "Hello" --thinking low
  • Sử dụng TUI để gỡ lỗi tương tác: pnpm tui
Để kiểm tra hành vi gọi công cụ, hãy yêu cầu một thao tác read hoặc exec để có thể theo dõi việc truyền trực tuyến từ công cụ và xử lý tải trọng.

Đặt lại về trạng thái sạch

Trạng thái nằm trong thư mục trạng thái của OpenClaw: mặc định là ~/.openclaw, hoặc $OPENCLAW_STATE_DIR khi được thiết lập. Các đường dẫn tương đối với thư mục đó: Xóa các đường dẫn đó để đặt lại hoàn toàn. Các tùy chọn đặt lại có phạm vi hẹp hơn:
  • Chỉ phiên: không xóa agents/<agentId>/agent/openclaw-agent.sqlite; các hàng phiên nằm ở đó cùng với trạng thái khác theo từng agent. Sử dụng /new hoặc /reset để bắt đầu một phiên mới cho một cuộc trò chuyện và openclaw sessions cleanup để bảo trì phiên.
  • Giữ lại xác thực: giữ nguyên agents/<agentId>/agent/openclaw-agent.sqlitecredentials/.
Các tệp auth-profiles.json cũ không còn được đọc trong thời gian chạy; openclaw doctor --fix nhập chúng vào kho SQLite.

Tài liệu tham khảo

Liên quan