Terminal cho AI: Chạy lệnh & quản lý file qua API

TL;DR

Công cụ self-hosted cho phép AI agents chạy terminal commands, quản lý file, execute code từ xa qua REST API. Có 2 mode: Docker (an toàn, sandboxed) hoặc cài trực tiếp (toàn quyền truy cập máy).

Nói đơn giản: Cho AI mở terminal và gõ lệnh được trên server của mình.

Bài này dành cho ai?

1. Người muốn AI làm việc thay mình

Vấn đề: AI viết code giỏi rồi, nhưng không có chỗ chạy. Phải copy-paste thủ công qua lại.

Khi nào cần: Khi muốn AI tự deploy, chạy script, quản lý file server mà không cần mình login SSH.

Được gì: AI tự chạy được commands, install packages, restart services.

2. Người build sản phẩm AI

Vấn đề: Cần give AI assistant quyền execute commands nhưng phải kiểm soát được security.

Khi nào cần: Khi build AI assistant cần run terminal commands như một phần của workflow.

Được gì: REST API để AI gọi, có sandbox mode an toàn với Docker.

3. DevOps/ Sysadmin

Vấn đề: Muốn automate server tasks nhưng không muốn viết complex scripts.

Khi nào cần: Khi cần AI帮忙 chạy maintenance commands, restart services, check logs.

Được gì: Gọi terminal qua HTTP, tích hợp được với AI workflows có sẵn.

Các điểm chính

1. AI cần nơi chạy code, không chỉ viết code Open Terminal cung cấp remote shell với file management và search, accessible qua REST API. AI viết xong code có chỗ execute ngay.

→ Làm gì: Deploy Open Terminal bằng 1 dòng Docker, sau đó gọi API để AI chạy commands.

2. Chọn Docker nếu muốn an toàn, chọn bare metal nếu cần full access Docker chạy trong container isolated với Python, Node.js, git, ffmpeg có sẵn. Bare metal chạy trực tiếp trên máy với quyền user hiện tại.

→ Làm gì: Dùng Docker cho AI agents public, dùng bare metal cho automation cá nhân.

3. Config linh hoạt theo thứ tự ưu tiên CLI flags > Environment variables > User config ($~/.config/open-terminal/config.toml) > System config > Defaults. Đặt API key ở user config để không hiện trong ps/htop.

→ Làm gì: Đặt system-wide defaults ở /etc/open-terminal/config.toml, API key ở user config.

4. Tích hợp Open WebUI để AI gọi terminal trực tiếp Có 2 cách: Direct connection (browser gọi thẳng, cho local) hoặc System-level (Open WebUI backend proxy, cho remote). Kết nối xong có file navigation sidebar tích hợp.

→ Làm gì: Vào Admin Settings → Integrations → Open Terminal, thêm URL và API key.

5. Timeout mặc định không có, config được execute_timeout Mặc định không giới hạn thời gian chờ command output. Có thể set execute_timeout = 5 trong config để tránh commands chạy quá lâu.

→ Làm gì: Set timeout phù hợp với use case, đặc biệt khi cho AI public access.

Quick Start

1. Chạy ngay với Docker:

docker run -d --name open-terminal --restart unless-stopped -p 8000:8000 -v open-terminal:/home/user -e OPEN_TERMINAL_API_KEY=your-secret-key ghcr.io/open-webui/open-terminal

Sau đó vào http://localhost:8000/docs để xem API.

2. Test thử gọi API:

curl -X POST http://localhost:8000/api/v1/execute \
  -H "Authorization: Bearer your-secret-key" \
  -d '`{"command": "echo hello"}`'