GoClaw: Multi-Agent AI Gateway — Hướng Dẫn Cài Đặt & Ứng Dụng Cho Doanh Nghiệp

Bạn cần một AI agent xử lý Telegram, tìm kiếm web, chạy shell, nhớ lịch sử — nhưng mỗi thứ lại là một công cụ riêng, cần vài ngày cấu hình, và vẫn không nói chuyện được với nhau.

GoClaw giải quyết tất cả trong một binary 25 MB — không cần runtime, không cần cấu hình phức tạp, production-ready ngay từ ngày đầu.

# Clone nhánh stable
git clone -b main https://github.com/nextlevelbuilder/goclaw.git && cd goclaw

# Build binary
make build

# Wizard setup tương tác (tạo .env.local + schema DB)
./goclaw onboard

# Chạy
source .env.local && ./goclaw

# Dashboard: http://localhost:18790

# Tạo file .env với secrets tự động
chmod +x prepare-env.sh && ./prepare-env.sh

# Thêm API key vào .env (ít nhất 1 provider)
echo "GOCLAW_ANTHROPIC_API_KEY=sk-ant-..." >> .env

# Khởi động (auto build, migrate, seed)
make up

# Tùy chọn: thêm browser automation, OTEL tracing, Redis
make up WITH_BROWSER=1 WITH_OTEL=1 WITH_REDIS=1

⚠️ Yêu cầu: Go 1.26+ (build từ source) hoặc Docker (compose). PostgreSQL 18 + pgvector. Tối thiểu 2GB RAM cho Docker Compose.

# macOS
curl -fsSL https://raw.githubusercontent.com/nextlevelbuilder/goclaw/main/scripts/install-lite.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/nextlevelbuilder/goclaw/main/scripts/install-lite.ps1 | iex

Agent Loop Pipeline

🎧 1. Tự Động Hóa Customer Support

Kết nối bot Telegram/Slack/Zalo với Knowledge Vault chứa FAQ, tài liệu sản phẩm. Agent nhớ lịch sử từng khách hàng qua 3-tier memory. Trường hợp phức tạp → tự động chuyển cho agent chuyên gia qua team orchestration.

🔧 2. Internal Tools & DevOps Automation

Agent thực thi shell commands, quản lý infrastructure, chạy CI/CD pipelines. Custom tools API cho phép tạo tool mới từ shell script ngay trong runtime — không cần deploy lại. Cron scheduling cho maintenance jobs định kỳ.

👥 3. Multi-Department Coordination

Agent Teams cho phép nhiều AI agent làm việc song song: Sales agent nghiên cứu → Proposal agent soạn báo giá → Review agent kiểm tra. Shared task board + mailbox hệ thống giữa các agent.

📚 4. Knowledge Management

Knowledge Vault với hybrid search (full-text + pgvector semantic). LLM tự động trích xuất entities, tạo knowledge graph có thể traverse. Wikilinks [[bidirectional]] giữa các tài liệu. Phù hợp để xây internal wiki có thể chat.

☁️ 5. SaaS Backend / Multi-Tenant AI

Multi-tenant PostgreSQL cô lập hoàn toàn theo tenant. Mỗi khách hàng có workspace riêng, API key riêng với RBAC scopes. Secrets mã hóa AES-256-GCM. Phù hợp xây AI SaaS hoặc triển khai cho nhiều phòng ban.

POST /v1/tools/custom
{
  "name": "dns_lookup",
  "description": "Tra cứu DNS records",
  "parameters": {
    "properties": {
      "domain": { "type": "string" },
      "record_type": { "enum": ["A", "MX", "CNAME", "TXT"] }
    }
  },
  "command": "dig +short {{.record_type}} {{.domain}}",
  "timeout_seconds": 10
}

Tính năng	Desktop Lite	Standard (Server) ✨
Số lượng agents	Tối đa 5	✅ Không giới hạn
Database	SQLite (local)	✅ PostgreSQL
Memory Search	FTS5 text only	✅ pgvector semantic
Kênh nhắn tin	❌	✅ 7 kênh
Knowledge Graph	❌	✅ Full + visualization
Multi-tenancy	❌	✅ RBAC + isolated

🔐 Bảo Mật 5 Lớp

GoClaw áp dụng bảo mật theo chiều sâu — không phải chỉ một điểm kiểm soát:

Kèm theo: AES-256-GCM encryption, credential scrubbing tự động, SSRF protection, rate limiting, prompt injection detection.

💡 Lưu ý License: GoClaw dùng CC BY-NC 4.0 — có thể sử dụng, chỉnh sửa, phân phối tự do; nhưng cần xin phép bằng văn bản cho mục đích thương mại. Liên hệ tác giả trước khi triển khai trong sản phẩm thương mại.

🔗 Tài Nguyên

• GitHub Repository — nextlevelbuilder/goclaw
• Official Documentation — docs.goclaw.sh
• Getting Started Guide
• Docker Compose Deployment Guide