# ohmygame: làm game bằng AI trên một canvas — hướng dẫn cài đặt và dùng

> OhMyGame là ứng dụng desktop mã nguồn mở (Apache-2.0) giúp bạn làm game bằng AI. Bạn mô tả game, agent sẽ thiết kế, tạo hình ảnh, viết code, chơi thử và xuất bản thành link. Cài bản dựng sẵn cho Windows hoặc Mac khá dễ, nhưng bạn cần tự kết nối một nhà cung cấp mô hình AI bằng key của mình.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-13 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/ohmygame-lam-game-bang-ai-huong-dan-cai-dat-2

OhMyGame là một ứng dụng mã nguồn mở để làm game bằng AI, chạy ngay trên máy bạn. Bạn mô tả game muốn làm, agent sẽ viết tài liệu thiết kế, tạo hình ảnh, viết code, chạy thử game để kiểm tra, rồi xuất bản thành một đường link ai cũng mở được. Tác giả gọi nó là "studio game một người", nghĩa là một mình bạn cũng làm được cả quy trình.

Vấn đề repo giải quyết khá quen thuộc. Làm một game nhỏ thường phải dùng nhiều công cụ rời rạc: một app để viết ý tưởng, một app để vẽ, một chỗ để làm âm thanh, một trình soạn code. OhMyGame gom tất cả vào một ứng dụng, với một canvas chung để đặt ảnh, video, mô hình 3D, âm thanh cạnh phần code.

Ai nên dùng? Người làm kinh doanh muốn thử làm game mini để quảng bá, nhân viên văn phòng tò mò về làm game, lập trình viên mới muốn có "người cùng làm" là AI. Điểm đáng giá nhất: bạn dùng key của chính mình, không bị tính credit theo từng lần chạy. Repo hiện có khoảng 2172 sao và 273 fork, đang trong giai đoạn beta nên có thể còn lỗi vặt.

```repo
- repo | WhiteTowerAI/ohmygame
- kind | Ứng dụng
- desc | OhMyGame là ứng dụng mã nguồn mở để làm game bằng AI: agent thiết kế, vẽ, viết code, tự chơi thử và xuất bản game thành một đường link.
- stars | 2.2k
- lang | TypeScript
- license | Apache-2.0
```

## OhMyGame làm được gì

### Agent làm game thay bạn

Agent soạn tài liệu thiết kế, viết code, chạy game trong khung xem trước trực tiếp, rồi tự chơi thử. Nếu có chỗ hỏng, nó thử sửa. Lợi ích thực tế: bạn không phải tự copy code qua lại giữa chatbot và trình soạn code để xem game có chạy hay không.

### Một canvas cho mọi tài nguyên

Bạn có thể tạo ảnh, video, mô hình 3D, hoạt ảnh, giọng nói, hiệu ứng âm thanh và nhạc bằng AI, rồi sắp xếp chúng trên cùng một canvas, sẵn sàng đưa vào game. Bạn đỡ phải chuyển qua lại giữa năm bảy ứng dụng khác nhau.

### Xuất bản thành link

Game làm xong được đưa lên thành một đường link, ai cũng chơi được trên trình duyệt, và còn xuất hiện trong mục Community của dự án. Với game nhiều người chơi, phòng chơi, đăng nhập của người chơi, lưu tiến trình và bảng xếp hạng đi kèm sẵn, bạn không cần tự dựng máy chủ.

### Mở rộng bằng plugin

Plugin có thể dạy agent kỹ năng mới, thêm công cụ, thêm bảng điều khiển và loại dự án. Theo README, các plugin đi kèm hỗ trợ Godot, Unity, Unreal Engine, Blender, Aseprite, Tiled, và các nền tảng như WeChat, Douyin Mini Games. Bạn cũng có thể tự viết plugin theo hướng dẫn trên trang docs của dự án.

### Mang agent của bạn đến

OhMyGame chạy được trên Claude Code, Codex hoặc OpenCode, hoặc trên hơn 40 nhà cung cấp mô hình với key của bạn. Chiều ngược lại cũng được: bạn dùng canvas, tạo media và chơi thử từ agent bên ngoài qua MCP.

### Loại game nên thử trước

README khuyên bắt đầu với game web (Phaser, Three.js, React Three Fiber). Ngoài ra có truyện tương tác (visual novel, phim tương tác) và game tổng quát với bất kỳ engine nào. Game web có thể chơi nhiều người, từ cờ bài đến đấu trường thời gian thực.

## Cần chuẩn bị gì

Nếu cài bản dựng sẵn, bạn cần một trong hai máy sau:

- Mac chip Apple silicon, hoặc
- Windows x64.

Mac Intel và Linux hiện mới nằm trong kế hoạch (roadmap), chưa có bản chính thức.

OhMyGame **không đi kèm mô hình AI**. Lần chạy đầu tiên, bạn phải kết nối một nhà cung cấp mô hình, hoặc một coding agent bạn đã dùng sẵn. Nghĩa là bạn cần có key hoặc tài khoản của nhà cung cấp đó. README không nói cụ thể bạn nên chọn nhà nào, nên bạn xem danh sách ở trang docs về models.

Tài khoản OhMyGame chỉ cần khi bạn muốn xuất bản game.

Nếu muốn chạy từ mã nguồn (dành cho người biết dùng terminal), bạn cần thêm:

- Bun phiên bản 1.4.2 trở lên.
- Node.js 22.19 trở lên.
- Git để tải mã nguồn.

README không nêu yêu cầu về GPU hay dung lượng ổ đĩa, nên mình không khẳng định gì về phần này.

## Cài đặt từng bước

Có hai đường: tải bản dựng sẵn (dễ nhất, nên chọn nếu bạn không phải lập trình viên) hoặc chạy từ mã nguồn.

```steps
- Tải ứng dụng | Vào trang tải về cho Mac hoặc Windows
- Cài đặt | Mở file vừa tải và cài như app bình thường
- Mở lần đầu | Kết nối nhà cung cấp mô hình hoặc coding agent
- Tạo game | Mô tả game bằng lời và để agent làm
- (Tuỳ chọn) Chạy từ mã nguồn | Dùng git và bun nếu bạn muốn tự build
```

### Tải bản dựng sẵn

README đưa hai đường tải: bản cho Mac (Apple silicon) tại `https://ohmygame.ai/download/mac` và bản cho Windows (x64) tại `https://ohmygame.ai/download/windows`. Bản cũ và ghi chú phát hành nằm ở mục Releases trên GitHub của repo.

Chỗ người mới hay vấp: bản Windows chưa được ký số (code-signed), nên khi cài lần đầu Windows SmartScreen có thể hiện cảnh báo. Đây là điều tác giả đã nói trước. Chỉ tải từ đúng đường link trong README hoặc trang Releases của repo, đừng tải từ nguồn lạ.

### Mở app và kết nối mô hình

Sau khi cài, mở ứng dụng. Vì OhMyGame không kèm mô hình, lần đầu bạn sẽ phải kết nối một nhà cung cấp hoặc coding agent bạn đang dùng. Các bước chi tiết nằm ở trang first-run của dự án: `https://ohmygame.ai/docs/first-run/`. README không chép lại từng bước ở đây nên mình không bịa thêm, bạn mở trang đó và làm theo.

```note
Key API của bạn là thông tin nhạy cảm. README cho biết key và dự án nằm trên máy bạn, prompt đi thẳng tới nhà cung cấp bạn chọn. Dù vậy, hãy đặt hạn mức chi tiêu ở phía nhà cung cấp, vì việc tạo ảnh, video, 3D có thể tốn phí theo cách tính của họ.
```

### Chạy từ mã nguồn (tuỳ chọn)

Bước này dành cho người đã quen terminal. Mở terminal (PowerShell hoặc Terminal), chuyển tới thư mục bạn muốn lưu code rồi chạy:

```bash
git clone https://github.com/WhiteTowerAI/ohmygame.git
cd ohmygame
bun install --frozen-lockfile
```

Lệnh đầu tải mã nguồn về máy. Lệnh `cd ohmygame` đi vào thư mục vừa tải. Lệnh `bun install --frozen-lockfile` cài các thư viện đúng phiên bản đã khoá sẵn. Nếu báo không tìm thấy `bun`, nghĩa là bạn chưa cài Bun, hãy cài từ bun.sh trước.

Sau đó chọn một trong hai cách chạy:

```bash
bun run dev            # web renderer + local daemon
bun run dev:desktop    # or the Electron app
```

Lệnh thứ nhất chạy giao diện web cùng một tiến trình nền cục bộ. Lệnh thứ hai chạy dạng ứng dụng Electron. Phần sau dấu `#` chỉ là chú thích gốc của README, bạn không cần gõ.

README cho biết bản build từ mã nguồn không gửi dữ liệu telemetry. Muốn biết về nhánh, kiểm tra hay thiết lập đám mây tuỳ chọn, xem file CONTRIBUTING.md trong repo.

## Kiểm tra đã chạy được chưa

README không đưa ra một câu lệnh kiểm tra riêng, nên cách kiểm tra là quan sát:

- Với bản dựng sẵn: ứng dụng mở lên được, và màn hình lần đầu dẫn bạn tới bước kết nối nhà cung cấp mô hình. Kết nối xong, bạn gõ thử một mô tả game ngắn và xem agent có phản hồi, soạn thiết kế hay không.
- Với bản từ mã nguồn: lệnh `bun run dev` chạy không báo lỗi, hoặc `bun run dev:desktop` mở ra cửa sổ ứng dụng. Chi tiết địa chỉ và cổng README không ghi, bạn xem thông báo in ra trong terminal.

Gợi ý nhỏ: lần đầu hãy thử một game thật đơn giản, ví dụ trò rắn săn mồi hoặc xếp hình, để chắc rằng key hoạt động trước khi làm dự án lớn.

## Dùng vào việc thật

### Chủ shop làm game mini để tặng khách

Bạn bán đồ handmade và muốn một trò chơi nhỏ trên điện thoại để khách chơi lúc chờ. Chọn loại game web, mô tả bằng lời: ví dụ "trò lật thẻ ghép đôi với hình các sản phẩm của shop, có bảng điểm". Agent soạn thiết kế, viết code, chạy thử trong khung xem trước. Bạn tạo thêm ảnh và âm thanh trên canvas, rồi xuất bản thành link để gửi cho khách qua tin nhắn.

> Bạn không cần biết code, chỉ cần biết mình muốn trò chơi trông như thế nào.
>
> — Ông T

### Nhân viên văn phòng làm trò chơi cho buổi họp nhóm

Bạn cần một trò đố vui nội bộ cho sự kiện công ty, nhiều người chơi cùng lúc. README nói game web có thể chơi nhiều người, kèm phòng chơi và bảng xếp hạng, không cần dựng máy chủ riêng. Bạn mô tả luật chơi, để agent làm, rồi chia sẻ link cho đồng nghiệp. Kết quả là một game chạy trên trình duyệt, ai bấm link cũng vào được.

### Lập trình viên mới dùng agent làm "bạn cùng code"

Bạn đang học làm game bằng Phaser hoặc Three.js. Thay vì chỉ đọc tài liệu, bạn nhờ agent dựng khung game, rồi đọc code nó viết và sửa theo ý mình. Khi game hỏng, agent tự chơi thử và thử sửa, bạn xem nó sửa gì để học. Nếu bạn đã có Claude Code hoặc Codex, có thể dùng chính chúng làm "bộ não" cho OhMyGame.

### Người đã có agent riêng muốn thêm canvas và chơi thử

Bạn đã quen dùng một coding agent và không muốn đổi thói quen. README nói bạn có thể dùng canvas, tạo media và chơi thử của OhMyGame từ agent đó qua MCP. Cách cấu hình cụ thể README không ghi chi tiết, bạn xem phần External agents trong thư mục `docs/` của repo.

## Lỗi hay gặp và cách xử lý

### Windows hiện cảnh báo SmartScreen

Đây là điều tác giả đã báo trước vì bản Windows chưa ký số. Nếu bạn tải đúng từ đường link trong README hoặc trang Releases, bạn có thể cân nhắc tiếp tục cài. Nếu không chắc nguồn tải, đừng cài.

### Mở app lên nhưng agent không trả lời

Vì app không kèm mô hình, nguyên nhân dễ nhất là bạn chưa kết nối nhà cung cấp, hoặc key sai/hết hạn mức. Quay lại bước first-run, kiểm tra lại key, và xem tài khoản phía nhà cung cấp còn dùng được không.

### Chi phí tăng nhanh khi tạo nhiều ảnh, video, 3D

OhMyGame không tính credit theo lần chạy, nhưng nhà cung cấp mô hình của bạn thì có tính phí. Cách an toàn: đặt hạn mức chi tiêu ở phía nhà cung cấp, và thử với dự án nhỏ trước.

### Lệnh `bun` hoặc `node` không nhận diện khi chạy từ mã nguồn

Nghĩa là chưa cài Bun hoặc Node, hoặc phiên bản quá cũ. README yêu cầu Bun 1.4.2+ và Node.js 22.19+. Cài hoặc nâng cấp, rồi mở terminal mới để máy nhận lại.

### Game chạy sai hoặc ứng dụng lỗi lạ

Dự án đang ở giai đoạn beta nên có thể gặp lỗi. Thử mô tả lại yêu cầu rõ hơn và chia nhỏ từng bước. Nếu lỗi nằm ở ứng dụng, bạn báo qua Issues trên GitHub hoặc Discord của dự án. README cũng nói có hướng dẫn xem log và chẩn đoán trong thư mục docs.

## Có nên dùng không

**Điểm mạnh.** Gom toàn bộ quy trình làm game (thiết kế, hình ảnh, âm thanh, code, chơi thử, xuất bản) vào một nơi. Mã nguồn mở với giấy phép Apache-2.0. Dự án và key nằm trên máy bạn, prompt đi thẳng tới nhà cung cấp bạn chọn. Không có credit theo lần chạy, bạn chủ động chọn mô hình. Có plugin cho nhiều engine và công cụ quen thuộc.

**Giới hạn.** Đang ở giai đoạn beta nên còn thô. Bản dựng sẵn chỉ có cho Mac Apple silicon và Windows x64. Bản Windows chưa ký số. Bạn phải tự có key hoặc tài khoản nhà cung cấp mô hình, và chi phí phụ thuộc vào họ. Bản chính thức gửi dữ liệu sử dụng và báo lỗi (tắt được tại Settings → About). Xuất bản game cần có tài khoản.

**Khi nên chọn cách khác.** Nếu bạn dùng Mac Intel hoặc Linux và chưa muốn tự build từ mã nguồn, hãy chờ bản hỗ trợ. Nếu bạn muốn một game lớn, phức tạp với engine riêng, hãy xem như OhMyGame là công cụ phác thảo và làm nguyên mẫu nhanh, rồi cân nhắc dùng engine truyền thống cho phần còn lại.

Tóm lại, nếu bạn tò mò làm game bằng AI và đã có sẵn một key mô hình, OhMyGame là nơi thử khá thuận tiện. Hãy bắt đầu bằng một game web nhỏ để làm quen trước.

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

### OhMyGame có miễn phí không?

Ứng dụng là mã nguồn mở theo giấy phép Apache-2.0 và README nói không tính credit theo từng lần chạy. Tuy nhiên bạn phải tự mang key của nhà cung cấp mô hình, nên chi phí phụ thuộc vào nhà cung cấp đó. Tên và logo OhMyGame không nằm trong giấy phép.

### OhMyGame có chạy được trên Windows không?

Có. README có bản tải cho Windows (x64) và bản cho Mac Apple silicon. Bản Windows chưa được ký số nên SmartScreen có thể cảnh báo lần cài đầu. Mac Intel và Linux mới nằm trong roadmap.

### Cần GPU hay máy cấu hình mạnh không?

README không nêu yêu cầu về GPU hay cấu hình phần cứng. Prompt được gửi thẳng đến nhà cung cấp mô hình bạn chọn, nên phần xử lý AI không nhất thiết chạy trên máy bạn. Về cấu hình tối thiểu, hiện chưa có thông tin trong tư liệu.

### Dữ liệu và API key của tôi có an toàn không?

README nói dự án và API key nằm trên máy bạn, prompt đi thẳng đến nhà cung cấp bạn chọn, và chỉ cần tài khoản khi xuất bản. Bản chính thức có gửi dữ liệu sử dụng và báo lỗi, bạn tắt được tại Settings → About. Bản build từ mã nguồn không gửi telemetry.

### Cài xong có dùng được ngay không?

Chưa hẳn. OhMyGame không đi kèm mô hình, nên lần chạy đầu bạn phải kết nối một nhà cung cấp hoặc một coding agent đã có. Hướng dẫn nằm ở trang first-run của dự án.

### OhMyGame dùng được với Claude Code hoặc Codex không?

Có. README nói bạn có thể chạy OhMyGame trên Claude Code, Codex hoặc OpenCode, hoặc trên hơn 40 nhà cung cấp mô hình bằng key của bạn. Ngược lại, bạn cũng có thể dùng canvas, tạo media và chơi thử của OhMyGame từ agent của mình qua MCP.

### Nên bắt đầu với loại game nào?

README khuyên bắt đầu với game web dùng Phaser, Three.js hoặc React Three Fiber. Ngoài ra có truyện tương tác và game tổng quát với engine bất kỳ. Game web cũng có thể là game nhiều người chơi mà bạn không cần tự dựng máy chủ.
