Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Các lệnh được Gateway xử lý. Hầu hết lệnh phải được gửi dưới dạng một tin nhắn độc lập bắt đầu bằng /. Lệnh trò chuyện bash chỉ dành cho host dùng ! <cmd> (với /bash <cmd> làm bí danh). Khi một cuộc hội thoại hoặc luồng được liên kết với một phiên ACP, văn bản theo dõi thông thường sẽ được định tuyến tới ACP harness đó. Các lệnh quản lý Gateway vẫn ở cục bộ: /acp ... luôn tới trình xử lý lệnh ACP của OpenClaw, và /status cùng /unfocus vẫn ở cục bộ bất cứ khi nào xử lý lệnh được bật cho bề mặt đó. Có hai hệ thống liên quan:
Các tin nhắn /... độc lập.
/think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue.
  • Chỉ thị được loại khỏi tin nhắn trước khi mô hình nhìn thấy.
  • Trong tin nhắn trò chuyện thông thường (không phải chỉ có chỉ thị), chúng được xử lý như “gợi ý nội dòng” và không duy trì cài đặt phiên.
  • Trong tin nhắn chỉ có chỉ thị (tin nhắn chỉ chứa các chỉ thị), chúng được duy trì vào phiên và trả lời bằng một xác nhận.
  • Chỉ thị chỉ được áp dụng cho người gửi được ủy quyền. Nếu commands.allowFrom được đặt, đó là danh sách cho phép duy nhất được dùng; nếu không, ủy quyền đến từ danh sách cho phép/ghép nối kênh cộng với commands.useAccessGroups. Người gửi không được ủy quyền sẽ thấy chỉ thị được xử lý như văn bản thuần.
Chỉ dành cho người gửi trong danh sách cho phép/được ủy quyền: /help, /commands, /status, /whoami (/id).Chúng chạy ngay lập tức, được loại khỏi tin nhắn trước khi mô hình nhìn thấy, và phần văn bản còn lại tiếp tục qua luồng bình thường.

Cấu hình

{
  commands: {
    native: "auto",
    nativeSkills: "auto",
    text: true,
    bash: false,
    bashForegroundMs: 2000,
    config: false,
    mcp: false,
    plugins: false,
    debug: false,
    restart: true,
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw",
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}
commands.text
boolean
mặc định:"true"
Bật phân tích cú pháp /... trong tin nhắn trò chuyện. Trên các bề mặt không có lệnh native (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), lệnh văn bản vẫn hoạt động ngay cả khi bạn đặt giá trị này thành false.
commands.native
boolean | "auto"
mặc định:"\"auto\""
Đăng ký lệnh native. Tự động: bật cho Discord/Telegram; tắt cho Slack (cho đến khi bạn thêm slash commands); bị bỏ qua đối với các nhà cung cấp không hỗ trợ native. Đặt channels.discord.commands.native, channels.telegram.commands.native, hoặc channels.slack.commands.native để ghi đè theo từng nhà cung cấp (bool hoặc "auto"). false xóa các lệnh đã đăng ký trước đó trên Discord/Telegram khi khởi động. Lệnh Slack được quản lý trong ứng dụng Slack và không bị xóa tự động.
commands.nativeSkills
boolean | "auto"
mặc định:"\"auto\""
Đăng ký các lệnh skill theo native khi được hỗ trợ. Tự động: bật cho Discord/Telegram; tắt cho Slack (Slack yêu cầu tạo một slash command cho mỗi skill). Đặt channels.discord.commands.nativeSkills, channels.telegram.commands.nativeSkills, hoặc channels.slack.commands.nativeSkills để ghi đè theo từng nhà cung cấp (bool hoặc "auto").
commands.bash
boolean
mặc định:"false"
Bật ! <cmd> để chạy các lệnh shell của host (/bash <cmd> là bí danh; yêu cầu danh sách cho phép tools.elevated).
commands.bashForegroundMs
number
mặc định:"2000"
Kiểm soát bash chờ bao lâu trước khi chuyển sang chế độ nền (0 đưa xuống nền ngay lập tức).
commands.config
boolean
mặc định:"false"
Bật /config (đọc/ghi openclaw.json).
commands.mcp
boolean
mặc định:"false"
Bật /mcp (đọc/ghi cấu hình MCP do OpenClaw quản lý dưới mcp.servers).
commands.plugins
boolean
mặc định:"false"
Bật /plugins (khám phá/trạng thái plugin cùng các điều khiển cài đặt + bật/tắt).
commands.debug
boolean
mặc định:"false"
Bật /debug (các ghi đè chỉ trong runtime).
commands.restart
boolean
mặc định:"true"
Bật /restart cùng các hành động công cụ khởi động lại gateway.
commands.ownerAllowFrom
string[]
Đặt danh sách cho phép owner rõ ràng cho các bề mặt lệnh/công cụ chỉ dành cho owner. Đây là tài khoản người vận hành có thể phê duyệt các hành động nguy hiểm và chạy các lệnh như /diagnostics, /export-trajectory, và /config. Nó tách biệt với commands.allowFrom và quyền truy cập ghép nối DM.
channels.<channel>.commands.enforceOwnerForCommands
boolean
mặc định:"false"
Theo kênh: khiến các lệnh chỉ dành cho owner yêu cầu danh tính owner để chạy trên bề mặt đó. Khi là true, người gửi phải khớp với một ứng viên owner đã phân giải (ví dụ một mục trong commands.ownerAllowFrom hoặc metadata owner native của nhà cung cấp) hoặc có scope nội bộ operator.admin trên kênh tin nhắn nội bộ. Một mục wildcard trong allowFrom của kênh, hoặc danh sách ứng viên owner rỗng/chưa phân giải, là không đủ — các lệnh chỉ dành cho owner sẽ fail closed trên kênh đó. Hãy để tùy chọn này tắt nếu bạn muốn các lệnh chỉ dành cho owner chỉ được chặn bởi ownerAllowFrom và danh sách cho phép lệnh tiêu chuẩn.
commands.ownerDisplay
"raw" | "hash"
Kiểm soát cách id owner xuất hiện trong system prompt.
commands.ownerDisplaySecret
string
Tùy chọn đặt HMAC secret được dùng khi commands.ownerDisplay="hash".
commands.allowFrom
object
Danh sách cho phép theo nhà cung cấp để ủy quyền lệnh. Khi được cấu hình, đây là nguồn ủy quyền duy nhất cho lệnh và chỉ thị (danh sách cho phép/ghép nối kênh và commands.useAccessGroups bị bỏ qua). Dùng "*" cho mặc định toàn cục; các khóa riêng theo nhà cung cấp sẽ ghi đè nó.
commands.useAccessGroups
boolean
mặc định:"true"
Thực thi danh sách cho phép/chính sách cho lệnh khi commands.allowFrom chưa được đặt.

Danh sách lệnh

Nguồn chân lý hiện tại:
  • các lệnh tích hợp sẵn của core đến từ src/auto-reply/commands-registry.shared.ts
  • các lệnh dock được tạo đến từ src/auto-reply/commands-registry.data.ts
  • lệnh plugin đến từ các lệnh gọi registerCommand() của plugin
  • tính khả dụng thực tế trên gateway của bạn vẫn phụ thuộc vào cờ cấu hình, bề mặt kênh, và các plugin đã cài đặt/bật

Lệnh tích hợp sẵn của core

  • /new [model] bắt đầu một phiên mới; /reset là bí danh đặt lại.
  • /reset soft [message] giữ transcript hiện tại, bỏ các id phiên backend CLI được tái sử dụng, và chạy lại việc tải startup/system-prompt tại chỗ.
  • /compact [instructions] nén ngữ cảnh phiên. Xem Compaction.
  • /stop hủy lượt chạy hiện tại.
  • /session idle <duration|off>/session max-age <duration|off> quản lý hết hạn liên kết luồng.
  • /export-session [path] xuất phiên hiện tại sang HTML. Bí danh: /export.
  • /export-trajectory [path] yêu cầu phê duyệt exec, sau đó xuất một gói trajectory JSONL cho phiên hiện tại. Dùng nó khi bạn cần timeline prompt, công cụ, và transcript cho một phiên OpenClaw. Trong trò chuyện nhóm, lời nhắc phê duyệt và kết quả xuất được gửi riêng cho owner. Bí danh: /trajectory.
  • /think <level> đặt mức suy nghĩ. Các tùy chọn đến từ hồ sơ nhà cung cấp của mô hình đang hoạt động; các mức phổ biến là off, minimal, low, medium, và high, với các mức tùy chỉnh như xhigh, adaptive, max, hoặc nhị phân on chỉ ở nơi được hỗ trợ. Bí danh: /thinking, /t.
  • /verbose on|off|full bật/tắt đầu ra verbose. Bí danh: /v.
  • /trace on|off bật/tắt đầu ra trace plugin cho phiên hiện tại.
  • /fast [status|on|off] hiển thị hoặc đặt chế độ nhanh.
  • /reasoning [on|off|stream] bật/tắt khả năng hiển thị reasoning. Bí danh: /reason.
  • /elevated [on|off|ask|full] bật/tắt chế độ elevated. Bí danh: /elev.
  • /exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id> hiển thị hoặc đặt mặc định exec.
  • /model [name|#|status] hiển thị hoặc đặt mô hình.
  • /models [provider] [page] [limit=<n>|size=<n>|all] liệt kê các nhà cung cấp hoặc mô hình đã cấu hình/có auth cho một nhà cung cấp; thêm all để duyệt toàn bộ catalog của nhà cung cấp đó.
  • /queue <mode> quản lý hành vi hàng đợi (steer, followup, collect, steer-backlog, interrupt) cùng các tùy chọn như debounce:0.5s cap:25 drop:summarize; /queue default hoặc /queue reset xóa ghi đè phiên. Xem Hàng đợi lệnh.
  • /help hiển thị tóm tắt trợ giúp ngắn.
  • /commands hiển thị catalog lệnh được tạo.
  • /tools [compact|verbose] hiển thị agent hiện tại có thể dùng gì ngay bây giờ.
  • /status hiển thị trạng thái thực thi/runtime, bao gồm nhãn Execution/Runtime và mức sử dụng/hạn mức nhà cung cấp khi có.
  • /diagnostics [note] là luồng báo cáo hỗ trợ chỉ dành cho owner cho lỗi Gateway và các lượt chạy Codex harness. Nó yêu cầu phê duyệt exec rõ ràng mỗi lần trước khi chạy openclaw gateway diagnostics export --json; không phê duyệt diagnostics bằng quy tắc cho phép tất cả. Sau khi phê duyệt, nó gửi một báo cáo có thể dán với đường dẫn gói cục bộ, tóm tắt manifest, ghi chú quyền riêng tư, và các id phiên liên quan. Trong trò chuyện nhóm, lời nhắc phê duyệt và báo cáo được gửi riêng cho owner. Khi phiên đang hoạt động dùng OpenAI Codex harness, cùng phê duyệt đó cũng gửi phản hồi Codex liên quan tới máy chủ OpenAI và phản hồi hoàn tất liệt kê các id phiên OpenClaw, id luồng Codex, và các lệnh codex resume <thread-id>. Xem Xuất Diagnostics.
  • /crestodian <request> chạy trình trợ giúp thiết lập và sửa chữa Crestodian từ DM của owner.
  • /tasks liệt kê các tác vụ nền đang hoạt động/gần đây cho phiên hiện tại.
  • /context [list|detail|json] giải thích cách ngữ cảnh được lắp ghép.
  • /whoami hiển thị id người gửi của bạn. Bí danh: /id.
  • /usage off|tokens|full|cost kiểm soát chân trang mức sử dụng trên mỗi phản hồi hoặc in tóm tắt chi phí cục bộ.
  • /skill <name> [input] chạy một skill theo tên.
  • /allowlist [list|add|remove] ... quản lý các mục trong danh sách cho phép. Chỉ văn bản.
  • /approve <id> <decision> xử lý lời nhắc phê duyệt exec.
  • /btw <question> đặt một câu hỏi phụ mà không thay đổi ngữ cảnh phiên trong tương lai. Xem BTW.
  • /subagents list|kill|log|info|send|steer|spawn quản lý các lượt chạy sub-agent cho phiên hiện tại.
  • /acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help quản lý các phiên ACP và tùy chọn runtime.
  • /focus <target> liên kết luồng Discord hiện tại hoặc chủ đề/cuộc hội thoại Telegram với một mục tiêu phiên.
  • /unfocus xóa liên kết hiện tại.
  • /agents liệt kê các agent đã liên kết với luồng cho phiên hiện tại.
  • /kill <id|#|all> hủy một hoặc tất cả sub-agent đang chạy.
  • /steer <id|#> <message> gửi điều hướng tới một sub-agent đang chạy. Bí danh: /tell.
  • /config show|get|set|unset đọc hoặc ghi openclaw.json. Chỉ dành cho chủ sở hữu. Yêu cầu commands.config: true.
  • /mcp show|get|set|unset đọc hoặc ghi cấu hình máy chủ MCP do OpenClaw quản lý dưới mcp.servers. Chỉ dành cho chủ sở hữu. Yêu cầu commands.mcp: true.
  • /plugins list|inspect|show|get|install|enable|disable kiểm tra hoặc thay đổi trạng thái Plugin. /plugin là bí danh. Các thao tác ghi chỉ dành cho chủ sở hữu. Yêu cầu commands.plugins: true.
  • /debug show|set|unset|reset quản lý các ghi đè cấu hình chỉ dành cho thời gian chạy. Chỉ dành cho chủ sở hữu. Yêu cầu commands.debug: true.
  • /restart khởi động lại OpenClaw khi được bật. Mặc định: bật; đặt commands.restart: false để tắt.
  • /send on|off|inherit đặt chính sách gửi. Chỉ dành cho chủ sở hữu.
  • /tts on|off|status|chat|latest|provider|limit|summary|audio|help điều khiển TTS. Xem TTS.
  • /activation mention|always đặt chế độ kích hoạt nhóm.
  • /bash <command> chạy một lệnh shell trên máy chủ. Chỉ văn bản. Bí danh: ! <command>. Yêu cầu commands.bash: true cộng với danh sách cho phép tools.elevated.
  • !poll [sessionId] kiểm tra một tác vụ bash nền.
  • !stop [sessionId] dừng một tác vụ bash nền.

Các lệnh neo được tạo

Các lệnh neo chuyển tuyến trả lời của phiên hiện tại sang một kênh đã liên kết khác. Xem Neo kênh để biết cách thiết lập, ví dụ và khắc phục sự cố. Các lệnh neo được tạo từ Plugin kênh có hỗ trợ lệnh gốc. Bộ tích hợp hiện tại:
  • /dock-discord (bí danh: /dock_discord)
  • /dock-mattermost (bí danh: /dock_mattermost)
  • /dock-slack (bí danh: /dock_slack)
  • /dock-telegram (bí danh: /dock_telegram)
Dùng các lệnh neo từ cuộc trò chuyện trực tiếp để chuyển tuyến trả lời của phiên hiện tại sang một kênh đã liên kết khác. Tác tử giữ nguyên ngữ cảnh phiên, nhưng các trả lời sau này cho phiên đó sẽ được gửi đến đối tác kênh đã chọn. Các lệnh neo yêu cầu session.identityLinks. Người gửi nguồn và đối tác đích phải ở trong cùng một nhóm danh tính, ví dụ ["telegram:123", "discord:456"]. Nếu một người dùng Telegram có id 123 gửi /dock_discord, OpenClaw lưu lastChannel: "discord"lastTo: "456" trên phiên đang hoạt động. Nếu người gửi chưa được liên kết với một đối tác Discord, lệnh sẽ trả lời bằng gợi ý thiết lập thay vì chuyển tiếp sang cuộc trò chuyện thông thường. Việc neo chỉ thay đổi tuyến phiên đang hoạt động. Nó không tạo tài khoản kênh, cấp quyền truy cập, bỏ qua danh sách cho phép của kênh, hoặc chuyển lịch sử bản ghi sang phiên khác. Dùng /dock-telegram, /dock-slack, /dock-mattermost, hoặc một lệnh neo được tạo khác để chuyển tuyến lần nữa.

Các lệnh Plugin tích hợp

Các Plugin tích hợp có thể thêm nhiều lệnh gạch chéo hơn. Các lệnh tích hợp hiện tại trong repo này:
  • /dreaming [on|off|status|help] bật/tắt Dreaming bộ nhớ. Xem Dreaming.
  • /pair [qr|status|pending|approve|cleanup|notify] quản lý luồng ghép nối/thiết lập thiết bị. Xem Ghép nối.
  • /phone status|arm <camera|screen|writes|all> [duration]|disarm tạm thời kích hoạt các lệnh nút điện thoại rủi ro cao.
  • /voice status|list [limit]|set <voiceId|name> quản lý cấu hình giọng nói Talk. Trên Discord, tên lệnh gốc là /talkvoice.
  • /card ... gửi các mẫu thẻ phong phú LINE. Xem LINE.
  • /codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills kiểm tra và điều khiển bộ khung máy chủ ứng dụng Codex tích hợp. Xem Bộ khung Codex.
  • Các lệnh chỉ dành cho QQBot:
    • /bot-ping
    • /bot-version
    • /bot-help
    • /bot-upgrade
    • /bot-logs

Các lệnh Skills động

Các Skills mà người dùng có thể gọi cũng được hiển thị dưới dạng lệnh gạch chéo:
  • /skill <name> [input] luôn hoạt động như điểm vào chung.
  • Skills cũng có thể xuất hiện dưới dạng lệnh trực tiếp như /prose khi Skills/Plugin đăng ký chúng.
  • Việc đăng ký lệnh Skills gốc được điều khiển bởi commands.nativeSkillschannels.<provider>.commands.nativeSkills.
  • Các lệnh chấp nhận tùy chọn : giữa lệnh và đối số (ví dụ /think: high, /send: on, /help:).
  • /new <model> chấp nhận một bí danh mô hình, provider/model, hoặc tên nhà cung cấp (khớp mờ); nếu không khớp, văn bản được xử lý như phần thân tin nhắn.
  • Để xem phân tích đầy đủ về mức sử dụng theo nhà cung cấp, dùng openclaw status --usage.
  • /allowlist add|remove yêu cầu commands.config=true và tuân thủ configWrites của kênh.
  • Trong các kênh nhiều tài khoản, /allowlist --account <id> nhắm tới cấu hình và /config set channels.<provider>.accounts.<id>... cũng tuân thủ configWrites của tài khoản đích.
  • /usage điều khiển phần chân trang mức sử dụng theo từng phản hồi; /usage cost in bản tóm tắt chi phí cục bộ từ nhật ký phiên OpenClaw.
  • /restart được bật theo mặc định; đặt commands.restart: false để tắt.
  • /plugins install <spec> chấp nhận cùng thông số Plugin như openclaw plugins install: đường dẫn/kho lưu trữ cục bộ, gói npm, hoặc clawhub:<pkg>.
  • /plugins enable|disable cập nhật cấu hình Plugin và có thể nhắc khởi động lại.
  • Lệnh gốc chỉ dành cho Discord: /vc join|leave|status điều khiển các kênh thoại (không khả dụng dưới dạng văn bản). join yêu cầu một guild và kênh thoại/sân khấu đã chọn. Yêu cầu channels.discord.voice và các lệnh gốc.
  • Các lệnh gắn kết luồng Discord (/focus, /unfocus, /agents, /session idle, /session max-age) yêu cầu bật các gắn kết luồng có hiệu lực (session.threadBindings.enabled và/hoặc channels.discord.threadBindings.enabled).
  • Tham chiếu lệnh ACP và hành vi thời gian chạy: Tác tử ACP.
  • /verbose dành cho gỡ lỗi và tăng khả năng quan sát; hãy giữ tắt trong sử dụng thông thường.
  • /trace hẹp hơn /verbose: nó chỉ hiển thị các dòng trace/gỡ lỗi do Plugin sở hữu và giữ tắt phần trò chuyện công cụ chi tiết thông thường.
  • /fast on|off lưu một ghi đè phiên. Dùng tùy chọn inherit trong UI Sessions để xóa ghi đè đó và quay về mặc định cấu hình.
  • /fast phụ thuộc nhà cung cấp: OpenAI/OpenAI Codex ánh xạ nó thành service_tier=priority trên các điểm cuối Responses gốc, trong khi các yêu cầu Anthropic công khai trực tiếp, bao gồm lưu lượng được xác thực bằng OAuth gửi tới api.anthropic.com, ánh xạ nó thành service_tier=auto hoặc standard_only. Xem OpenAIAnthropic.
  • Tóm tắt lỗi công cụ vẫn được hiển thị khi liên quan, nhưng văn bản lỗi chi tiết chỉ được bao gồm khi /verboseon hoặc full.
  • /reasoning, /verbose, và /trace có rủi ro trong môi trường nhóm: chúng có thể tiết lộ lập luận nội bộ, đầu ra công cụ, hoặc chẩn đoán Plugin mà bạn không định công khai. Nên để chúng tắt, đặc biệt trong trò chuyện nhóm.
  • /model lưu mô hình phiên mới ngay lập tức.
  • Nếu tác tử đang rảnh, lượt chạy tiếp theo dùng nó ngay.
  • Nếu một lượt chạy đã hoạt động, OpenClaw đánh dấu việc chuyển đổi trực tiếp là đang chờ và chỉ khởi động lại vào mô hình mới tại một điểm thử lại sạch.
  • Nếu hoạt động công cụ hoặc đầu ra trả lời đã bắt đầu, chuyển đổi đang chờ có thể vẫn được xếp hàng cho đến một cơ hội thử lại sau hoặc lượt người dùng tiếp theo.
  • Trong TUI cục bộ, /crestodian [request] quay lại từ TUI tác tử thông thường về Crestodian. Điều này tách biệt với chế độ cứu hộ kênh tin nhắn và không cấp quyền cấu hình từ xa.
  • Đường nhanh: các tin nhắn chỉ chứa lệnh từ người gửi trong danh sách cho phép được xử lý ngay lập tức (bỏ qua hàng đợi + mô hình).
  • Cổng nhắc tên trong nhóm: các tin nhắn chỉ chứa lệnh từ người gửi trong danh sách cho phép bỏ qua yêu cầu nhắc tên.
  • Lối tắt nội tuyến (chỉ người gửi trong danh sách cho phép): một số lệnh cũng hoạt động khi được nhúng trong tin nhắn thông thường và bị loại bỏ trước khi mô hình thấy phần văn bản còn lại.
    • Ví dụ: hey /status kích hoạt một phản hồi trạng thái, và phần văn bản còn lại tiếp tục qua luồng thông thường.
  • Hiện tại: /help, /commands, /status, /whoami (/id).
  • Các tin nhắn chỉ chứa lệnh không được ủy quyền bị bỏ qua im lặng, và các token /... nội tuyến được xử lý như văn bản thường.
  • Lệnh Skills: Skills user-invocable được hiển thị dưới dạng lệnh gạch chéo. Tên được làm sạch thành a-z0-9_ (tối đa 32 ký tự); xung đột nhận hậu tố số (ví dụ _2).
    • /skill <name> [input] chạy một Skills theo tên (hữu ích khi giới hạn lệnh gốc ngăn việc tạo lệnh riêng cho từng Skills).
    • Theo mặc định, các lệnh Skills được chuyển tiếp tới mô hình như một yêu cầu thông thường.
    • Skills có thể tùy chọn khai báo command-dispatch: tool để định tuyến lệnh trực tiếp tới một công cụ (xác định, không dùng mô hình).
    • Ví dụ: /prose (Plugin OpenProse) — xem OpenProse.
  • Đối số lệnh gốc: Discord dùng tự động hoàn thành cho các tùy chọn động (và menu nút khi bạn bỏ qua đối số bắt buộc). Telegram và Slack hiển thị một menu nút khi lệnh hỗ trợ lựa chọn và bạn bỏ qua đối số. Các lựa chọn động được phân giải theo mô hình phiên đích, vì vậy các tùy chọn riêng theo mô hình như mức /think sẽ đi theo ghi đè /model của phiên đó.

/tools

/tools trả lời một câu hỏi về thời gian chạy, không phải câu hỏi cấu hình: tác tử này có thể dùng gì ngay bây giờ trong cuộc trò chuyện này.
  • /tools mặc định ngắn gọn và được tối ưu để quét nhanh.
  • /tools verbose thêm mô tả ngắn.
  • Các bề mặt lệnh gốc hỗ trợ đối số hiển thị cùng công tắc chế độ như compact|verbose.
  • Kết quả được giới hạn theo phiên, vì vậy việc thay đổi tác tử, kênh, luồng, quyền của người gửi, hoặc mô hình có thể thay đổi đầu ra.
  • /tools bao gồm các công cụ thực sự có thể truy cập trong thời gian chạy, bao gồm công cụ lõi, công cụ Plugin đã kết nối, và công cụ do kênh sở hữu.
Để chỉnh sửa hồ sơ và ghi đè, dùng bảng Tools trong Control UI hoặc các bề mặt cấu hình/danh mục thay vì xem /tools như một danh mục tĩnh.

Bề mặt mức sử dụng (nội dung hiển thị ở đâu)

  • Mức sử dụng/hạn mức nhà cung cấp (ví dụ: “Claude 80% left”) hiển thị trong /status cho nhà cung cấp mô hình hiện tại khi bật theo dõi mức sử dụng. OpenClaw chuẩn hóa các cửa sổ nhà cung cấp thành % left; với MiniMax, các trường phần trăm chỉ còn lại được đảo trước khi hiển thị, và phản hồi model_remains ưu tiên mục mô hình trò chuyện cộng với nhãn gói có gắn thẻ mô hình.
  • Các dòng token/cache trong /status có thể quay về mục mức sử dụng bản ghi mới nhất khi ảnh chụp nhanh phiên trực tiếp thưa dữ liệu. Các giá trị trực tiếp khác không hiện có vẫn được ưu tiên, và dự phòng bản ghi cũng có thể khôi phục nhãn mô hình thời gian chạy đang hoạt động cộng với tổng lớn hơn hướng theo prompt khi các tổng đã lưu bị thiếu hoặc nhỏ hơn.
  • Thực thi so với thời gian chạy: /status báo cáo Execution cho đường dẫn sandbox có hiệu lực và Runtime cho thực thể thực sự đang chạy phiên: OpenClaw Pi Default, OpenAI Codex, một backend CLI, hoặc một backend ACP.
  • Token/chi phí theo từng phản hồi được điều khiển bởi /usage off|tokens|full (được thêm vào các trả lời thông thường).
  • /model status nói về mô hình/xác thực/điểm cuối, không phải mức sử dụng.

Chọn mô hình (/model)

/model được triển khai như một chỉ thị. Ví dụ:
/model
/model list
/model 3
/model openai/gpt-5.4
/model opus@anthropic:default
/model status
Ghi chú:
  • /model/model list hiển thị bộ chọn ngắn gọn, có đánh số (họ mô hình + các nhà cung cấp khả dụng).
  • Trên Discord, /model/models mở một bộ chọn tương tác với danh sách thả xuống nhà cung cấp và mô hình cộng với bước Submit.
  • /model <#> chọn từ bộ chọn đó (và ưu tiên nhà cung cấp hiện tại khi có thể).
  • /model status hiển thị chế độ xem chi tiết, bao gồm điểm cuối nhà cung cấp đã cấu hình (baseUrl) và chế độ API (api) khi có.

Ghi đè gỡ lỗi

/debug cho phép bạn đặt các ghi đè cấu hình chỉ lúc chạy (trong bộ nhớ, không ghi ra đĩa). Chỉ dành cho chủ sở hữu. Tắt theo mặc định; bật bằng commands.debug: true. Ví dụ:
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
/debug unset messages.responsePrefix
/debug reset
Các ghi đè áp dụng ngay lập tức cho những lần đọc cấu hình mới, nhưng không ghi vào openclaw.json. Dùng /debug reset để xóa tất cả ghi đè và quay lại cấu hình trên đĩa.

Đầu ra theo dõi Plugin

/trace cho phép bạn bật/tắt các dòng theo dõi/gỡ lỗi Plugin theo phạm vi phiên mà không cần bật chế độ đầy đủ chi tiết. Ví dụ:
/trace
/trace on
/trace off
Ghi chú:
  • /trace không có đối số sẽ hiển thị trạng thái theo dõi của phiên hiện tại.
  • /trace on bật các dòng theo dõi Plugin cho phiên hiện tại.
  • /trace off tắt chúng lại.
  • Các dòng theo dõi Plugin có thể xuất hiện trong /status và dưới dạng tin nhắn chẩn đoán tiếp theo sau phản hồi trợ lý bình thường.
  • /trace không thay thế /debug; /debug vẫn quản lý các ghi đè cấu hình chỉ lúc chạy.
  • /trace không thay thế /verbose; đầu ra công cụ/trạng thái chi tiết bình thường vẫn thuộc về /verbose.

Cập nhật cấu hình

/config ghi vào cấu hình trên đĩa của bạn (openclaw.json). Chỉ dành cho chủ sở hữu. Tắt theo mặc định; bật bằng commands.config: true. Ví dụ:
/config show
/config show messages.responsePrefix
/config get messages.responsePrefix
/config set messages.responsePrefix="[openclaw]"
/config unset messages.responsePrefix
Cấu hình được xác thực trước khi ghi; các thay đổi không hợp lệ sẽ bị từ chối. Các cập nhật /config được giữ lại qua các lần khởi động lại.

Cập nhật MCP

/mcp ghi các định nghĩa máy chủ MCP do OpenClaw quản lý trong mcp.servers. Chỉ dành cho chủ sở hữu. Tắt theo mặc định; bật bằng commands.mcp: true. Ví dụ:
/mcp show
/mcp show context7
/mcp set context7={"command":"uvx","args":["context7-mcp"]}
/mcp unset context7
/mcp lưu cấu hình trong cấu hình OpenClaw, không phải thiết lập dự án do Pi sở hữu. Các bộ chuyển đổi runtime quyết định transport nào thực sự có thể thực thi.

Cập nhật Plugin

/plugins cho phép người vận hành kiểm tra các Plugin đã được phát hiện và bật/tắt chúng trong cấu hình. Các luồng chỉ đọc có thể dùng /plugin làm bí danh. Tắt theo mặc định; bật bằng commands.plugins: true. Ví dụ:
/plugins
/plugins list
/plugin show context7
/plugins enable context7
/plugins disable context7
  • /plugins list/plugins show dùng phát hiện Plugin thực tế trên workspace hiện tại cùng cấu hình trên đĩa.
  • /plugins enable|disable chỉ cập nhật cấu hình Plugin; lệnh này không cài đặt hoặc gỡ cài đặt Plugin.
  • Sau các thay đổi bật/tắt, hãy khởi động lại Gateway để áp dụng chúng.

Ghi chú về bề mặt

  • Lệnh văn bản chạy trong phiên trò chuyện bình thường (DM dùng chung main, nhóm có phiên riêng).
  • Lệnh native dùng các phiên tách biệt:
    • Discord: agent:<agentId>:discord:slash:<userId>
    • Slack: agent:<agentId>:slack:slash:<userId> (tiền tố có thể cấu hình qua channels.slack.slashCommand.sessionPrefix)
    • Telegram: telegram:slash:<userId> (nhắm tới phiên trò chuyện qua CommandTargetSessionKey)
  • /stop nhắm tới phiên trò chuyện đang hoạt động để có thể hủy lần chạy hiện tại.
channels.slack.slashCommand vẫn được hỗ trợ cho một lệnh kiểu /openclaw duy nhất. Nếu bạn bật commands.native, bạn phải tạo một lệnh slash Slack cho mỗi lệnh tích hợp sẵn (cùng tên như /help). Menu đối số lệnh cho Slack được gửi dưới dạng nút Block Kit tạm thời.Ngoại lệ native của Slack: đăng ký /agentstatus (không phải /status) vì Slack giữ riêng /status. Văn bản /status vẫn hoạt động trong tin nhắn Slack.

Câu hỏi phụ BTW

/btw là một câu hỏi phụ nhanh về phiên hiện tại. Khác với trò chuyện bình thường:
  • nó dùng phiên hiện tại làm ngữ cảnh nền,
  • nó chạy như một lệnh gọi một lần không dùng công cụ riêng biệt,
  • nó không thay đổi ngữ cảnh phiên trong tương lai,
  • nó không được ghi vào lịch sử transcript,
  • nó được gửi dưới dạng kết quả phụ trực tiếp thay vì tin nhắn trợ lý bình thường.
Điều đó khiến /btw hữu ích khi bạn muốn làm rõ tạm thời trong khi tác vụ chính vẫn tiếp tục. Ví dụ:
/btw what are we doing right now?
Xem Câu hỏi phụ BTW để biết đầy đủ hành vi và chi tiết UX của client.

Liên quan