Mục tiêu

Một mục tiêu là một mục đích bền vững gắn với phiên OpenClaw hiện tại. Nó cung cấp cho tác nhân và người vận hành một đích chung cho công việc dài hạn, mà không biến đích đó thành tác vụ nền, lời nhắc, Cron job hoặc chỉ thị thường trực.

Mục tiêu là trạng thái phiên. Chúng di chuyển cùng khóa phiên, tồn tại qua các lần khởi động lại tiến trình, xuất hiện trong /goal, khả dụng cho mô hình thông qua các công cụ mục tiêu, và xuất hiện ở chân trang TUI khi phiên đang hoạt động có mục tiêu.

Bắt đầu nhanh

Đặt mục tiêu:

/goal start get CI green for PR 87469 and push the fix

Kiểm tra mục tiêu:

/goal

Tạm dừng khi công việc đang cố ý chờ:

/goal pause waiting for CI

Tiếp tục mục tiêu:

/goal resume

Đánh dấu hoàn tất:

/goal complete pushed and verified

Xóa mục tiêu:

/goal clear

Mục tiêu dùng để làm gì

Dùng mục tiêu khi một phiên có kết quả cụ thể cần luôn hiển thị qua nhiều lượt tương tác:

• Hoàn tất PR: sửa, xác minh, autoreview, đẩy lên, và mở hoặc cập nhật PR.
• Lượt gỡ lỗi: tái hiện lỗi, xác định bề mặt sở hữu, vá, và chứng minh bản sửa.
• Lượt xử lý tài liệu: đọc tài liệu liên quan, viết trang mới, liên kết chéo, và xác minh bản dựng tài liệu.
• Tác vụ bảo trì: kiểm tra trạng thái hiện tại, thực hiện các thay đổi có giới hạn, chạy các kiểm tra phù hợp, và báo cáo những gì đã thay đổi.

Mục tiêu không phải là hàng đợi tác vụ. Dùng Luồng tác vụ, tác vụ, Cron jobs, hoặc chỉ thị thường trực khi công việc cần chạy tách rời, lặp lại theo lịch, phân nhánh thành công việc con được quản lý, hoặc tồn tại như một chính sách.

Tham chiếu lệnh

/goal không có đối số sẽ in bản tóm tắt mục tiêu hiện tại:

GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal pause, /goal complete, /goal clear

Lệnh:

• /goal hoặc /goal status hiển thị mục tiêu hiện tại.
• /goal start <objective> tạo mục tiêu mới cho phiên hiện tại.
• /goal set <objective> và /goal create <objective> là bí danh cho start.
• /goal pause [note] tạm dừng một mục tiêu đang hoạt động.
• /goal resume [note] tiếp tục một mục tiêu đang tạm dừng, bị chặn, bị giới hạn theo mức dùng, hoặc bị giới hạn theo ngân sách.
• /goal complete [note] đánh dấu mục tiêu đã đạt được.
• /goal done [note] là bí danh cho complete.
• /goal block [note] đánh dấu mục tiêu bị chặn.
• /goal blocked [note] là bí danh cho block.
• /goal clear xóa mục tiêu khỏi phiên.

Mỗi phiên chỉ có thể có một mục tiêu tại một thời điểm. Việc bắt đầu mục tiêu thứ hai sẽ thất bại cho đến khi mục tiêu hiện tại được xóa.

Trạng thái

Mục tiêu dùng một tập trạng thái nhỏ:

• active: phiên đang theo đuổi mục tiêu.
• paused: người vận hành đã tạm dừng mục tiêu; /goal resume đưa mục tiêu hoạt động lại.
• blocked: tác nhân hoặc người vận hành đã báo cáo một điểm chặn thực sự; /goal resume đưa mục tiêu hoạt động lại khi có thông tin hoặc trạng thái mới.
• budget_limited: đã đạt ngân sách token đã cấu hình; /goal resume bắt đầu lại việc theo đuổi từ cùng mục đích.
• usage_limited: dành riêng cho các trạng thái dừng do giới hạn mức dùng; /goal resume bắt đầu lại việc theo đuổi khi được phép.
• complete: mục tiêu đã đạt được. Mục tiêu hoàn tất là trạng thái kết thúc; dùng /goal clear trước khi bắt đầu mục tiêu khác.

/new và /reset xóa mục tiêu của phiên hiện tại vì chúng cố ý bắt đầu ngữ cảnh phiên mới.

Ngân sách token

Mục tiêu có thể có ngân sách token dương tùy chọn. Ngân sách được lưu cùng mục tiêu và được đo từ số token mới của phiên tại thời điểm tạo. Nếu phiên hiện tại chỉ có mức dùng token cũ hoặc không xác định khi mục tiêu bắt đầu, OpenClaw sẽ chờ ảnh chụp nhanh token phiên mới tiếp theo và dùng ảnh đó làm đường cơ sở, vì vậy token đã dùng trước khi mục tiêu tồn tại sẽ không bị tính vào mục tiêu.

Khi mức dùng token đạt ngân sách, mục tiêu chuyển thành budget_limited. Điều này không xóa mục tiêu hoặc xóa mục đích. Nó cho người vận hành và tác nhân biết rằng mục tiêu không còn được chủ động theo đuổi cho đến khi được tiếp tục hoặc xóa.

Ngân sách token là lan can bảo vệ cho mục tiêu phiên, không phải giới hạn thanh toán. Hạn mức nhà cung cấp, báo cáo chi phí, và hành vi cửa sổ ngữ cảnh vẫn dùng các điều khiển mức dùng và mô hình OpenClaw thông thường.

Công cụ mô hình

OpenClaw cung cấp ba công cụ mục tiêu lõi cho các harness tác nhân:

• get_goal: đọc mục tiêu phiên hiện tại, bao gồm trạng thái, mục đích, mức dùng token, và ngân sách token.
• create_goal: chỉ tạo mục tiêu khi chỉ dẫn của người dùng, hệ thống, hoặc nhà phát triển yêu cầu rõ ràng. Công cụ này thất bại nếu phiên đã có mục tiêu.
• update_goal: đánh dấu mục tiêu là complete hoặc blocked.

Mô hình không thể âm thầm tạm dừng, tiếp tục, xóa, hoặc thay thế mục tiêu. Đó là các điều khiển của người vận hành/phiên thông qua /goal và các lệnh đặt lại. Điều này ngăn tác nhân lặng lẽ dịch chuyển đích trong khi vẫn giữ một đường dẫn sạch để tác nhân báo cáo việc hoàn thành hoặc một điểm chặn thật sự.

Công cụ update_goal chỉ nên đánh dấu mục tiêu là complete khi mục đích thực sự đã đạt được. Công cụ này chỉ nên đánh dấu mục tiêu là blocked khi cùng điều kiện chặn đã lặp lại và tác nhân không thể đạt tiến triển có ý nghĩa nếu không có đầu vào mới từ người dùng hoặc thay đổi trạng thái bên ngoài.

TUI

TUI giữ mục tiêu của phiên đang hoạt động luôn hiển thị ở chân trang cạnh tác nhân, phiên, mô hình, điều khiển lượt chạy, và số token.

Ví dụ chân trang:

• Pursuing goal (12k/50k) cho một mục tiêu đang hoạt động có ngân sách token.
• Goal paused (/goal resume) cho một mục tiêu đang tạm dừng.
• Goal blocked (/goal resume) cho một mục tiêu bị chặn.
• Goal hit usage limits (/goal resume) cho một mục tiêu bị giới hạn theo mức dùng.
• Goal unmet (50k/50k) cho một mục tiêu bị giới hạn theo ngân sách.
• Goal achieved (42k) cho một mục tiêu đã hoàn tất.

Chân trang được chủ ý giữ gọn. Dùng /goal để xem đầy đủ mục đích, ghi chú, ngân sách token, và các lệnh khả dụng.

Hành vi kênh

Lệnh /goal hoạt động trong các phiên OpenClaw có khả năng dùng lệnh, bao gồm TUI và các bề mặt trò chuyện cho phép lệnh văn bản. Trạng thái mục tiêu được gắn với khóa phiên, không phải phương tiện truyền tải. Nếu hai bề mặt dùng cùng phiên, chúng thấy cùng một mục tiêu.

Trạng thái mục tiêu không phải là chỉ thị phân phối. Nó không ép phản hồi đi qua một kênh, thay đổi hành vi hàng đợi, phê duyệt công cụ, hoặc lên lịch công việc.

Khắc phục sự cố

Goal error: goal already exists nghĩa là phiên đã có mục tiêu. Dùng /goal để kiểm tra, /goal complete nếu mục tiêu đã xong, hoặc /goal clear trước khi bắt đầu một mục đích khác.

Goal error: goal not found nghĩa là phiên chưa có mục tiêu. Bắt đầu mục tiêu bằng /goal start <objective>.

Goal error: goal is already complete nghĩa là mục tiêu đã ở trạng thái kết thúc. Xóa mục tiêu trước khi bắt đầu hoặc tiếp tục mục đích khác.

Nếu mức dùng token trông như 0 hoặc đã cũ, phiên đang hoạt động có thể chưa có ảnh chụp nhanh token mới. Mức dùng sẽ được làm mới khi OpenClaw ghi nhận mức dùng phiên và tổng số suy ra từ bản ghi hội thoại.

Liên quan

• Lệnh slash
• TUI
• Công cụ phiên
• Compaction
• Luồng tác vụ
• Chỉ thị thường trực