OpenClaw cho người mới #5: Khi nào nên gọi coding agent (Codex/Claude Code/Pi)?

Cập nhật lần cuối: 19/03/2026 | Phiên bản: 1.0

TL;DR: Agent chính của OpenClaw giỏi quản lý email, lịch, tin nhắn và workflow cá nhân, nhưng không phải chuyên gia code. Khi cần viết code, debug, refactor hoặc làm việc với codebase, bạn nên gọi coding agent chuyên biệt như Codex, Claude Code, Pi, OpenCode hoặc Gemini CLI thông qua ACP (Agent Client Protocol).

Bối cảnh: Tại sao agent chính không tự code luôn?

Agent chính của OpenClaw được tối ưu cho vai trò trợ lý cá nhân đa năng. Nó có thể chạy lệnh shell cơ bản, nhưng việc hiểu codebase lớn, chạy test, sửa lỗi compile hay refactor nhiều file là sở trường của các coding agent chuyên biệt. Thiết kế đúng là: agent chính điều phối, coding agent thực thi code.

Hai cơ chế gọi agent con trong OpenClaw

1. Sub-agents

Sub-agent là agent con chạy trong runtime của chính OpenClaw. Phù hợp cho nghiên cứu, xử lý dữ liệu song song, hoặc task không cần coding harness chuyên biệt.

2. ACP agents

ACP là cơ chế để OpenClaw gọi các coding agent bên ngoài như Codex, Claude Code, Pi, OpenCode hoặc Gemini CLI. Khi bạn nói “chạy cái này trong Codex” hoặc “mở Claude Code trong thread mới”, OpenClaw sẽ route request qua ACP.

Quy tắc chọn nhanh: task không cần coding sâu → sub-agent. Task cần thao tác codebase thực sự → ACP coding agent.

Các coding agent — Ai giỏi gì?

Codex

Codex mạnh ở quick fix, sửa test fail, lint, one-shot execution và các tác vụ code ngắn gọn. Đây thường là default agent trong nhiều setup OpenClaw.

Claude Code

Claude Code mạnh ở refactor phức tạp, reasoning sâu, hiểu nhiều file cùng lúc và thiết kế architecture. Rất hợp cho các task coding dài hơi hoặc chỉnh cấu hình OpenClaw phức tạp.

Pi

Pi là lựa chọn nhẹ, mã nguồn mở, model-agnostic và phù hợp nếu bạn muốn dùng model local hoặc giữ pipeline riêng tư hơn.

OpenCode và Gemini CLI

Hai lựa chọn này phù hợp khi bạn đã dùng hệ sinh thái tương ứng hoặc cần khả năng đặc thù của provider.

Flowchart: Khi nào gọi coding agent?

Quản lý email, lịch, chat, web search, automation → agent chính xử lý.
Chạy lệnh shell đơn giản → agent chính dùng system.run.
Viết script ngắn, không cần hiểu codebase → agent chính có thể tự xử lý.
Fix bug, chạy test, debug compile → gọi coding agent.
Refactor nhiều file, thay đổi architecture → ưu tiên Claude Code.
Task code dùng model local → cân nhắc Pi hoặc OpenCode.

Cấu hình ACP cơ bản

{
  "acp": {
    "enabled": true,
    "backend": "acpx",
    "defaultAgent": "codex",
    "allowedAgents": ["pi", "claude", "codex", "opencode", "gemini", "kimi"],
    "maxConcurrentSessions": 8,
    "runtime": { "ttlMinutes": 120 }
  }
}

Các trường quan trọng gồm defaultAgent, allowedAgents, maxConcurrentSessions và ttlMinutes. Thiết lập này giúp kiểm soát chi phí, số lượng phiên song song và thời gian sống của session.

Thread binding và mode hoạt động

ACP session có thể gắn vào thread riêng để tách biệt khỏi chat chính. Bạn có thể dùng:

Oneshot: chạy một lần xong.
Persistent session: giữ ngữ cảnh qua nhiều lượt để pair programming hoặc phát triển feature.
Run mode: fire-and-forget, agent chính giao việc và nhận kết quả khi xong.

Pattern thực tế

Orchestrator pattern: agent chính nhận yêu cầu, rồi tự spawn coding agent phù hợp.
Chỉ định trực tiếp: “Mở Claude Code trong thread mới”, “Dùng Codex one-shot để fix test fail”.
Claude Code quản lý OpenClaw: dùng coding agent để chỉnh openclaw.json, skills, cron và workspace files.
Multi-agent production: chạy nhiều coding session song song cho CI fail, refactor và review.

Chi phí và tối ưu

Mỗi ACP session có context riêng, nên token cost cộng dồn với agent chính. Muốn tiết kiệm:

Dùng oneshot cho task đơn giản.
Giảm TTL nếu bạn hay quên đóng session.
Không spawn coding agent cho việc mà agent chính tự làm được.
Dùng model tốt cho task code khó, model rẻ cho sub-agent research.

Bảo mật: ACP chạy ngoài sandbox

Đây là điểm rất quan trọng: ACP session chạy trên host runtime, không phải sandbox của OpenClaw. Nghĩa là coding agent có thể truy cập file hệ thống thật theo quyền của user đang chạy OpenClaw.

Giới hạn allowedAgents.
Kiểm soát quyền write/shell của ACP plugin.
Không cho coding agent đụng production nếu chưa có review gate.
Nếu cần độ bền cao, chạy trong tmux hoặc workflow phục hồi được.

Lỗi thường gặp

Sandboxed sessions cannot spawn ACP sessions → session hiện tại đang sandboxed.
ACP không hoạt động trên Discord → thread binding chưa bật.
Coding agent chạy nhưng không trả kết quả → delivery/stream config sai.
Session mất sau Gateway restart → cần resume session hoặc workflow bền hơn.
acpx không tìm thấy → plugin chưa cài hoặc version mismatch.

Tóm tắt: Chọn đúng “người” cho đúng việc

Agent chính: email, lịch, chat, automation, shell đơn giản.
Codex: quick fix, test fail, one-shot coding task.
Claude Code: refactor lớn, feature dài hơi, architecture.
Pi/OpenCode: task code nhẹ hoặc dùng model local.
Sub-agent: nghiên cứu song song, không cần coding harness.

Câu hỏi thường gặp

Bài viết cũng trả lời các câu hỏi như: agent chính có tự biết khi nào cần gọi coding agent không, có cần cài thêm gì để dùng ACP, coding agent có truy cập workspace không, và ACP thường tốn token hơn sub-agent ở mức nào.

Xem thêm

Nguồn tham khảo: OpenClaw Docs, GitHub openclaw/openclaw, GitHub openclaw/acpx và kinh nghiệm triển khai thực tế.