Dùng Claude Code để chuẩn hóa cấu hình OpenClaw — thay vì nhờ OpenClaw tự sửa chính nó

Nếu bạn đang dùng OpenClaw và gặp tình huống: chạy openclaw doctor --fix nhiều lần, copy cấu hình từ nơi khác, cuối cùng vẫn fail — thì rất có thể vấn đề nằm ngoài khả năng xử lý của tool chẩn đoán tích hợp.

Vấn đề: openclaw doctor --fix không phải lúc nào cũng đủ

OpenClaw có sẵn lệnh openclaw doctor --fix để tự chẩn đoán và sửa lỗi cấu hình. Đây là giải pháp nhanh và tiện, nhưng nó có giới hạn:

• Chỉ sửa được các lỗi đã biết trước. Tool doctor hoạt động theo pattern matching — nếu lỗi của bạn nằm ngoài danh sách rule có sẵn, nó sẽ bỏ qua hoặc sửa không đúng chỗ.
• Không hiểu ngữ cảnh cụ thể của bạn. Cùng một config key, giá trị hợp lệ hay không còn phụ thuộc vào provider bạn dùng, model bạn chọn, và cách bạn setup Docker — doctor không thấy hết bức tranh này.
• Có thể sửa quá tay hoặc thiếu. Mình từng gặp case doctor reset lại config về mặc định, ghi đè cả phần đang chạy ổn — kết quả service lỗi nặng hơn trước.

Giải pháp: mở Claude Code tại thư mục OpenClaw

Thay vì trông chờ tool tự động, hãy dùng Claude Code — mở ngay tại thư mục chứa cấu hình OpenClaw.

cd ~/openclaw   # hoặc thư mục bạn cài OpenClaw
claude

Khi Claude Code khởi động tại đây, nó có quyền đọc trực tiếp mọi file trong thư mục: openclaw.json, docker-compose.yml, log runtime, AGENTS.md, .env — tất cả ngữ cảnh cần thiết để hiểu chính xác hệ thống đang ở trạng thái nào.

Đây là điểm khác biệt cốt lõi: Claude Code đọc file thật trên máy bạn và hiểu ngữ cảnh cụ thể — thứ mà openclaw doctor --fix không làm được.

Quy trình 7 bước chuẩn hóa cấu hình

Bước 1: Đọc log và config — chưa sửa gì cả

Việc đầu tiên là thu thập dữ liệu. Yêu cầu Claude Code:

"Đọc toàn bộ file cấu hình và log khởi động OpenClaw trong thư mục hiện tại. Nhóm lỗi lặp lại, xác định root cause gây fail, đề xuất thứ tự kiểm tra từ khả năng cao xuống thấp."

Claude Code sẽ dùng Read, Grep, Glob để quét file thật, không phải đoán từ prompt.

Bước 2: Đối chiếu với tài liệu chính thức

Sau khi có giả thuyết lỗi, yêu cầu Claude Code kiểm chéo với docs của phiên bản bạn đang chạy:

"Đối chiếu cấu hình hiện tại với hướng dẫn chính thức theo phiên bản đang dùng. Chỉ ra điểm lệch và mức độ ảnh hưởng của từng điểm."

Mục tiêu:
- Phát hiện key config sai tên (đổi theo version).
- Phát hiện field hợp lệ cú pháp nhưng sai ngữ nghĩa runtime.
- Phát hiện config thừa gây xung đột.

Bước 3: Sửa tối thiểu (minimal change)

Nguyên tắc vàng: mỗi thay đổi phải có lý do từ log, không sửa phần đang chạy ổn.

"Chỉ áp dụng thay đổi tối thiểu để khôi phục khả năng khởi động ổn định. Mỗi thay đổi ghi rõ: sửa gì, vì sao sửa, rủi ro nếu không sửa."

Claude Code sẽ dùng Edit để sửa trực tiếp file config — bạn thấy chính xác diff từng dòng trước khi approve.

Bước 4: Cấu hình fallback model

Sau khi service ổn định, thêm model dự phòng để tránh tắc việc khi model chính lỗi:

• Model chính + ít nhất 1 model backup.
• Thứ tự ưu tiên fallback rõ ràng.
• Điều kiện fallback: timeout, quota exceeded, provider error.
• Test gọi thử từng model sau khi cấu hình.

Bước 5: Chuẩn hóa AGENTS.md

Nhiều case fail không nằm ở Docker mà ở mô tả vai trò agent quá mơ hồ. Yêu cầu Claude Code review và chuẩn hóa:

• Main agent làm orchestrator, luôn trực nhận yêu cầu user.
• Task dài/chậm tách sub-agent xử lý.
• Sub-agent báo checkpoint theo từng mốc.
• Main agent tổng hợp kết quả và phản hồi nhất quán.

Bước 6: Verify sau sửa

Checklist bắt buộc sau mỗi vòng sửa:

• [ ] Service khởi động ổn định sau restart.
• [ ] Không còn lỗi khởi động lặp trong log mới.
• [ ] Model chính gọi được.
• [ ] Model fallback gọi được.
• [ ] Flow main agent → sub-agent chạy đúng vai trò.

Nếu fail, quay lại bước 1 và đọc log mới — không rollback cảm tính.

Bước 7: Lặp lại nếu cần

Quy trình này là vòng lặp có kiểm soát: đọc log → đối chiếu → sửa tối thiểu → verify. Mỗi vòng đều dựa trên dữ liệu mới, không đoán mò.

Prompt tổng hợp — copy dùng ngay

Mở Claude Code tại thư mục OpenClaw, paste prompt sau:

"Mục tiêu: chuẩn hóa cấu hình OpenClaw để khởi động ổn định.

Hãy thực hiện theo thứ tự:
1) Đọc toàn bộ log và config trong thư mục hiện tại, xác định root cause.
2) Đối chiếu với tài liệu chính thức đúng phiên bản.
3) Đề xuất thay đổi tối thiểu để khôi phục khởi động.
4) Áp dụng sửa đổi, giải thích từng thay đổi.
5) Thiết lập fallback model (primary + backup).
6) Chuẩn hóa AGENTS.md để main agent orchestrate đúng vai trò.
7) Chạy checklist verify và báo cáo kết quả từng mục."

Kết luận

Khi openclaw doctor --fix không giúp được nữa, đừng chạy lại thêm lần nữa. Hãy mở Claude Code ngay tại thư mục OpenClaw — để một công cụ có quyền đọc file thật, thấy log thật, và sửa chính xác từng dòng config.

Quy trình cốt lõi chỉ có vậy: đọc log → đối chiếu → sửa tối thiểu → verify. Đơn giản nhưng hiệu quả hơn rất nhiều so với mô tả lỗi qua chat và hy vọng agent tự hiểu.