Triển khai Robot trên OpenMind Fabric Linux

Nguồn ảnh: openmind.org/platform

Hướng dẫn này giúp chạy node openmind với chi phí thấp nhất (có thể). Triển khai 1 node OpenMind OM1 trên Google Cloud VM (GCE), viết theo kiểu step by step, phù hợp với người mới. Sử dụng Ubuntu 22.04 LTS.

Mục tiêu: Node chạy ổn định, không lỗi PEP 668, không lỗi audio, không lỗi git

1- TẠO VM TRÊN GOOGLE CLOUD

• Truy cập https://console.cloud.google.com
• Chọn Select a project → New Project
• Đặt tên (vd: openmind-om1) rồi bấm Create
• Tạo VM Instance: Vào Compute Engine → VM instances rồi Bấm Create Instance

2- CHUẨN BỊ MÔI TRƯỜNG HỆ THỐNG ĐỂ CHẠY NODE OM1

2.1- Update & nâng cấp hệ thống

sudo apt update -y
sudo apt upgrade -y
sudo reboot

➡ SSH lại sau reboot

2.2- Cài các gói hệ thống bắt buộc

sudo apt install -y \
git \
curl \
build-essential \
python3 \
python3-pip \
python3-venv \
python3-all-dev \
ffmpeg \
portaudio19-dev \
alsa-utils

2.3- Load dummy audio (VM không có sound card)

sudo modprobe snd-dummy

👉 Thấy Dummy là OK. Nếu không thì chuyển sang 2.4.

2.4- Dùng ALSA NULL

👉 Phù hợp Cloud / VM / Robot headless

👉 OM1 vẫn chạy BÌNH THƯỜNG

1️⃣ Tạo cấu hình ALSA null

nano ~/.asoundrc

Dán nội dung sau:

pcm.!default {
    type null
}
ctl.!default {
    type null
}

Lưu lại.

2️⃣ Kiểm tra

aplay -l

👉 Có thể vẫn báo no soundcards found

⚠️ KHÔNG SAO – đây là bình thường

Test:

aplay /usr/share/sounds/alsa/Front_Center.wav

➡ Không báo lỗi = OK

3️⃣ Export biến môi trường cho OM1

export ALSA_PCM_CARD=0
export ALSA_CTL_CARD=0

➡ OM1 sẽ không cần sound card thật

2.5- Tránh lỗi PEP 668

1️⃣ Tạo virtual environment cho OM1

python3 -m venv om1-env

Kích hoạt:

source om1-env/bin/activate

Kiểm tra:

which python

➡ Phải trỏ tới om1-env/bin/python

2️⃣ Nâng pip trong venv

pip install --upgrade pip setuptools wheel

3- TRIỂN KHAI OPENMIND OM1

1️⃣ Clone source OM1

git clone https://github.com/openmind/OM1.git
cd OM1

2️⃣ Thiết lập UV, Git và biến môi trường

pip install uv
git submodule update --init
uv venv

4- THANH TOÁN VÀ TẠO KHÓA OPENMIND API

→ Truy cập vào https://portal.openmind.org/ rồi đăng nhập bằng tài khoản Google.

→ Ở bảng điều khiển, bấm Purchase Credits rồi thanh toán bằng cách kết nối ví. Khoảng 5-10 USDC mạng Base.

→ Khi thanh toán xong, bấm Create API Key rồi copy đoạn khóa này, lưu vào file word hoặc notepad...để sử dụng ở bước 5.

5- CẤU HÌNH VÀ TIẾN HÀNH CHẠY NODE OM1

1️⃣ Thiết lập biến môi trường

cp env.example .env
nano .env

Nhập vào khóa API ở bước 4, rồi bấm CTRL + X → bấm Y → bấm ENTER

2️⃣ Chạy node OM1

cd ~/OM1
source .venv/bin/activate

uv run src/run.py conversation

➡ Khi xuất hiện các dòng chữ bên dưới đây thì node đang chạy thành công.

INFO - Falling back to network discovery.
INFO - Zenoh client opened with network discovery
INFO - LLM initialized with function schemas.
INFO - Starting OM1 with standard configuration: conversation

➡ Còn nếu xuất hiện lỗi “401 Insufficient Balance” thì có thể bạn chưa thanh toán API hoặc là không đủ phí để thực hiện.

6- CHẠY OM1 DẠNG SERVICE

➡ còn tiếp >>>>