Openclaw(Moltbot /Clawdbot) : Hướng dẫn cài đặt+ Hướng dẫn triển khai API

Dẫn đầu là Moltbot (trước đây gọi là Clawdbot), một dự án từ một công cụ dành cho nhà phát triển ngách trở thành hiện tượng lan truyền với hơn 60.000 sao trên GitHub chỉ trong vài tuần. Được tạo bởi Peter Steinberger, Moltbot đại diện cho quá trình “lột xác” của tác nhân AI — loại bỏ giới hạn của giao diện web để hiện diện trong các ứng dụng nhắn tin và hệ thống tệp mà chúng ta sử dụng hằng ngày.

Sự chú ý gần đây: dự án đã đổi thương hiệu từ Clawdbot sang Moltbot sau khi nhận được yêu cầu liên quan đến nhãn hiệu từ Anthropic vì “Clawd” nghe quá giống “Claude.”

Moltbot (Clawdbot) là gì và vì sao nó viral?

Moltbot là một tác nhân AI mã nguồn mở, tự lưu trữ, được thiết kế để bắc cầu giữa các Mô hình Ngôn ngữ Lớn (LLM) mạnh mẽ và máy tính cục bộ của bạn. Khác với ChatGPT hay Claude.ai tồn tại trong một tab trình duyệt “vườn kín”, Moltbot chạy như một Gateway trên phần cứng của bạn (Mac, Linux, hoặc VPS).

Nó chuyển các thông điệp ngôn ngữ tự nhiên từ các nền tảng như Telegram, WhatsApp và Slack thành các hành động có thể thực thi trên máy của bạn. Dù bạn cần tìm một tệp trên desktop khi đang ở cửa hàng tạp hóa hay kích hoạt một script triển khai phức tạp từ điện thoại, Moltbot đóng vai trò đại diện số của bạn với toàn quyền truy cập hệ thống.

Vì sao nó khác biệt

• Thực thi & công cụ ưu tiên cục bộ: Moltbot thực sự có thể chạy lệnh trên host (có sự đồng ý), gọi API bên ngoài và sử dụng “skills” là các chương trình nhỏ hoặc quy trình công việc định nghĩa bằng markdown.
• Đa kênh: bạn dùng cùng một trợ lý từ Telegram, WhatsApp, Slack, Discord và hơn thế nữa — nó có thể chủ động nhắn cho bạn.
• Bộ nhớ & tính bền vững: Moltbot lưu tệp bộ nhớ trong workspace (Markdown) và lập chỉ mục để truy hồi, giúp trợ lý “nhớ” xuyên suốt các phiên (chi tiết bên dưới).

Năng lực cốt lõi nhìn nhanh

Clawdbot “nhớ” mọi thứ mà không cần cơ sở dữ liệu như thế nào?

Một khía cạnh sáng tạo của Moltbot là kiến trúc bộ nhớ minh bạch. Hầu hết các công cụ AI mắc “chứng quên” giữa các phiên. Moltbot giải quyết bằng hệ thống phân lớp các tệp Markdown thuần trong workspace của bạn. Cách tiếp cận này đảm bảo bạn có thể đọc, chỉnh sửa và kiểm toán chính xác những gì AI biết về bạn.

Thiết kế bộ nhớ là gì và hoạt động ra sao?

Bộ nhớ của Moltbot có chủ đích đơn giản và có thể kiểm toán: bộ nhớ là các tệp Markdown thuần bên trong workspace của tác nhân. Các tệp là nguồn chân lý — mô hình chỉ “nhớ” những gì được ghi xuống đĩa. Bố cục mặc định sử dụng:

• memory/YYYY-MM-DD.md — log hằng ngày chỉ-ghi-thêm (trợ lý đọc hôm nay + hôm qua khi khởi động phiên).
• MEMORY.md — bộ nhớ dài hạn được bạn biên soạn và chỉ tải vào các phiên riêng tư.

Thiết kế này có hai lợi ích lớn:

1. Khả năng kiểm toán — bạn có thể đọc và chỉnh sửa những gì trợ lý dùng làm bộ nhớ.
2. Đơn giản cho tooling — plugin bộ nhớ cung cấp lập chỉ mục vector/BM25 để tác nhân nhanh chóng tìm kiếm mục bộ nhớ liên quan.

Cách tiếp cận kỹ thuật

• Kho phiên/cuộc hội thoại: Gateway theo dõi các phiên và chuyển đúng ngữ cảnh tới runtime của tác nhân. Điều này cho phép tác nhân bảo toàn trạng thái hội thoại qua các tin nhắn và kênh.
• Dữ liệu cục bộ đã lập chỉ mục: Moltbot có thể lập chỉ mục tệp và tài liệu cục bộ, rồi cung cấp thông qua các công cụ tìm kiếm (ngữ nghĩa hoặc từ khóa) để truy hồi. Đây là cách tác nhân có thể “nhớ” ghi chú cuộc họp, đoạn mã, hoặc code của bạn.
• Đầu ra công cụ và nguyên thủy bộ nhớ: Skills và công cụ có thể ghi vào kho bền vững (cơ sở dữ liệu hoặc hệ tệp), và Moltbot có thể tham chiếu các mục đó ở prompt sau. Nhiều triển khai dùng SQLite, Postgres hoặc JSON/YAML cục bộ cho thiết lập nhỏ.
• LLM embeddings & vector store: Với truy hồi ngữ nghĩa, mẫu thông dụng là nhúng tài liệu và lưu vector trong DB vector, rồi lấy láng giềng gần nhất để đưa vào prompt. Kiến trúc của Moltbot hỗ trợ lời gọi công cụ độc lập mô hình, nên bạn có thể cắm combo embedding + vector store tùy ý.

Cảnh báo bảo mật: vì bộ nhớ là bền vững và skills có thể chạy lệnh trên host, các mặc định khuyến nghị khá thận trọng: ghép đôi DM cho người gửi lạ, sandboxing cho phiên không phải chính, và kiểm tra moltbot doctor để hiển thị cấu hình rủi ro. Luôn xem tài liệu bảo mật và coi thông điệp đến là đầu vào không tin cậy.

Hệ phân cấp bộ nhớ

Khi bạn bảo Moltbot, “Hãy nhớ là tôi thích báo cáo ở định dạng PDF,” nó không lưu điều này trong một cơ sở dữ liệu SQL ẩn. Nó thực sự mở USER.md và thêm một gạch đầu dòng mới. Điều này cho phép tác nhân duy trì ngữ cảnh qua nhiều tuần trò chuyện, khiến nó giống một trợ lý cá nhân thực thụ hơn là khởi tạo mới mỗi sáng.

---

Hướng dẫn thiết lập Moltbot: điều kiện tiên quyết và cài đặt

Dưới đây là danh sách kiểm tra thực tế và các lệnh để chạy một instance Moltbot cơ bản trên macOS/Linux (Ubuntu). Đây là hướng dẫn rút gọn, thiên về sản xuất — nếu bạn cần GUI hoặc máy chủ quản lý, hãy chuyển đến phần hosting API.

Bạn sẽ cần (điều kiện tiên quyết)

• Máy chạy macOS hoặc Linux (Windows có thể dùng qua WSL2). Node.js v22+ là bắt buộc cho gateway và CLI.
• Trình soạn thảo văn bản và quen thuộc cơ bản với shell.
• Ít nhất một khóa API LLM (OpenAI, Anthropic, Venice, hoặc mô hình cục bộ như Ollama) — bản thân Moltbot độc lập mô hình.
• Tùy chọn: Docker, nếu bạn thích triển khai dạng container.

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

1. Cài gói: Chạy lệnh sau trong terminal của bạn: npm install -g clawdbot@latest
2. Khởi chạy Trình hướng dẫn Onboarding: Trình hướng dẫn là trái tim của thiết lập. Nó sẽ dẫn bạn qua xác nhận bảo mật và chọn mô hình. clawdbot onboard --install-daemon
3. Xác nhận rủi ro bảo mật: Moltbot sẽ yêu cầu bạn xác nhận rằng nó có quyền truy cập “tương tự root” vào máy của bạn. Bạn phải gõ xác nhận để tiếp tục.
4. Cấu hình Gateway: Trình hướng dẫn sẽ cài clawdbot gateway như một dịch vụ nền (launchd trên Mac hoặc systemd trên Linux) để nó trực tuyến 24/7.

Cài nhanh (macOS / Linux)

Ví dụ này dùng phương pháp git + npm được khuyến nghị, tương tự tài liệu chính thức.

# Clone và vào repo
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# Cài qua npm (CLI toàn cục) hoặc chạy cục bộ
npm install -g @moltbot/cli   # hoặc: npm ci && npm run build

# Tạo tệp môi trường từ ví dụ
cp .env.example .env

# Sửa .env và thêm khóa API của bạn (OPENAI_API_KEY, ANTHROPIC_API_KEY, v.v.)
# Sau đó chạy onboarding
moltbot onboard --install-daemon
moltbot start

Docker (cơ bản)

# docker-compose.yml (đơn giản hóa)
version: "3.8"
services:
  moltbot:
    image: moltbot/moltbot:latest
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - OTHER_KEYS=...
    volumes:
      - ./data:/app/data
    ports:
      - "3000:3000"

Chạy với:

docker compose up -d

Sau cài đặt: ghép đôi kênh nhắn tin

Moltbot hỗ trợ nhiều kênh. Ghép đôi thường liên quan đến việc tạo token ghép đôi từ UI hoặc CLI của gateway và dùng một “pairing URL” nhỏ để kết nối bot Telegram hoặc tài khoản WhatsApp — các bước cụ thể tùy vào connector bạn chọn (Telegram Bot API vs. grammY wrapper, WhatsApp qua Baileys, v.v.). Xem tài liệu cho moltbot connect telegram hoặc moltbot connect whatsapp.

Tôi điều khiển PC của mình qua Telegram bằng Moltbot như thế nào (từng bước)?

Dưới đây là hướng dẫn an toàn, thực tế để điều khiển host qua tin nhắn Telegram — hữu ích cho quản trị từ xa, chạy script, lấy log, hoặc yêu cầu Moltbot chạy một job nhỏ. Lưu ý bảo mật quan trọng: không để Gateway của bạn lộ ra Internet công cộng nếu không có token API và tường lửa; chỉ cho phép người dùng Telegram tin cậy nhắn cho bot của bạn.

1) Tạo bot Telegram với BotFather

1. Trong Telegram, nhắn cho @BotFather.
2. Gửi /newbot và làm theo hướng dẫn.
3. Sao chép token bot 123456789:ABC-... (BotFather sẽ hiển thị).

2) Thêm token vào gateway của bạn

Đặt biến môi trường hoặc cấu hình:

export TELEGRAM_BOT_TOKEN="123456789:ABC-..."
# hoặc thêm vào tệp cấu hình của gateway:
# channels:
#   telegram:
#     botToken: "123456789:ABC-..."

Bạn cũng có thể thêm token qua lệnh moltbot channels add hoặc moltbot configure tùy phiên bản CLI. Tài liệu Telegram cho thấy đường thiết lập nhanh này.

3) Chạy trình hướng dẫn onboarding và chọn Telegram

Chạy:

moltbot onboard --install-daemon

Trong trình hướng dẫn:

• Chọn nhà cung cấp mô hình (Anthropic Opus, OpenAI hoặc cục bộ).
• Khi được hỏi về kênh, chọn Telegram và dán token.
• Cấu hình ghép đôi/danh sách cho phép để hạn chế ai có thể nhắn cho bot (quan trọng — đặt ID người dùng của bạn để chỉ mình bạn có thể điều khiển).

Các walkthrough cộng đồng và quy trình onboarding sẽ yêu cầu bạn dán một đầu ra lệnh nhỏ từ host để chứng minh ghép đôi node — hãy làm theo prompt.

4) Bật công cụ exec và phê duyệt (an toàn)

Moltbot có thể chạy lệnh hệ thống qua công cụ exec, nhưng nó chạy theo mô hình phê duyệt rõ ràng:

• Phê duyệt exec được ghi trong ~/.clawdbot/exec-approvals.json.
• Hệ thống sẽ hỏi phê duyệt trong chat lần đầu khi hành động được yêu cầu; bạn có thể trả lời /approve để tiếp tục (hoặc từ chối).
• Với quy trình tự động hoàn toàn, bạn có thể tạo một allowlist giới hạn các lệnh hoặc một “bin” các script được phê duyệt sẵn.

Ví dụ: bật công cụ exec trong cấu hình moltbot (hoặc qua UI/plugin):

{
  "tools": {
    "exec": {
      "enabled": true,
      "allowlist": ["/usr/local/bin/backup.sh", "/usr/bin/uptime"]
    }
  }
}

Dự án có luồng phê duyệt exec rõ ràng và chuyển tiếp prompt phê duyệt tới các kênh chat khi được yêu cầu, giúp bạn dễ xem xét và phê duyệt thao tác.

5) Thử một lệnh an toàn từ Telegram

Từ tài khoản Telegram của bạn (người dùng được phép) gửi:

@YourMoltbot Hi — please run: uptime

Trợ lý sẽ:

1. Hỏi xác nhận (nếu exec cần phê duyệt).
2. Chạy lệnh được phép trên host.
3. Trả về đầu ra vào chat.

6) Tạo hành động an toàn hơn qua skills

Thay vì cho quyền truy cập shell trực tiếp qua chat, hãy ưu tiên skills đóng gói hành động (ví dụ skill backup gọi script và trả kết quả được định dạng đẹp). Skills có thể cài/gỡ và an toàn hơn để xem xét.

Tôi lưu trữ API Moltbot (Gateway) và dùng HTTP API như thế nào?

Moltbot có thể phục vụ API để chương trình khác gọi không?

Có. Gateway của Moltbot có thể mở các endpoint HTTP tương thích OpenResponses (như POST /v1/responses) và một shim kiểu OpenAI /v1/chat/completions. Các endpoint này bị vô hiệu hóa theo mặc định và phải được bật trong cấu hình gateway. Endpoint HTTP OpenResponses ánh xạ trực tiếp tới đường chạy tác nhân của gateway, vì vậy yêu cầu được thực thi như các phiên tác nhân thực (với cùng định tuyến/quyền).

API Proxy trong Moltbot là gì?

API proxy trong Moltbot là dịch vụ trung gian giữa runtime của tác nhân Moltbot và nhà cung cấp LLM thượng nguồn như:

• OpenAI
• Anthropic
• Venice
• Azure OpenAI
• Endpoint tự lưu trữ tương thích OpenAI

Thay vì Moltbot gọi trực tiếp nhà cung cấp, mọi yêu cầu đều đi qua proxy, proxy có thể:

• Viết lại yêu cầu và phản hồi
• Áp hạn mức (rate limit)
• Theo dõi dùng token và chi phí
• Chuyển mô hình động
• Che giấu khóa API thật khỏi Moltbot
• Thêm xác thực, logging và caching

Về mặt khái niệm:

Moltbot → API Proxy → LLM Provider

Kiến trúc này cải thiện đáng kể bảo mật, khả năng quan sát và kiểm soát chi phí.

🚀 Khởi động nhanh: Chúng tôi khuyến nghị dùng CometAPI (apiyi.com) để lấy khóa API của bạn. Đăng ký sẽ có tín dụng miễn phí. Nó hỗ trợ mọi thuật toán chính, như Claude Sonnet 4.5, Claude Opus 4.5 và GPT-5.2, và thường rẻ hơn giá chính thức 10–20%.

Bước 1: Lấy API Proxy Key của bạn

Phương pháp 1: Đặt biến môi trường. Trong tệp .env của Moltbot:

OPENAI_API_BASE=https://cometapi.com/v1
OPENAI_API_KEY=moltbot-internal-token
OPENAI_MODEL=gpt-4.1-mini

Điểm chính:

• OPENAI_API_BASE trỏ tới proxy của bạn, không phải OpenAI
• OPENAI_API_KEY là token do proxy cấp
• Proxy quyết định nhà cung cấp/mô hình thực sự được dùng

Khởi động lại Moltbot sau khi cập nhật các giá trị này.

Phương pháp 2: Cấu hình qua config.json:

• Tìm tệp cấu hình Moltbot
• Mở tệp cấu hình của bạn và thêm hoặc cập nhật models.providers

Tệp cấu hình thường nằm tại một trong các vị trí sau:

Bạn cũng có thể tìm bằng dòng lệnh:

# Xem cấu hình hiện tại của bạn
moltbot config list

# Lấy đường dẫn chính xác tới tệp cấu hình
moltbot config path

---

Bước 2: Xác minh kết nối

Chạy một prompt kiểm tra đơn giản:

moltbot test llm

Nếu cấu hình đúng, Moltbot sẽ nhận phản hồi bình thường — mà không bao giờ liên hệ trực tiếp nhà cung cấp thượng nguồn.

Ước tính chi phí chạy Moltbot dùng mô hình hosted

Chi phí dùng mô hình quản lý phụ thuộc vào giá API, vì vậy chọn nhà cung cấp API rẻ khá quan trọng, đó là lý do tôi khuyến nghị CometAPI.

Yếu tố định giá thường phụ thuộc vào:

• Giá nhà cung cấp. Chi phí dùng mô hình quản lý phụ thuộc vào giá API, vì vậy chọn nhà cung cấp API rẻ hơn là then chốt, đó là lý do tôi khuyến nghị CometAPI.
• Lựa chọn giữa mô hình đầu bảng hay nhẹ; ví dụ chênh lệch giá giữa Claude Opus 4.5 và GLM 4.7 khá lớn.
• Độ phức tạp nội dung được xử lý. Nếu workflow của bạn nặng văn bản (phân tích tệp, trả lời dài), cộng thêm token.

Ví dụ ước lượng (mang tính minh họa, giá tháng 1/2026 theo bài viết cộng đồng):

• Nhu cầu cá nhân thỉnh thoảng (vài trăm phản hồi/tháng, trộn mô hình cục bộ và cuộc gọi API rẻ): $0–$50/tháng.
• Nhu cầu cá nhân nặng/nhà phát triển chuyên (lập chỉ mục tệp, nhiều lời gọi công cụ): $100–$1,000/tháng.
• Đội hoặc sản xuất luôn bật (nhiều người dùng + web scraping + chaining): $1,000+/tháng trừ khi bạn tối ưu mạnh việc dùng mô hình.

Cách giảm chi phí

• Định tuyến mô hình: chuyển tác vụ nhẹ sang mô hình rẻ hoặc LLM cục bộ, dành mô hình đắt cho suy luận dài — thử nghiệm cộng đồng cho thấy có thể cắt chi phí ~50% trở lên.
• Relay & giá theo lô: dùng relay API có giá mỗi token tốt hơn hoặc hosting mô hình riêng (Venice, endpoint riêng).
• Caching & cắt gọn mạnh: cache đầu ra LLM, cắt ngắn lịch sử dài, và tóm tắt thay vì gửi lại toàn bộ ngữ cảnh.

Tính năng nâng cao của API Proxy cho Moltbot

Định tuyến mô hình theo loại tác vụ

Bạn có thể kiểm tra payload yêu cầu và định tuyến động:

function selectModel(messages) {
  const systemPrompt = messages[0]?.content || "";
  if (systemPrompt.includes("shell") || systemPrompt.includes("automation")) {
    return "gpt-4.1";
  }
  return "gpt-4.1-mini";
}

Mẫu này giảm chi phí mà không hy sinh chất lượng.

---

Giới hạn token và chi phí

Bạn có thể áp giới hạn cứng:

if (req.body.max_tokens > 2000) {
  return res.status(400).json({
    error: "Vượt quá giới hạn token"
  });
}

Một số đội cũng theo dõi mức dùng tích lũy theo ID người dùng Moltbot.

---

Có an toàn không khi cấp quyền shell cho AI trên máy tính của tôi?

Đây là câu hỏi quan trọng nhất với bất kỳ người dùng Moltbot nào. Trao cho LLM khả năng chạy rm -rf vốn dĩ rủi ro. Moltbot có nhiều hàng rào để giảm thiểu:

1. Sandboxing: Bạn có thể chạy Moltbot bên trong Docker container. Điều này giới hạn “thế giới” của tác nhân vào một thư mục cụ thể, ngăn nó chạm vào tệp hệ thống của bạn.
2. Phê duyệt rõ ràng: Theo mặc định, “Main Sessions” (chat trực tiếp với bạn) có độ tin cậy cao hơn, nhưng bạn có thể cấu hình bot yêu cầu phép trước khi chạy bất kỳ lệnh shell phá hủy nào.
3. Bảo vệ bằng mật khẩu: Nếu bạn mở Web UI của Moltbot, luôn bật xác thực mật khẩu trong config.json:

{
  "gateway": {
    "auth": {
      "mode": "password",
      "password": "YOUR_STRONG_SECURE_PASSWORD"
    }
  }
}

Lời kết:

Moltbot không chỉ là chatbot; nó là hạ tầng cho một nhân viên số cá nhân. Bằng cách tự lưu trữ, bạn lấy lại quyền kiểm soát dữ liệu đồng thời có năng suất của một AI không bao giờ ngủ. Dù bạn dùng nó để quản lý lịch qua Telegram hay tự động hóa pipeline devops từ ghế sofa, Moltbot là thoáng nhìn về tương lai nơi ai cũng có “Jarvis” của riêng mình chạy trên một Mac Mini ở góc phòng.

Nếu bạn muốn một nền tảng API với nhiều mô hình từ nhiều nhà cung cấp (như Chatgpt-5.2, Claude opus 4.5, v.v.) có giá thấp hơn chính thức, thì CometAPI là lựa chọn tốt nhất. Để bắt đầu, hãy khám phá khả năng của mô hình trong Playground và tham khảo API guide để có hướng dẫn chi tiết. Trước khi truy cập, hãy đảm bảo bạn đã đăng nhập CometAPI và lấy khóa API. CometAPI cung cấp mức giá thấp hơn nhiều so với giá chính thức để giúp bạn tích hợp.

Sẵn sàng khởi động? → Đăng ký CometAPI ngay hôm nay!

Nếu bạn muốn biết thêm mẹo, hướng dẫn và tin tức về AI, hãy theo dõi chúng tôi trên VK, X và Discord!