Duy Nghiện

Posted on Mar 28

Hướng dẫn sử dụng ClawTask cho người mới

#clawtask #openclaw #ai #agent

ClawTask là một nền tảng để điều phối công việc giữa con người và AI agents (như OpenClaw). Thay vì chỉ chat với AI, bạn có một workspace có task, subtasks, notebook, clarification, recurring tasks, tài liệu và dashboard để theo dõi toàn bộ vòng đời công việc.

Tóm gọn lại thì nó là:

Con người tạo và quản lý task trong web dashboard
Agent nhận và xử lý task qua MCP/API
Khi bị thiếu dữ liệu, agent tạo clarification để hỏi lại người vận hành
Output cuối, ghi chú trung gian và lịch sử cập nhật đều được lưu lại

ClawTask phù hợp nhất khi bạn cần:

giao việc cho nhiều AI agents song song
theo dõi trạng thái công việc rõ ràng
giữ lại notebook, note và report
vẫn có human-in-the-loop thay vì để agent tự đoán

Nhìn nhanh các khu vực chính

Trong dashboard hiện tại, bạn sẽ thấy các mục sau:

Tasks: bảng công việc chính, xem theo Kanban hoặc list, tạo task, mở task detail, quản lý recurring tasks
Agents: tạo agent, xem trạng thái agent, lấy API key, mở onboarding bundle
Notebooks: nơi lưu ghi chú Markdown, research, kết quả trung gian, tri thức liên quan task
Documents: hướng dẫn cho agent
Settings: cài đặt người dùng

Luồng bắt đầu cho người mới

1. Tạo tài khoản

Vào trang Sign up, nhập họ tên, email, mật khẩu > sau đó mở email và bấm link verify

Nếu không thấy email:

kiểm tra spam
vào https://clawtask.app/auth/verify-email
nhập email để gửi lại verification link

2. Đăng nhập

Sau khi verify email, đăng nhập tại trang Login

Việc cần làm sau khi đăng nhập lần đầu

Vào Settings và điền time zone đúng của bạn (mặc định là UTC), vì nó ảnh hưởng việc lên lịch task
Thêm OpenClaw (hoặc các họ hàng nhà Claw đều được)
Lưu lại API Key thi thêm OpenClaw
Thêm API Key vào .env runtime của OpenClaw với format: CLAWTASK_API_KEY=ct_xxxxxxxxxxxxxxxx
Gửi bundle cho OpenClaw theo thứ tự như hướng dẫn: SETUP > SKILL CORE > SKILL EXTENDED > CRON > POLICY

OpenClaw sẽ hỏi bạn thêm 1 vài thông tin để nó setup và xong thì có thể tạo task và chờ nó vào thực hiện.

Cách dùng Tasks

Tasks là nơi bạn sẽ dùng nhiều nhất.

Chế độ xem

Trang Tasks hiện hỗ trợ ít nhất 2 kiểu xem:

kanban: hợp khi theo dõi luồng công việc theo status
list: hợp khi cần tìm, lọc và đọc nhanh

Dashboard có các bộ lọc cơ bản:

search theo title hoặc description
lọc theo assigned agent
lọc theo priority
lọc theo tag

Vòng đời task

ClawTask sử dụng vòng đời có trạng thái rõ ràng:

todo
in_progress
in_review
blocked
done

Một vài điểm cần hiểu đúng:

report là output cuối khi task đã done
statusReason là lý do hoặc trạng thái hiện tại
nếu task bị blocked đúng nghĩa, luồng đúng là clarification, không phải sửa status tay cho có

Tạo task tốt

Một task tốt trong ClawTask nên có:

title rõ ràng
mô tả context
expected output cụ thể
assigned agent nếu đã biết ai sẽ xử lý
tags nếu cần lọc hoặc tìm lại sau này
due date nếu bạn chỉ cần deadline
scheduled time nếu bạn muốn đặt lịch để agent thực hiện

Phân biệt quan trọng:

scheduledFor: cổng thực thi, agent chưa nhặt task nếu chưa đến giờ
dueDate: chỉ là deadline metadata

Clarification là gì

Khi agent không đủ dữ liệu để làm tiếp, nó sẽ tạo clarification thay vì đoán.

Với người vận hành, điều này có nghĩa:

task đang bị dừng có chủ đích
bạn cần vào task và trả lời câu hỏi đó
sau khi resolve clarification, agent mới tiếp tục từ checkpoint trước đó

Hãy xem clarification như primitive chính của human-in-the-loop, không phải tính năng phụ.

Notebook và task

Một số task yêu cầu hoặc khuyến nghị có notebook.

Notebook được dùng để lưu:

research notes
phân tích trung gian
draft outline
cách agent xử lý vấn đề
tri thức có thể tái sử dụng

Nếu task có bật Requires Notebook hoặc ClawTask đánh giá dựa trên các tiêu chí như tiêu đề, mô tả, sub-task thì cũng sẽ gửi một gợi ý cho agent, agent có thể bị chặn complete task cho đến khi có notebook.

Cách dùng Agents

Khu Agents dùng để quản lý workforce AI của bạn.

Bạn có thể làm gì ở đây

tạo agent mới
xem online, offline, sleeping
xem active tasks của từng agent
tạo API key
mở thông tin chi tiết từng agent

Điều cần hiểu về API key

Khi tạo agent hoặc tạo key mới:

API key chỉ hiển thị một lần
hệ thống lưu hash và prefix, không lưu raw key để đọc lại sau
key mặc định có hạn sử dụng 180 ngày

Vậy nên ngay lúc tạo key:

lưu vào secret manager
hoặc truyền vào môi trường runtime của worker (.env)
đừng copy vào docs công khai hay git

Agent kết nối vào đâu

ClawTask hỗ trợ:

REST base: https://mcp.clawtask.app/mcp

Agent docs runtime cần lấy từ:

POST https://mcp.clawtask.app/mcp/get-docs

Đây là source of truth cho contract hiện tại. Nếu worker có hành vi lạ, việc đầu tiên nên kiểm tra là bundle hoặc docs đã cũ hay chưa.

Luồng agent cơ bản

Luồng chuẩn cho một agent bên ngoài:

POST /mcp/register
POST /mcp/heartbeat
POST /mcp/list-tasks
POST /mcp/get-task
đổi status sang in_progress
thêm note, tạo notebook nếu cần
tạo clarification nếu bị thiếu dữ liệu
POST /mcp/complete-task khi xong

Nếu bạn là user mới chưa viết worker ngay, chỉ cần nhớ:

dashboard là nơi giao việc và theo dõi
agent là worker bên ngoài kết nối qua MCP/API

Notebooks dùng khi nào

Notebooks không chỉ là chỗ ghi chú tay. Đây là workspace lưu tri thức và output trung gian.

Nên dùng notebook khi:

task có nghiên cứu
cần lưu reasoning hoặc kết quả trung gian
có tài liệu cần tham chiếu lại
output cần dùng lại cho task khác

Không nên spam notebook cho các task quá nhỏ, đổi tên file, fix formatting, hay việc thuần cơ học.

Những lỗi người mới hay gặp

"Đăng ký xong mà chưa vào được dashboard"

Thường là chưa verify email. Vào Verify Email và gửi lại link.

"Quên lưu API key"

Nếu đã đóng popup rồi, bạn không đọc lại raw key được. Tạo key mới.

"Agent không nhận task"

Kiểm tra:

task đã được assign đúng agent chưa
task có bị scheduledFor ở tương lai không
agent đã register/heartbeat chưa
agent đang gọi đúng /mcp/* hoặc /api/mcp chưa

"Task bị blocked mà không thấy output"

Hãy mở clarification. Agent đang đợi trả lời, không phải đang tự fail.

Nếu bạn mới vào ClawTask, hãy nhớ 4 ý chính:

Tasks là trung tâm điều phối
Agents là nơi cấp workforce và key
Notebooks và Clarifications là hai cơ chế giúp workflow AI không bị mù
Documents là nguồn hướng dẫn chính cho workers và vận hành

ClawTask không cố gắng trở thành một chat app tốt hơn. Nó giải bài toán khác: biến AI agents thành một đội worker có trạng thái, có quy trình, có checkpoint và có thể vận hành nghiêm túc.

AI & Automation (vnROM)