𝗖𝗼𝗱𝗶𝗻𝗴 𝗔𝗴𝗲𝗻𝘁𝘀 qua 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: Từ con số 0 đến một Agent có khả năng phản hồi
Ngừng đọc và hãy bắt đầu thực hành ngay.
Kết thúc hướng dẫn này, bạn sẽ có một topic trên Telegram nơi một coding agent sẽ trả lời các tin nhắn của bạn. Agent này sẽ điều khiển một tmux pane trên chính máy tính của bạn.
Đây là mục tiêu cốt lõi. Bạn chưa cần đến bộ nhớ (memory), trình giám sát (monitors) hay máy chủ công cụ (tool servers). Bạn chỉ cần làm cho agent có thể trả lời bạn.
⏱️ Thời gian cần thiết: 30–45 phút.
🛠️ Điều kiện tiên quyết
Trước khi bắt đầu, hãy đảm bảo bạn đã chuẩn bị sẵn các mục sau:
- Một máy tính có quyền truy cập tmux và shell.
- Một coding agent đang hoạt động (như OpenCode hoặc Claude Code) đã chạy sẵn trong một tmux pane.
- Mục tiêu tmux chính xác cho agent của bạn (ví dụ: mybox:1.1).
- Câu lệnh chính xác để khởi chạy agent của bạn.
- Đã cài đặt OpenClaw runtime.
- Một tài khoản Telegram và ứng dụng Telegram.
📦 Các phiên bản yêu cầu
Đừng bỏ qua bước này. Sai phiên bản sẽ gây ra các lỗi ngầm (silent failures).
• Node.js: 24.11.1 • Trình quản lý gói: pnpm 11.2.2 • OpenClaw: Cố định (pin) ở một commit cụ thể.
🚀 Lộ trình thiết lập nhanh
Bạn có thể sử dụng các script này để xử lý việc thiết lập cục bộ:
Tải các script: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh
Chạy thiết lập với bot token của bạn: OPENCLAW_BOT_TOKEN="
" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh Xác minh thiết lập: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh
📱 Cấu hình Telegram
Thực hiện các bước sau trong ứng dụng Telegram của bạn:
- Tạo một bot thông qua @BotFather và lưu lại token.
- Tạo một nhóm mới và thêm bot của bạn vào.
- Đặt bot làm Quản trị viên (Administrator). Điều này cho phép bot xem được các tin nhắn của bạn.
- Bật "Topics" trong phần cài đặt nhóm.
- Tạo một topic cho dự án của bạn.
- Gửi một tin nhắn vào topic đó để tạo Topic ID trong nhật ký (logs) của bạn.
⚙️ Kết nối mọi thứ lại với nhau
Gateway sử dụng một tệp cấu hình JSON tại ~/.openclaw/openclaw.json.
Sử dụng Phase 1 để tìm Chat ID và Topic ID bằng cách gửi một tin nhắn và kiểm tra nhật ký (logs) của gateway.
Sử dụng Phase 2 để thắt chặt bảo mật nhóm. Thay đổi chính sách thành "allowlist" và chỉ thêm ID người dùng Telegram (dạng số) của bạn. Ánh xạ Topic ID của bạn với Agent ID cụ thể của bạn.
📝 Hợp đồng của Agent
Tạo một tệp AGENTS.md trong không gian làm việc của agent. Tệp này hướng dẫn agent cách hành xử. Bạn phải định nghĩa:
- Cách đọc pane (tmux capture-pane).
- Cách ghi vào pane (tmux send-keys).
- Cách xử lý các lệnh cụ thể như "status", "send", hoặc "restart".
✅ Bài kiểm tra mức độ sẵn sàng
Bạn chỉ hoàn thành khi vượt qua được năm bước kiểm tra sau:
- Bot phản hồi trong topic Telegram của bạn.
- Prompt của bạn truyền đến được tmux pane.
- Coding agent bắt đầu thực hiện prompt.
- Một tệp log chứng minh rằng agent đã xử lý topic của bạn.
- Nhóm chỉ được khóa cho duy nhất User ID của bạn.
Nguồn: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777
Cộng đồng học tập tùy chọn: https://t.me/GyaanSetuAi