Hướng dẫn Cài đặt và Vận hành AI Agent OpenManus trên Linux

Bài viết này sẽ hướng dẫn bạn cách triển khai cục bộ (local deployment) AI Agent OpenManus trên hệ điều hành Linux. Đây là một quy trình tương đối đơn giản và không yêu cầu nhiều tài nguyên, tổng dung lượng ổ đĩa cần thiết thường không quá 10GB, nên bạn hoàn toàn có thể yên tâm thử nghiệm.

Khắc phục Sự cố Khởi động Hệ thống do Lỗi Cấu hình

Một trong những vấn đề thường gặp khi chỉnh sửa các tập tin cấu hình shell như .bashrc hoặc .profile là có thể dẫn đến việc giao diện người dùng đồ họa (GUI) không thể khởi động được, khiến màn hình bị trống hoặc hiển thị lỗi. Dưới đây là cách khắc phục:

Phương pháp 1: Sử dụng Bảng điều khiển Văn bản (TTY)

  1. Khi gặp màn hình lỗi hoặc không vào được GUI, hãy nhấn tổ hợp phím Ctrl + Alt + F1 đến F6 (tùy thuộc vào cấu hình hệ thống, thường là F1, F2 hoặc F4) để truy cập vào một bảng điều khiển văn bản (TTY).
  2. Tại màn hình đăng nhập TTY, bạn sẽ thấy: 
    login: (tên người dùng)
password: (mật khẩu)
    Nhập tên người dùng và mật khẩu của một tài khoản đang hoạt động bình thường (hoặc tài khoản gặp vấn đề nếu bạn biết chắc chắn có thể đăng nhập ở TTY).
  3. Sau khi đăng nhập, điều hướng đến thư mục gốc của người dùng gặp vấn đề (nếu bạn đang đăng nhập bằng một tài khoản khác): 
    cd /home/tên_người_dùng_lỗi/
    Nếu bạn đã đăng nhập bằng tài khoản đang lỗi, chỉ cần gõ cd ~ hoặc cd $HOME.
  4. Sử dụng trình soạn thảo văn bản nano (được khuyến nghị vì dễ sử dụng hơn vim cho người mới) để chỉnh sửa tập tin cấu hình bị lỗi (thường là .profile hoặc .bashrc, tùy thuộc vào tập tin bạn đã chỉnh sửa gây ra lỗi). Ví dụ: 
    nano .profile
  5. Tìm đến các dòng cấu hình bạn đã thêm hoặc sửa đổi gần đây (ví dụ, các dòng liên quan đến PYENV_ROOT, eval "$(pyenv init - bash)"). Thêm ký tự # vào đầu mỗi dòng đó để biến chúng thành chú thích. 
    # export PYENV_ROOT="$HOME/.pyenv"
# [[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
# eval "$(pyenv init - bash)"
  6. Lưu tập tin bằng cách nhấn Ctrl + O, sau đó Enter để xác nhận. Thoát trình soạn thảo bằng Ctrl + X.
  7. Thử đăng nhập lại vào tài khoản gặp lỗi từ TTY bằng cách nhấn Ctrl + Alt + F1 (hoặc TTY nào đó đang dùng cho GUI) hoặc khởi động lại máy tính bằng lệnh sudo reboot. Lỗi sẽ được khắc phục.

Phương pháp 2: Sử dụng USB Khởi động (Live USB)

Nếu phương pháp trên không hiệu quả hoặc bạn không thể truy cập TTY, bạn có thể sử dụng một USB khởi động chứa hệ điều hành như Ubuntu. Khởi động máy tính từ USB này, sau đó truy cập vào phân vùng hệ điều hành chính của bạn, tìm đến thư mục /home/tên_người_dùng_lỗi/ và chỉnh sửa tập tin cấu hình theo các bước tương tự như trên.

Các Bước Cài đặt OpenManus trên Linux

Để đảm bảo quá trình cài đặt diễn ra suôn sẻ và tránh các lỗi không đáng có, hãy thực hiện từng bước một cách cẩn thận.

1. Cài đặt `uv` (Công cụ quản lý gói Python tốc độ cao)

uv là một công cụ cài đặt và phân giải gói Python rất nhanh. Mở terminal và chạy lệnh sau:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Sao chép Mã nguồn OpenManus

Sử dụng Git để sao chép kho lưu trữ OpenManus từ GitHub:

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

3. Tạo và Kích hoạt Môi trường Ảo

Việc sử dụng môi trường ảo giúp cô lập các gói phụ thuộc của dự án, tránh xung đột với các dự án Python khác trên hệ thống của bạn:

uv venv
source .venv/bin/activate  # Trên hệ thống Unix/macOS

4. Cài đặt Các Gói Phụ thuộc

Sau khi kích hoạt môi trường ảo, cài đặt tất cả các gói cần thiết được liệt kê trong requirements.txt:

uv pip install -r requirements.txt

Xử lý Lỗi Phiên bản Python hoặc Đường dẫn

Nếu bạn gặp sự cố khi phiên bản Python của bạn không được nhận dạng chính xác, đặc biệt khi sử dụng các công cụ quản lý phiên bản Python như pyenv, hãy kiểm tra và cấu hình lại đường dẫn môi trường (PATH).

Giải pháp: Đảm bảo `pyenv` được khởi tạo đúng cách

Kiểm tra tập tin cấu hình shell của bạn (~/.bashrc cho Bash hoặc ~/.zshrc cho Zsh) để đảm bảo rằng pyenv được khởi tạo đúng cách. Các dòng sau đây là cần thiết:

export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

Sau khi thêm hoặc xác minh các dòng trên, nạp lại cấu hình shell để áp dụng thay đổi:

source ~/.bashrc  # Hoặc source ~/.zshrc

Kiểm tra lại phiên bản Python đang được sử dụng:

python --version
which python

Nếu vẫn gặp vấn đề, bạn có thể tạm thời thiết lập đường dẫn cho phiên bản Python cụ thể (ví dụ, Python 3.11.9) trong phiên làm việc hiện tại:

export PATH="$HOME/.pyenv/versions/3.11.9/bin:$PATH"

Lệnh này chỉ có hiệu lực cho phiên terminal hiện tại. Thay đổi 3.11.9 thành phiên bản Python bạn muốn sử dụng.

Cấu hình API Key và Mô hình Ngôn ngữ Lớn (LLM)

OpenManus yêu cầu cấu hình các khóa API để tương tác với các mô hình ngôn ngữ lớn (LLM). Thực hiện các bước sau:

1. Sao chép Tệp Cấu hình Mẫu

Tạo một bản sao của tệp cấu hình mẫu: 

cp config/config.example.toml config/config.toml

2. Chỉnh sửa `config/config.toml`

Mở tệp config/config.toml vừa tạo và thay thế các khóa API giả mạo bằng khóa API thực của bạn từ nhà cung cấp dịch vụ LLM (ví dụ: OpenAI, Google Gemini, Anthropic Claude, hoặc các mô hình mã nguồn mở chạy cục bộ). Bạn cũng có thể tùy chỉnh các cài đặt khác như mô hình sử dụng, URL API, giới hạn token, và nhiệt độ (temperature).

# Cấu hình chung cho các mô hình ngôn ngữ lớn (LLM)
[llm_service]
model_name = "gpt-4o"                  # Ví dụ: "gpt-4o", "claude-3-opus", "gemini-pro"
api_base_url = "https://api.openai.com/v1"  # Thay đổi nếu sử dụng nhà cung cấp khác
api_key_env = "OPENAI_API_KEY"         # Hoặc "ANTHROPIC_API_KEY", "GOOGLE_API_KEY"
max_output_tokens = 4096
creativity_level = 0.0                 # Giá trị từ 0.0 (ít sáng tạo) đến 1.0 (sáng tạo cao)

# Cấu hình tùy chọn cho các mô hình thị giác (Vision LLMs)
[vision_capabilities]
vision_model = "gpt-4o-vision"         # Mô hình hỗ trợ đa phương thức
api_base_url = "https://api.openai.com/v1"
api_key_env = "OPENAI_API_KEY"         # Có thể dùng chung hoặc khóa riêng

Lưu ý về API Key: Để đảm bảo an toàn, bạn nên lưu trữ khóa API của mình trong biến môi trường hệ thống thay vì đặt trực tiếp vào tệp cấu hình. Ví dụ, bạn có thể đặt export OPENAI_API_KEY="sk-..." vào ~/.bashrc và nạp lại terminal.

Khởi chạy OpenManus

Để khởi chạy OpenManus và bắt đầu tương tác với AI Agent, hãy làm theo các bước sau:

Quan trọng: Mỗi khi bạn mở một terminal mới để làm việc với OpenManus, bạn cần kích hoạt lại môi trường ảo. Điều này đảm bảo rằng các gói phụ thuộc của dự án được tải đúng cách.

source .venv/bin/activate  # Kích hoạt môi trường ảo

Sau khi môi trường ảo được kích hoạt, bạn có thể chạy ứng dụng OpenManus:

python main.py

Sau khi ứng dụng khởi động, bạn có thể nhập các yêu cầu hoặc ý tưởng của mình trực tiếp vào terminal để OpenManus xử lý.

Thẻ: OpenManus AI Agent Triển khai Cục bộ linux python

Đăng vào ngày 10 tháng 7 lúc 22:41

Thẻ Phổ Biến

©2026 Thành phố Cuồng loạn