AI & AUTOMATION SELF HOSTING

Hướng dẫn self-hosting Spacebot: AI Agent cho đội nhóm và cộng đồng

02/03/20262 views0

Bạn đang tìm kiếm một công cụ AI có thể hỗ trợ toàn bộ đội ngũ, cộng đồng hoặc môi trường đa người dùng? Hãy tưởng tượng một “người trợ lý ảo” không chỉ trả lời câu hỏi mà còn tự động hóa nhiệm vụ, quản lý bộ nhớ chung, và tích hợp mượt mà với các nền tảng chat như Discord hay Slack. Đó chính là Spacebot – một AI agent mã nguồn mở được thiết kế dành riêng cho các đội nhóm và cộng đồng.

Spacebot hoạt động như một hệ điều hành AI, cho phép nhiều agent AI làm việc đồng thời mà không bị chặn hoặc mất bộ nhớ. Nó hỗ trợ các nền tảng như Discord, Slack, Telegram, Twitch, và thậm chí Webchat, giúp tự động hóa tương tác thông minh, xử lý nhiệm vụ, và quản lý người dùng đa kênh. Lợi ích chính bao gồm:

Hỗ trợ đội nhóm: Phân công nhiệm vụ, lập lịch cron job với ngôn ngữ tự nhiên, và tổng hợp kiến thức qua Cortex (hệ thống trung tâm).
Cộng đồng đa người dùng: Xử lý tin nhắn, phản hồi thời gian thực, và bộ nhớ đồ thị (graph-connected) để lưu trữ sự kiện, mục tiêu, quan sát.
Tích hợp dễ dàng: Hỗ trợ nhiều mô hình LLM như Anthropic, OpenAI, Ollama, với định tuyến thông minh để tối ưu chi phí và hiệu suất.

Dự án được phát triển bởi Spacedriveapp, với mã nguồn mở tại GitHub và trang chính thức spacebot.sh. Với kiến trúc gồm Channels (kênh giao tiếp), Branches (nghĩ sâu), Workers (thực thi nhiệm vụ), và Cortex (tổng hợp kiến thức), Spacebot đang trở thành lựa chọn hàng đầu cho lập trình viên, quản trị viên cộng đồng, và doanh nghiệp muốn tự động hóa quy trình làm việc nhóm.

Hướng dẫn self-host

Spacebot dễ dàng self-host nhờ kiến trúc đơn giản, chỉ cần một binary Rust mà không phụ thuộc vào microservices phức tạp. Dưới đây là hướng dẫn chi tiết để bạn triển khai trên máy chủ cá nhân hoặc VPS.

Yêu cầu hệ thống

Ngôn ngữ: Rust 1.85+ (cài qua rustup).
API keys: Cần khóa từ LLM như Anthropic (hỗ trợ OAuth) hoặc OpenAI. Không cần internet ngoài API calls.
Tùy chọn: Docker cho deployment nhanh. Máy chủ nên có ít nhất 4GB RAM cho multi-agent, và lưu trữ cho cơ sở dữ liệu (SQLite, LanceDB, redb).
Hệ điều hành: Linux, macOS, Windows (Rust hỗ trợ cross-platform).

Các bước cài đặt

1. Clone repository: Mở terminal và chạy lệnh:

git clone https://github.com/spacedriveapp/spacebot
cd spacebot

2. Build binary: Sử dụng Cargo để build:

cargo build --release

Binary sẽ nằm tại target/release/spacebot.

3. Cấu hình config.toml: Tạo file config.toml trong thư mục hiện tại. Ví dụ cấu hình tối thiểu:

[llm.routing]
default = "anthropic"

[[llm.providers]]
name = "anthropic"
type = "anthropic"
api_key = "your_anthropic_api_key"

[[agents]]
id = "team-assistant"
name = "Team Bot"
personality = "Helpful and efficient for team tasks"

[[messaging.bindings]]
type = "discord"
token = "your_discord_bot_token"

Thêm routing cho các mô hình khác nếu cần, và cấu hình messaging cho Discord/Slack.

4. Chạy server:

Chạy foreground: spacebot start --foreground.
Chạy daemon: ./target/release/spacebot.
Quản lý: spacebot stop, spacebot restart, spacebot status.

5. Sử dụng Docker (tùy chọn): Để dễ deploy hơn:

docker run -d --name spacebot -v ./data:/data -p 19898:19898 ghcr.io/spacedriveapp/spacebot:latest

Truy cập web UI tại localhost:19898 để thiết lập API keys và agent.

Lưu ý troubleshooting

Lỗi OAuth: Chạy spacebot auth login để authenticate Anthropic, và spacebot auth refresh nếu token hết hạn.
Bộ nhớ đầy: Compactor tự động xử lý context overflow bằng cách tóm tắt; kiểm tra logs nếu vấn đề kéo dài.
Worker thất bại: Đảm bảo MCP servers (như filesystem) được cấu hình đúng trong config.toml. Retry tự động với backoff 5s-60s.
Hiệu suất: Với multi-agent, theo dõi metrics qua /metrics endpoint và tích hợp Prometheus/Grafana.

Sau khi host, bạn có thể truy cập web UI để quản lý channels và memories.

Hướng dẫn sử dụng

Sau khi self-host thành công, Spacebot sẵn sàng phục vụ đội nhóm của bạn. Dưới đây là các tính năng cốt lõi và cách sử dụng thực tế.

Tính năng cốt lõi

Tương tác AI: Channels xử lý tin nhắn thời gian thực, hỗ trợ threading, reactions, và file attachments. Ví dụ, trong Discord, bot trả lời lệnh như “@spacebot research Stripe API changes”.
Tích hợp API: Kết nối với 10+ LLM providers (Anthropic, OpenAI, Groq,…). Model routing tự động chọn mô hình phù hợp dựa trên độ phức tạp prompt.
Quản lý người dùng: Multi-user với permissions per-channel, multi-agent (mỗi agent có workspace riêng). Bộ nhớ graph lưu 8 loại (Fact, Goal, Todo,…), tìm kiếm hybrid vector + full-text.

Ví dụ sử dụng thực tế cho đội nhóm

Tự động hóa chat: Trong kênh #support, bot xử lý ticket bằng cách recall memories cũ và delegate tasks cho workers (ví dụ: scrape web với browser tool).
Xử lý nhiệm vụ: Lập lịch cron job: “@spacebot schedule check inbox every 30 minutes”. Workers thực thi shell commands, file ops, hoặc coding với OpenCode (hỗ trợ LSP).
Tùy chỉnh: Thêm skills từ registry skills.sh: spacebot skill add vercel-labs/agent-skills. Tùy chỉnh personality agent trong config.toml để phù hợp cộng đồng (ví dụ: friendly cho community bot).

Để tùy chỉnh nâng cao, drop files vào thư mục ingest/ để tự động import memories. Sử dụng CLI như spacebot memory reset --agent <id> để quản lý.

Ứng dụng cho OpenClaw và setup

OpenClaw là một dự án AI mã nguồn mở nổi tiếng, hoạt động như một agent cá nhân tự trị chạy local, tích hợp với chat apps như WhatsApp, Discord để tự động hóa nhiệm vụ (gửi email, quản lý calendar, shell commands). Tuy nhiên, OpenClaw chủ yếu dành cho cá nhân, trong khi Spacebot mở rộng cho teams và communities – được mô tả như “OpenClaw, but for communities”. Tích hợp Spacebot vào OpenClaw giúp nâng cao hiệu quả: tự động hóa quy trình nhóm, chia sẻ bộ nhớ chung, và hỗ trợ multi-user mà không mất tính cá nhân.

Lợi ích tích hợp

Tự động hóa quy trình: Spacebot có thể migrate memories từ OpenClaw (MEMORY.md) để tổng hợp kiến thức đội nhóm.
Hỗ trợ đa người dùng: Kết nối OpenClaw’s skills với Spacebot’s workers, cho phép agent cá nhân tham gia vào channels nhóm.
Nâng cao hiệu quả: Sử dụng Cortex để tổng hợp bulletins hàng giờ từ dữ liệu OpenClaw, giúp đội ngũ theo dõi tiến độ.

Hướng dẫn setup cụ thể

Chuẩn bị: Đảm bảo OpenClaw đang chạy local (từ GitHub OpenClaw). Export memories thành MEMORY.md.
Migrate memories: Drop MEMORY.md vào thư mục ingest/ của Spacebot. Spacebot tự động classify và tạo graph-connected memories.
Kết nối API: Trong config.toml của Spacebot, thêm MCP server cho OpenClaw:

[[mcp_servers]]
name = "openclaw"
transport = "http"
url = "http://localhost:openclaw_port"  # Thay bằng port OpenClaw

Điều này cho phép Spacebot gọi skills từ OpenClaw qua HTTP.

Cấu hình agent: Thêm agent mới trong config.toml:

[[agents]]
id = "openclaw-integration"
name = "OpenClaw Bot"
skills = ["openclaw-compat"]  # Sử dụng skills OpenClaw compatibility

Ví dụ code tích hợp: Trong channel Discord, dùng lệnh: “@spacebot use openclaw to manage calendar”. Spacebot sẽ delegate đến OpenClaw qua MCP.
Test và troubleshoot: Chạy spacebot status để kiểm tra kết nối. Nếu lỗi, kiểm tra port và retry config.

Với setup này, OpenClaw trở thành “cánh tay” cho Spacebot trong môi trường nhóm, giúp dự án của bạn hiệu quả hơn.

Spacebot là giải pháp AI mã nguồn mở lý tưởng cho đội nhóm và cộng đồng, với khả năng self-host dễ dàng và tích hợp mạnh mẽ. Từ giới thiệu đến ứng dụng thực tế với OpenClaw, bài viết hy vọng giúp bạn áp dụng ngay. Hãy thử self-host Spacebot hôm nay và chia sẻ kinh nghiệm trong phần bình luận!