Chuyển đổi model OpenClaw
Chẩn đoán và sửa file openclaw.json một cách an toàn để đổi model OpenClaw và khắc phục lỗi 401, "no available channel", thinking level không hỗ trợ.
Lập trìnhNâng cao★ 1,323⑂ 212Điểm AI 8/10Cập nhật lần cuối: 8 thg 8, 2026
Làm được gì
- Tìm đúng file cấu hình mà gateway thực sự đọc (kiểm tra
~/.openclaw/openclaw.json, bản mirror của Kimi Claw, đường dẫn cũ) và đồng bộ tất cả bản mirror. - Trước khi sửa cấu hình, gửi một request completion thật bằng
curlđể xác minh endpoint + model (không tin danh sách/v1/modelscủa relay). - Dùng
scripts/switch-model.pyđể sao lưu, thêm định nghĩa model, đặtagents.defaults.model.primaryvà khởi động lại gateway. - Bắt buộc xác minh đầu-cuối bằng một lượt agent thật:
result: successvàfallbackUsed: false. - Bảng tra triệu chứng → nguyên nhân: biến môi trường
KIMI_API_KEYchiếm quyền key, plugin giới hạn thinking nhị phân, model không được phục vụ cho group, sửa sai file/mirror.
Phù hợp với ai
- Người tự vận hành bot OpenClaw / 龙虾 và thường nâng cấp hoặc rollback model (k2p6 → k3).
- Người bị lỗi 401 hoặc luôn bị fallback sau khi đổi model mà chưa tìm ra nguyên nhân.
- Quản trị viên gặp tình trạng "sửa rồi nhưng cấu hình bị ghi đè lại".
Ví dụ sử dụng
- "Nâng model OpenClaw lên k3" → xác định file cấu hình → probe curl trả HTTP 200 →
switch-model.py k3 --restart→ chạy lượt agent để kiểm chứng. - "Bot báo
Invalid tokendù token dùng curl vẫn ổn" → chẩn đoán bẫy #1: biến môi trường chiếm quyền key của provider. - "Gặp
Thinking level \"max\" is not supported" → hướng dẫn vòng qua giới hạn của kimi-provider bằng custom provider hoặcparams.canonicalModelId.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/openclaw-model-switch/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục openclaw-model-switch từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/openclaw-model-switch/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal.
- Tải repo:
git clone https://github.com/daymade/claude-code-skills.git - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r claude-code-skills/openclaw-model-switch ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/openclaw-model-switchphải thấySKILL.md,scripts/,references/. - Mở lại Claude Code và yêu cầu ví dụ: "đổi model OpenClaw sang k3".
- Cần có sẵn: CLI
openclaw,python3,curlvà baseUrl/apiKey của relay. Tuyệt đối không commit file cấu hình chứa API key lên git.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT