Hướng dẫn Cài đặt và Khởi tạo OpenFang: Từ con số không đến Agent đầu tiên

Slug: openfang-install-setup-guide Danh mục: usage-guides (Hướng dẫn sử dụng) Từ khóa mục tiêu: Cài đặt OpenFang, Hướng dẫn cấu hình OpenFang, Hướng dẫn nhập môn OpenFang Mục đích tìm kiếm: Thông tin (Người dùng muốn triển khai OpenFang) Số từ mục tiêu: ~1800 từ Ngôn ngữ: vi

OpenFang là gì?

OpenFang là hệ điều hành Agent cấp sản xuất được xây dựng trên Rust. Khác với các khung làm việc (framework) AI chat truyền thống, OpenFang cung cấp môi trường chạy Agent hoàn chỉnh—khởi động nguội 180ms, chiếm dụng bộ nhớ 40MB, 16 lớp bảo mật và 40 bộ điều hợp kênh. Dù bạn muốn chạy một tác vụ tự động hóa đơn giản tại máy cục bộ hay xây dựng cụm Agent tự chủ 7×24 giờ đa nền tảng, OpenFang đều có thể đáp ứng.

Bài viết này sẽ đưa bạn đi từ con số không để hoàn tất việc cài đặt, khởi tạo và vận hành Agent đầu tiên của OpenFang.

Yêu cầu hệ thống

Trước khi bắt đầu cài đặt, vui lòng đảm bảo hệ thống của bạn đáp ứng các yêu cầu tối thiểu sau:

Triết lý thiết kế của OpenFang là "ưu tiên sự gọn nhẹ"—ngay cả trên Raspberry Pi 4 (phiên bản 4GB) cũng có thể vận hành mượt mà.

Bước 1: Cài đặt chuỗi công cụ Rust

OpenFang được viết bằng Rust, trước tiên bạn cần cài đặt chuỗi công cụ Rust:

# Cài đặt Rustup (Trình quản lý chuỗi công cụ Rust)curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# Tải lại biến môi trườngsource "$HOME/.cargo/env"# Xác minh cài đặtrustc --versioncargo --version

Nếu bạn đã cài đặt Rust, chúng tôi khuyên bạn nên cập nhật lên phiên bản ổn định mới nhất:

rustup update stable

Bước 2: Cài đặt OpenFang

OpenFang cung cấp nhiều phương thức cài đặt, khuyến khích sử dụng Cargo để cài đặt trực tiếp:

# Cài đặt phiên bản mới nhất từ crates.iocargo install openfang# Xác minh cài đặtopenfang --version

Nếu bạn thích xây dựng từ mã nguồn (phù hợp cho người dùng nâng cao cần cấu hình tùy chỉnh):

git clone https://github.com/openfang/openfang.gitcd openfangcargo build --release./target/release/openfang --version

Người dùng Docker cũng có thể sử dụng image chính thức:

docker pull openfang/openfang:latestdocker run -d --name openfang -v ./config:/app/config openfang/openfang

Bước 3: Khởi tạo cấu hình

Sau khi cài đặt xong, hãy chạy lệnh khởi tạo để tạo tệp cấu hình:

# Tạo thư mục cấu hình mặc địnhopenfang init# Vị trí tệp cấu hình# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

Sau khi khởi tạo, một tệp config.toml sẽ được tạo ra, các mục cấu hình cốt lõi như sau:

[core]name = "my-first-agent"          # Tên Agentworkspace = "./workspace"         # Thư mục làm việclog_level = "info"                # Cấp độ nhật ký: trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # Đọc từ biến môi trườngmodel = "claude-sonnet-5"         # Mô hình mặc địnhmax_tokens = 4096[security]sandbox_mode = "strict"           # Chế độ sandbox: off, basic, strictnetwork_policy = "allowlist"      # Chính sách mạngallowed_domains = ["api.anthropic.com"][channels]# Cấu hình ít nhất một bộ điều hợp kênh

Giải thích các cấu hình quan trọng:

• api_key: Hỗ trợ tham chiếu biến môi trường (định dạng ${VAR_NAME}), không nên ghi trực tiếp API key vào tệp cấu hình.
• sandbox_mode: Môi trường sản xuất khuyến nghị sử dụng chế độ strict.
• network_policy: Chế độ allowlist chỉ cho phép truy cập các tên miền trong danh sách trắng, chế độ blocklist chặn các tên miền trong danh sách đen.
• channels: Cần ít nhất một bộ điều hợp kênh, nếu không Agent sẽ không thể tương tác với thế giới bên ngoài.

Bước 4: Cấu hình Anthropic API Key

OpenFang phụ thuộc vào Claude API (thông qua Anthropic), cần phải cấu hình API key:

# Thiết lập biến môi trườngexport ANTHROPIC_API_KEY="sk-ant-..."# Khuyến nghị ghi vào tệp cấu hình shellecho 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

Bạn có thể lấy API key từ Anthropic Console.

Bước 5: Chọn và cấu hình bộ điều hợp kênh

OpenFang hỗ trợ hơn 40 loại bộ điều hợp kênh, cho phép Agent tương tác với người dùng qua các nền tảng khác nhau. Dưới đây là một số loại phổ biến:

Ví dụ cấu hình kênh Telegram:

[channels.telegram]enabled = truebot_token = "${TELEGRAM_BOT_TOKEN}"allowed_users = ["@your_username"]

Bước 6: Khởi chạy Agent đầu tiên của bạn

Sau khi cấu hình xong, hãy khởi chạy Agent:

# Khởi chạy cơ bảnopenfang start# Chỉ định tệp cấu hìnhopenfang start --config ./my-config.toml# Chạy ngầm (daemon)openfang start --daemon# Xem nhật ký vận hànhopenfang logs --follow

Sau khi khởi chạy thành công, hệ thống sẽ hiển thị:

⚡ OpenFang v1.0.0├─ Agent: my-first-agent├─ Model: claude-sonnet-5├─ Sandbox: strict├─ Channels: cli└─ Ready. Type /help for commands.

Trong kênh CLI, bạn có thể trò chuyện trực tiếp với Agent:

> /help> Giúp tôi kiểm tra thời tiết hôm nay> Phân tích cấu trúc mã nguồn của kho lưu trữ GitHub này

Bước 7: Xác minh cài đặt

Chạy lệnh chẩn đoán tích hợp để xác nhận mọi thứ đều bình thường:

# Kiểm tra sức khỏe hệ thốngopenfang doctor# Kết quả sẽ hiển thị tương tự như:# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

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

Bước tiếp theo

Chúc mừng bạn đã hoàn tất việc cài đặt và khởi tạo OpenFang! Tiếp theo, chúng tôi khuyên bạn nên đọc:

• Hướng dẫn cấu hình OpenFang Hands: Tìm hiểu cách cấu hình các mô-đun năng lực Agent cho các mục đích khác nhau.
• Cấu hình bộ điều hợp đa kênh OpenFang: Cấu hình đồng thời nhiều kênh để Agent của bạn có mặt ở khắp mọi nơi.
• Thực tiễn tốt nhất về bảo mật OpenFang: Bảo vệ Agent của bạn khỏi các cuộc tấn công.