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 do 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 đến harness ACP đó. Các lệnh quản lý Gateway vẫn ở cục bộ: /acp ... luôn đến trình xử lý lệnh ACP của OpenClaw, còn /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.
  • Các chỉ thị được loại khỏi tin nhắn trước khi model 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 xem là “gợi ý nội tuyến” và không lưu lại thiết lập phiên.
  • Trong tin nhắn chỉ có chỉ thị (tin nhắn chỉ chứa các chỉ thị), chúng được lưu vào phiên và phản hồ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à allowlist duy nhất được dùng; nếu không, ủy quyền đến từ allowlist/ghép đôi của 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 thường.
Chỉ dành cho người gửi nằm trong allowlist/đã đượ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 model nhìn thấy, và phần văn bản còn lại tiếp tục đi qua luồng thông 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 gốc (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 gốc. Tự động: bật cho Discord/Telegram; tắt cho Slack (cho đến khi bạn thêm slash commands); bị bỏ qua với các provider không hỗ trợ gốc. Đặt channels.discord.commands.native, channels.telegram.commands.native, hoặc channels.slack.commands.native để ghi đè theo từng provider (bool hoặc "auto"). Trên Discord, false bỏ qua việc đăng ký và dọn dẹp slash-command trong khi khởi động; các lệnh đã đăng ký trước đó có thể vẫn hiển thị cho đến khi bạn xóa chúng khỏi ứng dụng Discord. Lệnh Slack được quản lý trong ứng dụng Slack và không bị xóa tự động.
Trên Discord, đặc tả lệnh gốc có thể bao gồm descriptionLocalizations, được OpenClaw phát hành dưới dạng description_localizations của Discord và đưa vào các so sánh reconcile.
​
commands.nativeSkills
boolean | "auto"
mặc định:"\"auto\""
Đăng ký lệnh skill theo cách gốc 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 provider (bool hoặc "auto").
​
commands.bash
boolean
mặc định:"false"
Bật ! <cmd> để chạy lệnh shell của host (/bash <cmd> là bí danh; yêu cầu allowlist tools.elevated).
​
commands.bashForegroundMs
number
mặc định:"2000"
Kiểm soát thời gian bash chờ trước khi chuyển sang chế độ nền (0 đưa vào 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ý trong mcp.servers).
​
commands.plugins
boolean
mặc định:"false"
Bật /plugins (khám phá/trạng thái plugin cùng với điều khiển cài đặt + bật/tắt).
​
commands.debug
boolean
mặc định:"false"
Bật /debug (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 allowlist chủ sở hữu rõ ràng cho các bề mặt lệnh/công cụ chỉ dành cho chủ sở hữu. Đâ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 đôi DM.
​
channels.<channel>.commands.enforceOwnerForCommands
boolean
mặc định:"false"
Theo từng kênh: yêu cầu các lệnh chỉ dành cho chủ sở hữu phải có danh tính chủ sở hữu để chạy trên bề mặt đó. Khi true, người gửi phải khớp với một ứng viên chủ sở hữu đã được phân giải (ví dụ một mục trong commands.ownerAllowFrom hoặc metadata chủ sở hữu gốc của provider) hoặc có phạm vi operator.admin nội bộ trên một 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 chủ sở hữu trống/chưa phân giải, là không đủ — lệnh chỉ dành cho chủ sở hữu sẽ đóng khi không đạt trên kênh đó. Để tắt tùy chọn này nếu bạn muốn lệnh chỉ dành cho chủ sở hữu chỉ bị kiểm soát bởi ownerAllowFrom và các allowlist lệnh tiêu chuẩn.
​
commands.ownerDisplay
"raw" | "hash"
Kiểm soát cách id chủ sở hữu xuất hiện trong system prompt.
​
commands.ownerDisplaySecret
string
Tùy chọn đặt secret HMAC được dùng khi commands.ownerDisplay="hash".
​
commands.allowFrom
object
Allowlist theo từng provider để ủ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ị (allowlist/ghép đôi của kênh và commands.useAccessGroups bị bỏ qua). Dùng "*" làm mặc định toàn cục; các khóa dành riêng cho provider sẽ ghi đè nó.
​
commands.useAccessGroups
boolean
mặc định:"true"
Thực thi allowlist/chính sách cho lệnh khi commands.allowFrom không được đặt.

​
Danh sách lệnh

Nguồn chân lý hiện tại:
  • các lệnh tích hợp cốt lõi đế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
  • 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 cốt lõi

  • /new [model] bắt đầu một phiên mới; /reset là bí danh reset.
  • Control UI chặn /new được nhập để tạo và chuyển sang một phiên dashboard mới, ngoại trừ khi session.dmScope: "main" được cấu hình và parent hiện tại là phiên chính của agent; trong trường hợp đó /new reset phiên chính tại chỗ. /reset được nhập vẫn chạy reset tại chỗ của Gateway.
  • /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 quá trình tải startup/system-prompt tại chỗ.
  • /compact [instructions] compacts ngữ cảnh phiên. Xem Compaction.
  • /stop hủy lượt chạy hiện tại.
  • /session idle <duration|off> và /session max-age <duration|off> quản lý thời 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, rồi xuất một trajectory bundle JSONL cho phiên hiện tại. Dùng nó khi bạn cần dòng thời gian 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 chủ sở hữu. Bí danh: /trajectory.
  • /think <level|default> đặt mức suy nghĩ hoặc xóa ghi đè phiên. Các tùy chọn đến từ hồ sơ provider của model đ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 chi tiết. Bí danh: /v.
  • /trace on|off bật/tắt đầu ra trace của plugin cho phiên hiện tại.
  • /fast [status|on|off|default] hiển thị, đặt, hoặc xóa chế độ nhanh.
  • /reasoning [on|off|stream] bật/tắt 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 model.
  • /models [provider] [page] [limit=<n>|size=<n>|all] liệt kê các provider đã cấu hình/có auth khả dụng hoặc các model cho một provider; thêm all để duyệt toàn bộ catalog của provider đó. Các mục provider/* trong agents.defaults.models khiến /model và /models chỉ hiển thị model được phát hiện cho các provider đó.
  • /queue <mode> quản lý hành vi hàng đợi (steer, queue legacy, 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 và Hàng đợi điều hướng.
  • /steer <message> chèn hướng dẫn vào lượt chạy đang hoạt động cho phiên hiện tại, độc lập với chế độ /queue. Nó không bắt đầu lượt chạy mới khi phiên đang idle. Bí danh: /tell. Xem Điều hướng.
  • /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 những gì ngay lúc này.
  • /status hiển thị trạng thái thực thi/runtime, thời gian hoạt động của Gateway và hệ thống, cùng mức sử dụng/hạn mức provider khi có.
  • /diagnostics [note] là luồng báo cáo hỗ trợ chỉ dành cho chủ sở hữu cho lỗi Gateway và lượt chạy harness Codex. 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; đừng phê duyệt diagnostics bằng quy tắc allow-all. Sau khi được phê duyệt, nó gửi một báo cáo có thể dán với đường dẫn bundle 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 chủ sở hữu. Khi phiên đang hoạt động dùng harness OpenAI Codex, cùng phê duyệt đó cũng gửi phản hồi Codex liên quan đến 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à 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 chủ sở hữu.
  • /tasks liệt kê tác vụ nền đang hoạt động/gần đây cho phiên hiện tại.
  • /context [list|detail|map|json] giải thích cách ngữ cảnh được lắp ráp. map gửi một ảnh treemap của ngữ cảnh phiên hiện tại.
  • /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 footer 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> hỏi một câu hỏi bên lề mà không thay đổi ngữ cảnh phiên trong tương lai. Bí danh: /side. Xem BTW.
  • /subagents list|kill|log|info|send|steer|spawn quản lý các lần 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> gắn luồng Discord hiện tại hoặc chủ đề/cuộc trò chuyện 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 được gắn với luồng cho phiên hiện tại.
  • /kill <id|#|all> hủy một hoặc tất cả các sub-agent đang chạy.
  • /subagents steer <id|#> <message> gửi hướng dẫn cho một sub-agent đang chạy. Xem Steer.
  • /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ý trong 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à một bí danh. 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ỉ áp dụng trong runtime. 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 chạy nền.
  • !stop [sessionId] dừng một tác vụ bash chạy nền.

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

Các lệnh dock 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 Channel docking để biết cách thiết lập, ví dụ và khắc phục sự cố. Các lệnh dock được tạo từ Plugin kênh có hỗ trợ lệnh gốc. Tập hợp 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 dock từ mộ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. Agent giữ nguyên ngữ cảnh phiên, nhưng các câu trả lời sau này cho phiên đó được gửi đến peer kênh đã chọn. Các lệnh dock yêu cầu session.identityLinks. Người gửi nguồn và peer đích phải ở trong cùng một nhóm định danh, 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" và lastTo: "456" trên phiên đang hoạt động. Nếu người gửi không được liên kết với một peer Discord, lệnh sẽ trả lời bằng gợi ý thiết lập thay vì chuyển tiếp sang trò chuyện bình thường. Docking 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 một phiên khác. Dùng /dock-telegram, /dock-slack, /dock-mattermost, hoặc một lệnh dock đượ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 slash 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 Pairing.
  • /phone status|arm <camera|screen|writes|all> [duration]|disarm tạm thời kích hoạt các lệnh node điện thoại có 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 preset thẻ giàu nội dung của LINE. Xem LINE.
  • /codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills kiểm tra và điều khiển harness app-server Codex tích hợp. Xem Codex harness.
  • Các lệnh chỉ dành cho QQBot:
    • /bot-ping
    • /bot-version
    • /bot-help
    • /bot-upgrade
    • /bot-logs

​
Các lệnh skill động

Các skill mà người dùng có thể gọi cũng được hiển thị dưới dạng lệnh slash:
  • /skill <name> [input] luôn hoạt động như điểm vào chung.
  • các skill cũng có thể xuất hiện dưới dạng lệnh trực tiếp như /prose khi skill/Plugin đăng ký chúng.
  • đăng ký lệnh skill gốc được điều khiển bởi commands.nativeSkills và channels.<provider>.commands.nativeSkills.
  • đặc tả lệnh có thể cung cấp descriptionLocalizations cho các bề mặt gốc hỗ trợ mô tả đã bản địa hóa, bao gồm Discord.
  • Các lệnh chấp nhận dấu : tùy chọn giữa lệnh và đối số (ví dụ /think: high, /send: on, /help:).
  • /new <model> chấp nhận bí danh model, provider/model, hoặc tên provider (khớp mờ); nếu không khớp, văn bản được xem là nội dung tin nhắn.
  • Để xem phân tích đầy đủ về mức sử dụng provider, dùng openclaw status --usage.
  • /allowlist add|remove yêu cầu commands.config=true và tuân theo configWrites của kênh.
  • Trong các kênh nhiều tài khoản, /allowlist --account <id> nhắm đến cấu hình và /config set channels.<provider>.accounts.<id>... cũng tuân theo 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 các đặc tả Plugin như openclaw plugins install: đường dẫn/kho lưu trữ cục bộ, gói npm, git:<repo>, hoặc clawhub:<pkg>, rồi yêu cầu khởi động lại Gateway vì các module nguồn Plugin đã thay đổi.
  • /plugins enable|disable cập nhật cấu hình Plugin và kích hoạt tải lại Plugin của Gateway cho các lượt agent mới.
  • Lệnh gốc chỉ dành cho Discord: /vc join|leave|status điều khiển 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/stage đã chọn. Yêu cầu channels.discord.voice và lệnh gốc.
  • Các lệnh gắn luồng Discord (/focus, /unfocus, /agents, /session idle, /session max-age) yêu cầu liên kết luồng hiệu lực được bật (session.threadBindings.enabled và/hoặc channels.discord.threadBindings.enabled).
  • Tham chiếu lệnh ACP và hành vi runtime: ACP agents.
  • /verbose dành cho gỡ lỗi và tăng khả năng quan sát; giữ nó tắt khi sử dụng bình thường.
  • /trace hẹp hơn /verbose: nó chỉ tiết lộ các dòng trace/gỡ lỗi thuộc sở hữu Plugin và giữ phần nhiễu công cụ verbose bình thường ở trạng thái tắt.
  • /fast on|off lưu một ghi đè phiên. Dùng tùy chọn inherit trong UI Sessions để xóa nó và quay về mặc định cấu hình.
  • /fast phụ thuộc vào provider: OpenAI/OpenAI Codex ánh xạ nó tới service_tier=priority trên các endpoint Responses gốc, còn 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ó tới service_tier=auto hoặc standard_only. Xem OpenAI và Anthropic.
  • Tóm tắt lỗi công cụ vẫn được hiển thị khi có liên quan, nhưng văn bản lỗi chi tiết chỉ được đưa vào khi /verbose là on 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ộ reasoning nội bộ, đầu ra công cụ, hoặc chẩn đoán Plugin mà bạn không định phơi bày. Nên để chúng tắt, đặc biệt trong trò chuyện nhóm.
  • /model lưu model phiên mới ngay lập tức.
  • Nếu agent đang rảnh, lần chạy tiếp theo sẽ dùng nó ngay.
  • Nếu một lần chạy đã hoạt động, OpenClaw đánh dấu một chuyển đổi trực tiếp là đang chờ và chỉ khởi động lại vào model 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ể tiếp tục nằm trong hàng đợi cho đến 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 agent bình 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 + model).
  • Cổng nhắc đế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 đến.
  • Phím 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 bình thường và bị loại bỏ trước khi model thấy phần văn bản còn lại.
    • Ví dụ: hey /status kích hoạt phản hồi trạng thái, và phần văn bản còn lại tiếp tục đi qua luồng bình 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ị âm thầm bỏ qua, và các token /... nội tuyến được xem là văn bản thường.
  • Lệnh skill: các skill user-invocable được hiển thị dưới dạng lệnh slash. 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 skill theo tên (hữu ích khi giới hạn lệnh gốc ngăn không cho tạo lệnh riêng cho từng skill).
    • Theo mặc định, lệnh skill được chuyển tiếp tới model như một yêu cầu bình 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 qua model).
    • 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ị menu nút khi một 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 model phiên đích, nên các tùy chọn theo model như mức /think tuân theo ghi đè /model của phiên đó.

​
/tools

/tools trả lời một câu hỏi runtime, không phải câu hỏi cấu hình: agent 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 phạm vi theo phiên, nên việc thay đổi agent, kênh, luồng, ủy quyền người gửi, hoặc model có thể thay đổi đầu ra.
  • /tools bao gồm các công cụ thực sự có thể truy cập trong runtime, bao gồm công cụ lõi, công cụ Plugin đã kết nối, và công cụ thuộc sở hữu kênh.
Để 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/catalog thay vì xem /tools như một catalog tĩnh.

​
Bề mặt sử dụng (hiển thị ở đâu)

  • Mức sử dụng/hạn mức của 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ổ của nhà cung cấp thành % left; với MiniMax, các trường phần trăm chỉ thể hiện phần còn lại sẽ được đảo ngược trước khi hiển thị, và các phản hồi model_remains ưu tiên mục mô hình chat cùng nhãn gói có gắn thẻ mô hình.
  • Dòng token/cache trong /status có thể quay về mục mức sử dụng transcript mới nhất khi ảnh chụp nhanh phiên trực tiếp quá ít dữ liệu. Các giá trị trực tiếp khác 0 hiện có vẫn được ưu tiên, và phương án dự phòng từ transcript cũng có thể khôi phục nhãn mô hình runtime đang hoạt động cùng tổng lớn hơn theo hướng prompt khi tổng đã lưu bị thiếu hoặc nhỏ hơn.
  • Thực thi so với runtime: /status báo cáo Execution cho đường dẫn sandbox hiệu lực và Runtime cho bên 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ằng /usage off|tokens|full (được nối vào các phản hồi thông thường).
  • /model status nói về mô hình/xác thực/endpoint, không phải mức sử dụng.

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

/model được triển khai dưới dạng 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 và /model list hiển thị bộ chọn nhỏ gọn, được đánh số (họ mô hình + các nhà cung cấp khả dụng).
  • Trên Discord, /model và /models mở một bộ chọn tương tác với menu thả xuống nhà cung cấp và mô hình cùng bước Submit. Bộ chọn tôn trọng agents.defaults.models, bao gồm các mục provider/*, nên việc khám phá theo phạm vi nhà cung cấp có thể giữ bộ chọn dưới giới hạn thành phần 25 tùy chọn của Discord.
  • /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 endpoint 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 ghi đè cấu hình chỉ trong runtime (bộ nhớ, không phải ổ đĩa). Chỉ 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
Ghi đè áp dụng ngay cho các 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 truy vết Plugin

/trace cho phép bạn bật/tắt các dòng truy vết/gỡ lỗi Plugin trong phạm vi phiên mà không cần bật toàn bộ chế độ 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 truy vết phiên hiện tại.
  • /trace on bật các dòng truy vết Plugin cho phiên hiện tại.
  • /trace off tắt lại các dòng đó.
  • Các dòng truy vết Plugin có thể xuất hiện trong /status và dưới dạng một thông báo chẩn đoán tiếp theo sau phản hồi trợ lý thông thường.
  • /trace không thay thế /debug; /debug vẫn quản lý các ghi đè cấu hình chỉ trong runtime.
  • /trace không thay thế /verbose; đầu ra công cụ/trạng thái chi tiết thông 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ỉ 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 duy trì 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ý dưới mcp.servers. Chỉ 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 cài đặt dự án do Pi sở hữu. Các adapter 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 đã phát hiện và bật/tắt trạng thái kích hoạt 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 và /plugins show dùng khám phá Plugin thực tế đối với workspace hiện tại cùng cấu hình trên ổ đĩa.
  • /plugins install cài đặt từ ClawHub, npm, git, thư mục cục bộ và archive.
  • /plugins enable|disable chỉ cập nhật cấu hình Plugin; nó không cài đặt hoặc gỡ cài đặt Plugin.
  • Các thay đổi bật và tắt sẽ hot-reload các bề mặt runtime Plugin của Gateway cho các lượt agent mới; lệnh cài đặt yêu cầu khởi động lại Gateway vì các module nguồn Plugin đã thay đổi.

​
Ghi chú về bề mặt

  • Lệnh văn bản chạy trong phiên chat thông 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 chat qua CommandTargetSessionKey)
  • /stop nhắm tới phiên chat đang hoạt động để có thể hủy lượt 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 các 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 dành 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. /side là bí danh. Khác với chat thông thường:
  • nó dùng phiên hiện tại làm ngữ cảnh nền,
  • trong các phiên harness Codex, nó chạy như một luồng phụ Codex tạm thời với quyền Codex hiện tại và bề mặt công cụ native,
  • trong các phiên không phải Codex, nó giữ hành vi gọi phụ trực tiếp một lần cũ hơn,
  • 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ì một thông báo trợ lý thông thường.
Điều đó làm cho /btw hữu ích khi bạn muốn làm rõ tạm thời trong lúc tác vụ chính tiếp tục chạy. Ví dụ: 
/btw what are we doing right now?
/side what changed while the main run continued?
Xem Câu hỏi phụ BTW để biết đầy đủ hành vi và chi tiết UX của client.

​
Liên quan