Lệnh gạch chéo

Gateway xử lý các lệnh được gửi dưới dạng tin nhắn độc lập bắt đầu bằng /. Các lệnh bash chỉ dành cho máy chủ sử dụng ! <cmd> (với /bash <cmd> làm bí danh).

Khi một cuộc trò chuyện được liên kết với một phiên ACP, văn bản thông thường được định tuyến đến harness ACP. Các lệnh quản lý Gateway vẫn được xử lý cục bộ: /acp ... luôn được chuyển đến trình xử lý lệnh OpenClaw, còn /status cùng /unfocus vẫn được xử lý cục bộ bất cứ khi nào việc xử lý lệnh được bật cho bề mặt đó.

Ba loại lệnh

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,  },}

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImNoYW5uZWxzLjxjaGFubmVs .commands.enforceOwnerForCommands" type="boolean" default="false"> Theo từng kênh: yêu cầu danh tính chủ sở hữu đối với các lệnh chỉ dành cho chủ sở hữu. Khi true, người gửi phải khớp với commands.ownerAllowFrom hoặc có phạm vi nội bộ operator.admin. Mục ký tự đại diện allowFrom là không đủ.

Danh sách lệnh

Các lệnh đến từ ba nguồn:

• Lệnh tích hợp sẵn của lõi: src/auto-reply/commands-registry.shared.ts
• Lệnh dock được tạo: src/auto-reply/commands-registry.data.ts
• Lệnh plugin: các lệnh gọi registerCommand() của plugin

Tính khả dụng phụ thuộc vào các cờ cấu hình, bề mặt kênh và các plugin đã cài đặt/bật.

Lệnh lõi

Lệnh neo kênh

Lệnh neo kênh chuyển tuyến trả lời của phiên đang hoạt động sang một kênh được liên kết khác. Xem Neo kênh để biết cách thiết lập và khắc phục sự cố.

Được tạo từ các plugin kênh hỗ trợ lệnh gốc:

• /dock-discord (bí danh: /dock_discord)
• /dock-mattermost (bí danh: /dock_mattermost)
• /dock-slack (bí danh: /dock_slack)
• /dock-telegram (bí danh: /dock_telegram)

Lệnh neo kênh yêu cầu session.identityLinks. Người gửi nguồn và đối tượng ngang hàng đích phải thuộc cùng một nhóm danh tính.

Lệnh plugin đi kèm

Chỉ dành cho QQBot: /bot-ping, /bot-version, /bot-help, /bot-upgrade, /bot-logs

Lệnh skill

Các skill mà người dùng có thể gọi được cung cấp dưới dạng lệnh dấu gạch chéo:

• /skill <name> [input] luôn hoạt động như điểm vào chung.
• Skills có thể đăng ký làm lệnh trực tiếp (ví dụ: /prose cho OpenProse).
• Việc đăng ký lệnh skill gốc được kiểm soát bởi commands.nativeSkills và channels.<provider>.commands.nativeSkills.
• Tên được chuẩn hóa thành a-z0-9_ (tối đa 32 ký tự); tên trùng nhau sẽ nhận hậu tố số.

/tools: tác tử có thể sử dụng gì ngay lúc này

/tools trả lời một câu hỏi về runtime: tác tử này có thể sử dụng gì ngay lúc này trong cuộc trò chuyện này — không phải danh mục cấu hình tĩnh.

/tools         # chế độ xem thu gọn/tools verbose # kèm mô tả ngắn

Kết quả có phạm vi theo phiên. 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 kết quả. Để chỉnh sửa hồ sơ và giá trị ghi đè, hãy sử dụng bảng Công cụ trong Giao diện điều khiển hoặc các bề mặt cấu hình.

/model: lựa chọn mô hình

/model             # hiển thị trình chọn mô hình/model list        # tương tự/model 3           # chọn theo số từ trình chọn/model openai/gpt-5.4/model opus@anthropic:default/model default     # xóa lựa chọn mô hình của phiên/model status      # chế độ xem chi tiết với điểm cuối và chế độ API

Trên Discord, /model và /models mở một trình chọn tương tác có danh sách thả xuống cho nhà cung cấp và mô hình. Trình chọn tuân theo agents.defaults.modelPolicy.allow, bao gồm các mục provider/*. Khi không có danh sách cho phép rõ ràng, các mục mô hình và bí danh không hạn chế việc lựa chọn.

/config: ghi cấu hình trên đĩa

/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.

/mcp: cấu hình máy chủ MCP

/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 trong phần cài đặt dự án của tác tử nhúng. /mcp show che các trường chứa thông tin xác thực, giá trị của các cờ thông tin xác thực được nhận diện và các đối số có dạng bí mật đã biết. Khi chạy từ một nhóm, cấu hình được gửi riêng cho chủ sở hữu; nếu không có tuyến riêng tư nào đến chủ sở hữu, lệnh sẽ từ chối an toàn và yêu cầu chủ sở hữu thử lại từ cuộc trò chuyện trực tiếp.

/debug: giá trị ghi đè chỉ dành cho runtime

/debug show/debug set messages.responsePrefix="[openclaw]"/debug set channels.whatsapp.allowFrom=["+1555","+4477"]/debug unset messages.responsePrefix/debug reset

/plugins: quản lý plugin

/plugins/plugins list/plugin show context7/plugins enable context7/plugins disable context7/plugins install clawhub:<package>/plugins install npm:@openclaw/<official-package>/plugins install npm:<package> --force/plugins install git:<repository>@<ref> --force

/plugins enable|disable cập nhật cấu hình plugin và tải lại nóng runtime plugin của Gateway cho các lượt tác tử mới. /plugins install tự động khởi động lại các Gateway được quản lý vì các mô-đun nguồn của plugin đã thay đổi. Việc cài đặt từ ClawHub đáng tin cậy và danh mục chính thức không cần xác nhận bổ sung. Các nguồn npm, git, kho lưu trữ, npm-pack: và đường dẫn cục bộ tùy ý sẽ hiển thị cảnh báo nguồn gốc và yêu cầu --force ở cuối sau khi bạn review nguồn. Cờ này xác nhận nguồn và cho phép thay thế một bản cài đặt hiện có; nó không bỏ qua security.installPolicy hoặc các kiểm tra bảo mật của trình cài đặt. Các bản phát hành ClawHub có cảnh báo rủi ro vẫn yêu cầu cờ --acknowledge-clawhub-risk riêng biệt, chỉ dùng trong shell. Các bản cài đặt từ marketplace, được liên kết và được ghim cũng vẫn chỉ dùng trong shell.

/trace: đầu ra theo dõi plugin

/trace          # hiển thị trạng thái theo dõi hiện tại/trace on/trace off

/trace hiển thị các dòng theo dõi/gỡ lỗi plugin có phạm vi theo phiên mà không cần chế độ chi tiết đầy đủ. Nó không thay thế /debug (giá trị ghi đè runtime) hoặc /verbose (đầu ra công cụ thông thường).

/btw: câu hỏi phụ

/btw là câu hỏi phụ nhanh về ngữ cảnh phiên hiện tại. Bí danh: /side.

/btw hiện tại chúng ta đang làm gì?/side điều gì đã thay đổi trong khi lượt chạy chính vẫn tiếp tục?

Không giống một tin nhắn thông thường:

• Sử dụng phiên hiện tại làm ngữ cảnh nền.
• Trong các phiên bộ khung Codex, chạy dưới dạng một luồng phụ Codex tạm thời.
• Không thay đổi ngữ cảnh phiên trong tương lai.
• Không được ghi vào lịch sử bản chép lời.

Xem Câu hỏi phụ BTW để biết toàn bộ hành vi.

Ghi chú về bề mặt

Mức sử dụng và trạng thái của nhà cung cấp

• Mức sử dụng/hạn mức của nhà cung cấp (ví dụ: "Claude còn 80%") hiển thị trong /status đối với nhà cung cấp của mô hình hiện tại khi tính năng theo dõi mức sử dụng được bật.
• Các dòng token/bộ nhớ đệm trong /status có thể dùng mục mức sử dụng mới nhất trong bản ghi phiên làm phương án dự phòng khi ảnh chụp nhanh của phiên trực tiếp có ít dữ liệu.
• Môi trường thực thi và thời gian chạy: /status báo cáo Execution cho đường dẫn sandbox có hiệu lực và Runtime cho biết thành phần đang chạy phiên: OpenClaw Default, OpenAI Codex, một backend CLI hoặc một backend ACP.
• Token/chi phí theo từng phản hồi: được kiểm soát bởi /usage off|tokens|full.
• /model status liên quan đến mô hình/xác thực/điểm cuối, không phải mức sử dụng.

Liên quan