Cài Codex làm agent provider (NanoClaw)
Skill cài đặt giúp thêm OpenAI Codex (app-server) làm backend agent đầy đủ cho NanoClaw và chuyển đổi theo từng group.
Làm được gì
Tự động hoá toàn bộ quy trình đưa Codex của OpenAI vào NanoClaw như một agent provider song song hoặc thay thế Claude.
- Copy payload từ nhánh
providersvào 3 cây mã nguồn (host, container, setup) - Thêm
import './codex.js';vào 5 file barrel (idempotent, chạy lại vô hại) - Thêm
@openai/codex(bản ghim) vàocontainer/cli-tools.jsonrồi rebuild image - Kiểm chứng bằng
provider-contract-verifier - Hướng dẫn xác thực: đăng nhập ChatGPT hoặc nhập OpenAI API key, lưu vào vault
Thông tin đăng nhập không nằm trong .env; container chỉ thấy auth.json giả, token thật được gateway thay trên đường truyền.
Dành cho ai
- Người đang vận hành NanoClaw và muốn mỗi group dùng một backend model khác nhau
- Người muốn tận dụng lịch sử hội thoại phía server và MCP tools của Codex
- Người thích cách cài đặt "tài liệu chính là script" qua các directive
nc:
※ Không dùng được ngoài repo NanoClaw.
Ví dụ sử dụng
- Cài một lệnh:
pnpm exec tsx setup/index.ts --step provider-auth codexlàm tất cả từ copy file tới xác thực. - Đổi provider cho một group:
ncl groups config update --id <group-id> --provider codexrồincl groups restart --id <group-id>. - Khắc phục lỗi: gặp
Error: spawn codex ENOENTnghĩa là image cũ chưa có entry manifest — chạy lại./container/build.sh.
· · · 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/nanocoai/nanoclaw/HEAD/.claude/skills/add-codex/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 .claude/skills/add-codex từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-codex/ 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/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.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 và vào thư mục làm việc của bạn.
- Clone repo:
git clone https://github.com/nanocoai/nanoclaw.git - Nếu muốn dùng riêng skill:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-codex ~/.claude/skills/ - Vào repo:
cd nanoclawvà kiểm tra filesrc/project-doc-compose.tscó tồn tại không. Nếu thiếu, chạy/update-nanoclawtrước. - Mở Claude Code và yêu cầu "dùng skill add-codex để cài provider Codex", hoặc chạy thẳng
pnpm exec tsx setup/index.ts --step provider-auth codex. - Làm theo hướng dẫn để đăng nhập ChatGPT hoặc dán OpenAI API key; khoá sẽ được lưu trong vault.
- Bật cho group cần dùng:
ncl groups config update --id <group-id> --provider codexvàncl groups restart --id <group-id>.