🚀 Open-Claw-Team-Superpowers
Open-Claw-Team-Superpowers là sự kết hợp sức mạnh điều phối của OpenClaw, khả năng làm việc bầy đàn (Swarm) của ClawTeam, và bộ skills, tri thức lập trình chuyên sâu từ Superpowers.
Đã được tinh chỉnh để ngăn chặn deadlock và sẵn sàng cho các task lập trình phức tạp.
🏗️ Kiến trúc Hệ thống (Architecture)
Hệ thống chạy trên Docker với 2 dịch vụ cốt lõi:
- Gateway (
openclaw-gateway): Trái tim xử lý API, Web UI và quản lý các luồng kết nối LLM (Claude, GPT, Gemini). - CLI/Bastion (
openclaw-cli): Trạm điều khiển cho phép kỹ sư truy cập trực tiếp (interactive shell) để điều phối ClawTeam và Superpowers thủ công.
Cả hai container dùng chung một image openclaw-clawteam:latest được build từ Dockerfile của dự án.
🛠️ Hướng dẫn Cài đặt (Installation)
1. Yêu cầu hệ thống
- Docker Engine >= 24.x
- Docker Compose >= v2.x (
docker compose— không phảidocker-compose) - Quyền truy cập vào Git repository nội bộ
2. Clone dự án
git clone https://git.smartgift.io.vn/smartgift/open-claw-team.git open-claw-team
cd open-claw-team
3. Cấu hình biến môi trường
Mở và chỉnh sửa file .env:
cp .env.example .env
vi .env
Các biến quan trọng cần chú ý:
| Biến | Mặc định | Mô tả |
|---|---|---|
OPENCLAW_GATEWAY_TOKEN |
team-token |
⚠️ Token xác thực WebSocket & Web UI — bắt buộc đổi trên production |
OPENCLAW_GATEWAY_BIND |
lan |
Bind mode: loopback | lan | tailnet. Dùng lan khi chạy Docker |
OPENCLAW_GATEWAY_PORT |
18789 |
Port WebSocket Gateway |
OPENCLAW_BRIDGE_PORT |
18889 |
Port Bridge / Node-to-node |
CLAUDE_AI_SESSION_KEY |
(trống) | Session key từ claude.ai (cần ít nhất 1 key) |
CLAUDE_WEB_SESSION_KEY |
(trống) | Session key thay thế |
CLAUDE_WEB_COOKIE |
(trống) | Cookie raw nếu dùng Web API |
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS |
(trống) | Đặt 1 để cho phép WS không mã hoá trên mạng nội bộ |
OPENCLAW_TZ |
Asia/Ho_Chi_Minh |
Timezone container |
Lấy Claude session keys: Mở https://claude.ai trên trình duyệt → F12 → tab Application → Cookies hoặc Session Storage.
🐳 Hướng dẫn Sử dụng Docker
Build & Khởi động
# Lần đầu: build image và start toàn bộ stack
docker compose up -d --build
# Các lần sau (đã có image): start nhanh
docker compose up -d
Xem logs
# Log riêng Gateway
docker compose logs -f openclaw-gateway
# Log riêng CLI (thường ít output)
docker compose logs -f openclaw-cli
Truy cập CLI (Bastion Shell)
Container openclaw-cli là môi trường interactive để thao tác trực tiếp với OpenClaw:
# Mở bash shell vào CLI container
docker compose exec openclaw-cli bash
# Chạy lệnh openclaw trực tiếp từ host
docker compose exec openclaw-cli openclaw --help
docker compose exec openclaw-cli openclaw status
# Kiểm tra version OpenClaw đang dùng
docker compose exec openclaw-cli openclaw --version
⚙️ Cấu trúc Volumes & Dữ liệu
| Host Path (mặc định) | Mount trong container | Mục đích |
|---|---|---|
./.openclaw |
/home/node/.openclaw |
Config, credentials OpenClaw |
./.openclaw/workspace |
/home/node/.openclaw/workspace |
Workspace làm việc của agents |
Thư mục
.openclaw/được tạo tự động khi gateway khởi động lần đầu. Tất cả cấu hình (token, origins, …) lưu tại đây và persist qua các lần restart.
🌐 Cổng kết nối (Ports)
| Port | Biến | Mô tả |
|---|---|---|
18789 |
OPENCLAW_GATEWAY_PORT |
WebSocket Gateway + Web Control UI |
18889 |
OPENCLAW_BRIDGE_PORT |
Bridge / Node-to-node communication |
Sau khi khởi động, mở trình duyệt:
http://localhost:18789
Đăng nhập bằng giá trị OPENCLAW_GATEWAY_TOKEN trong .env.
🔧 Troubleshooting
Gateway không start — lỗi "non-loopback Control UI"
Nguyên nhân: OPENCLAW_GATEWAY_BIND đang là loopback, không tương thích với Docker port mapping.
Sửa:
# .env
OPENCLAW_GATEWAY_BIND=lan
Lỗi WebSocket kết nối qua mạng nội bộ
# .env
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1
📁 Cấu trúc Dự án
open-claw-team/
├── Dockerfile # Image: Node 24 + OpenClaw + ClawTeam + Superpowers
├── docker-compose.yml # 2 services: openclaw-gateway + openclaw-cli
├── .env # Biến môi trường (⚠️ KHÔNG commit lên Git)
├── .gitignore
└── .openclaw/ # Auto-generated — gitignored
├── openclaw.json # Config gateway (sau lần setup đầu)
└── workspace/ # Workspace của agents