Lệnh slash
- Các lệnh được xử lý bởi Gateway. 9. Hầu hết các 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 chat bash chỉ dành cho host sử dụng
!. 11.<cmd>(với/bash <cmd>là bí danh).
- Commands: các tin nhắn
/...độc lập. - Directives:
/think,/verbose,/reasoning,/elevated,/exec,/model,/queue.- Directives sẽ bị loại khỏi tin nhắn trước khi mô hình nhìn thấy.
- Trong tin nhắn chat thông thường (không chỉ gồm directive), chúng được xem là “gợi ý nội tuyến” và không lưu trạng thái phiên.
- Trong tin nhắn chỉ có directive (tin nhắn chỉ chứa directive), chúng được lưu vào phiên và trả về xác nhận.
- Các directive chỉ được áp dụng cho người gửi được ủy quyền. Nếu
commands.allowFromđược thiết lập, đó sẽ là allowlist duy nhất được sử dụng; nếu không, việc ủy quyền đến từ allowlist/pairing của kênh cùng vớicommands.useAccessGroups. 12. Người gửi không được ủy quyền sẽ thấy các directive được xử lý như văn bản thuần.
- Cũng có một vài phím tắt nội tuyến (chỉ dành cho người gửi trong allowlist/được ủy quyền):
/help,/commands,/status,/whoami(/id). They run immediately, are stripped before the model sees the message, and the remaining text continues through the normal flow.
Cấu hình
commands.text(mặc địnhtrue) bật phân tích/...trong tin nhắn chat.- Trên các nền tảng không có lệnh native (WhatsApp/WebChat/Signal/iMessage/Google Chat/MS 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.
- Trên các nền tảng không có lệnh native (WhatsApp/WebChat/Signal/iMessage/Google Chat/MS Teams), lệnh văn bản vẫn hoạt động ngay cả khi bạn đặt giá trị này thành
commands.native(mặc định"auto") đăng ký các lệnh native.- Tự động: bật cho Discord/Telegram; tắt cho Slack (cho đến khi bạn thêm lệnh slash); bị bỏ qua với nhà cung cấp không hỗ trợ native.
- Đặt
channels.discord.commands.native,channels.telegram.commands.nativehoặcchannels.slack.commands.nativeđể ghi đè theo từng nhà cung cấp (bool hoặc"auto"). -
falsesẽ xóa các lệnh đã đăng ký trước đó trên Discord/Telegram khi khởi động. 15. Các lệnh Slack được quản lý trong ứng dụng Slack và không bị xóa tự động.
commands.nativeSkills(mặc định"auto") đăng ký các lệnh skill ở dạng 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 lệnh slash cho mỗi skill).
- Đặt
channels.discord.commands.nativeSkills,channels.telegram.commands.nativeSkillshoặcchannels.slack.commands.nativeSkillsđể ghi đè theo từng nhà cung cấp (bool hoặc"auto").
-
commands.bash(mặc địnhfalse) bật! <cmd>to run host shell commands (/bash <cmd>is an alias; requirestools.elevatedallowlists).
commands.bashForegroundMs(mặc định2000) kiểm soát thời gian bash chờ trước khi chuyển sang chế độ nền (0chạy nền ngay).commands.config(mặc địnhfalse) bật/config(đọc/ghiopenclaw.json).commands.debug(mặc địnhfalse) bật/debug(ghi đè chỉ trong runtime).commands.allowFrom(tùy chọn) thiết lập allowlist theo từng provider để ủy quyền lệnh. Khi được cấu hình, đây sẽ là nguồn ủy quyền duy nhất cho lệnh và directive (allowlist/pairing của kênh vàcommands.useAccessGroupssẽ bị bỏ qua). Sử dụng"*"cho mặc định toàn cục; các khóa theo provider cụ thể sẽ ghi đè nó.commands.useAccessGroups(mặc địnhtrue) thực thi allowlist/chính sách cho lệnh khicommands.allowFromchưa được thiết lập.
Danh sách lệnh
Văn bản + native (khi được bật):/help/commands/skill <name> [input](chạy một skill theo tên)/status(hiển thị trạng thái hiện tại; bao gồm mức sử dụng/hạn mức của nhà cung cấp cho nhà cung cấp mô hình hiện tại khi có)/allowlist(liệt kê/thêm/xóa mục trong danh sách cho phép)/approve <id> allow-once|allow-always|deny(giải quyết các lời nhắc phê duyệt exec)/context [list|detail|json](giải thích “context”;detailhiển thị kích thước theo từng tệp + từng công cụ + từng skill + system prompt)/whoami(hiển thị sender id của bạn; bí danh:/id)/subagents list|stop|log|info|send(kiểm tra, dừng, xem log hoặc nhắn tin các lần chạy sub-agent cho phiên hiện tại)/config show|get|set|unset(ghi cấu hình xuống đĩa, chỉ chủ sở hữu; yêu cầucommands.config: true)/debug show|set|unset|reset(ghi đè runtime, chỉ chủ sở hữu; yêu cầucommands.debug: true)/usage off|tokens|full|cost(chân trang mức sử dụng theo phản hồi hoặc tóm tắt chi phí cục bộ)/tts off|always|inbound|tagged|status|provider|limit|summary|audio(điều khiển TTS; xem /tts)/debug show|set|unset|reset(ghi đè runtime, chỉ chủ sở hữu; yêu cầucommands.debug: true)/usage off|tokens|full|cost(chân trang mức sử dụng theo phản hồi hoặc tóm tắt chi phí cục bộ)/dock-telegram(bí danh:/dock_telegram) (chuyển phản hồi sang Telegram)- Discord: lệnh native là
/voice(Discord giữ chỗ/tts); lệnh văn bản/ttsvẫn hoạt động.
- Discord: lệnh native là
/stop/restart/activation mention|always(chỉ nhóm)/send on|off|inherit(chỉ chủ sở hữu)/resethoặc/new [model](gợi ý mô hình tùy chọn; phần còn lại được chuyển tiếp)/think <off|minimal|low|medium|high|xhigh>(lựa chọn động theo mô hình/nhà cung cấp; bí danh:/thinking,/t)/verbose on|full|off(bí danh:/v)/reasoning on|off|stream(bí danh:/reason; khi bật, gửi một tin nhắn riêng có tiền tốReasoning:;stream= chỉ bản nháp Telegram)/elevated on|off|ask|full(bí danh:/elev;fullbỏ qua phê duyệt exec)/exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>(gửi/execđể hiển thị hiện tại)/model <name>(bí danh:/models; hoặc/<alias>từagents.defaults.models.*.alias)/queue <mode>(kèm các tùy chọn nhưdebounce:2s cap:25 drop:summarize; gửi/queueđể xem cài đặt hiện tại)/exec host=<sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>(gửi/execđể hiển thị hiện tại)/model <name>(bí danh:/models; hoặc/<alias>từagents.defaults.models.*.alias)/queue <mode>(kèm các tùy chọn nhưdebounce:2s cap:25 drop:summarize; gửi/queueđể xem cài đặt hiện tại)/bash <command>(host-only; alias for! <command>; requirescommands.bash: true+tools.elevatedallowlists)
/compact [instructions](xem /concepts/compaction)! 25. <command>(chỉ cho host; từng lệnh một; dùng!poll+!stopcho các tác vụ chạy lâu)!poll(kiểm tra đầu ra / trạng thái; chấp nhận tùy chọnsessionId;/bash pollcũng hoạt động)!stop(dừng tác vụ bash đang chạy; chấp nhận tùy chọnsessionId;/bash stopcũng hoạt động)
- Lệnh chấp nhận một
: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 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 sẽ được coi là nội dung tin nhắn.- Để xem phân tích đầy đủ mức sử dụng theo nhà cung cấp, dùng
openclaw status --usage. /allowlist add|removeyêu cầucommands.config=truevà tuân theoconfigWritescủa kênh./usagekiểm soát chân trang mức sử dụng theo phản hồi;/usage costin tóm tắt chi phí cục bộ từ log phiên OpenClaw./restartbị tắt theo mặc định; đặtcommands.restart: trueđể bật./verboseпредназнач cho gỡ lỗi và tăng khả năng quan sát; hãy giữ tắt trong sử dụng bình thường./reasoning(and/verbose) are risky in group settings: they may reveal internal reasoning or tool output you did not intend to expose. Prefer leaving them off, especially in group chats.- Đường nhanh: tin nhắn chỉ có lệnh từ người gửi trong danh sách cho phép được xử lý ngay (bỏ qua hàng đợi + mô hình).
- Chặn theo đề cập nhóm: tin nhắn chỉ có lệnh từ người gửi trong danh sách cho phép bỏ qua yêu cầu đề cập.
- Phím tắt nội tuyến (chỉ cho người gửi trong danh sách cho phép): một số lệnh cũng hoạt động khi nhúng trong tin nhắn 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 /statuskí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 theo luồng bình thường.
- Ví dụ:
- Hiện tại:
/help,/commands,/status,/whoami(/id). - Tin nhắn chỉ có lệnh từ người không được ủy quyền sẽ bị bỏ qua âm thầm, và các token
/...nội tuyến được xử lý như văn bản thường. -
- Lệnh kỹ năng: các kỹ năng
user-invocableđược hiển thị dưới dạng lệnh slash. 18. Tên được làm sạch thànha-z0-9_(tối đa 32 ký tự); trùng lặp sẽ được thêm 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 native ngăn tạo lệnh theo từng skill).- Theo mặc định, lệnh skill được chuyển tới mô hình như một yêu cầu bình thường.
- Skill 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 mô hình). - Ví dụ:
/prose(plugin OpenProse) — xem OpenProse.
- Lệnh kỹ năng: các kỹ năng
-
- Đối số lệnh gốc: Discord sử 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 các đối số bắt buộc). Telegram and Slack show a button menu when a command supports choices and you omit the arg.
Bề mặt sử dụng (hiển thị ở đâu)
- Mức sử dụng/hạn mức theo nhà cung cấp (ví dụ: “Claude còn 80%”) hiển thị trong
/statuscho nhà cung cấp mô hình hiện tại khi bật theo dõi mức sử dụng. - Token/chi phí theo phản hồi được kiểm soát bởi
/usage off|tokens|full(đính kèm vào phản hồi thường). /model statusnó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 directive.
Ví dụ:
/modelvà/model listhiển thị bộ chọn gọn, có đánh số (họ mô hình + các nhà cung cấp khả dụng)./model <#>chọn từ bộ chọn đó (và ưu tiên nhà cung cấp hiện tại khi có thể)./model statushiể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 lets you set runtime-only config overrides (memory, not disk). 30. Chỉ dành cho owner. 20. Mặc định bị tắt; bật bằng commands.debug: true.
Ví dụ:
- 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 về cấu hình trên đĩa.
Cập nhật cấu hình
/config writes to your on-disk config (openclaw.json). 32. Chỉ dành cho owner. 21. Mặc định bị tắt; bật bằng commands.config: true.
Ví dụ:
- Cấu hình được kiểm tra hợp lệ trước khi ghi; thay đổi không hợp lệ sẽ bị từ chối.
- Các cập nhật
/configtồn tại qua các lần khởi động lại.
Ghi chú theo bề mặt
- Lệnh văn bản chạy trong phiên chat bình thường (DM chia sẻ
main, nhóm có phiên riêng). - Lệnh native dùng các phiên cô lập:
- Discord:
agent:<agentId>:discord:slash:<userId> - Slack:
agent:<agentId>:slack:slash:<userId>(tiền tố có thể cấu hình quachannels.slack.slashCommand.sessionPrefix) - Telegram:
telegram:slash:<userId>(nhắm vào phiên chat quaCommandTargetSessionKey)
- Discord:
/stopnhắm vào phiên chat đang hoạt động để có thể hủy lần chạy hiện tại.- Slack:
channels.slack.slashCommandis still supported for a single/openclaw-style command. If you enablecommands.native, you must create one Slack slash command per built-in command (same names as/help). Command argument menus for Slack are delivered as ephemeral Block Kit buttons.