Documentation Index
Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
Use this file to discover all available pages before exploring further.
Tham khảo CLI
Trang này mô tả hành vi hiện tại của CLI. Nếu có thay đổi lệnh, hãy cập nhật tài liệu này.Trang lệnh
setuponboardconfigureconfigcompletiondoctordashboardbackupresetuninstallupdatemessageagentagentsacpstatushealthsessionsgatewaylogssystemmodelsmemorydirectorynodesdevicesnodeapprovalssandboxtuibrowsercrondnsdocshookswebhookspairingqrplugins(lệnh plugin)channelssecuritysecretsskillsdaemon(bí danh cũ cho lệnh dịch vụ gateway)clawbot(namespace bí danh cũ)voicecall(plugin; nếu đã cài đặt)
Cờ toàn cục
--dev: cô lập trạng thái dưới~/.openclaw-devvà thay đổi cổng mặc định.--profile <name>: cô lập trạng thái dưới~/.openclaw-<name>.--no-color: tắt màu ANSI.--update: viết tắt choopenclaw update(chỉ cài đặt từ nguồn).-V,--version,-v: in phiên bản và thoát.
Định dạng đầu ra
- Màu ANSI và chỉ báo tiến trình chỉ hiển thị trong các phiên TTY.
- Liên kết OSC-8 hiển thị dưới dạng liên kết có thể nhấp trong các terminal hỗ trợ; nếu không, sẽ quay lại URL thông thường.
--json(và--plainnếu được hỗ trợ) tắt định dạng để có đầu ra sạch.--no-colortắt định dạng ANSI;NO_COLOR=1cũng được tôn trọng.- Các lệnh chạy lâu hiển thị chỉ báo tiến trình (OSC 9;4 khi được hỗ trợ).
Bảng màu
OpenClaw sử dụng bảng màu lobster cho đầu ra CLI.accent(#FF5A2D): tiêu đề, nhãn, điểm nhấn chính.accentBright(#FF7A3D): tên lệnh, nhấn mạnh.accentDim(#D14A22): văn bản nổi bật thứ cấp.info(#FF8A5B): giá trị thông tin.success(#2FBF71): trạng thái thành công.warn(#FFB020): cảnh báo, dự phòng, chú ý.error(#E23D2D): lỗi, thất bại.muted(#8B7F77): giảm nhấn mạnh, siêu dữ liệu.
src/terminal/palette.ts (bảng màu “lobster”).
Cây lệnh
openclaw voicecall).
Bảo mật
openclaw security audit— kiểm tra cấu hình + trạng thái cục bộ để phát hiện các lỗi bảo mật phổ biến.openclaw security audit --deep— nỗ lực tốt nhất để thăm dò Gateway trực tiếp.openclaw security audit --fix— thắt chặt các mặc định an toàn và chmod trạng thái/cấu hình.
Secrets
openclaw secrets reload— giải quyết lại các tham chiếu và hoán đổi ảnh chụp nhanh runtime một cách nguyên tử.openclaw secrets audit— quét các dư lượng văn bản thuần túy, tham chiếu chưa được giải quyết và sự trôi dạt ưu tiên (--allow-execđể thực thi các nhà cung cấp exec trong quá trình kiểm tra).openclaw secrets configure— trợ giúp tương tác cho thiết lập nhà cung cấp + ánh xạ SecretRef + kiểm tra trước/áp dụng (--allow-execđể thực thi các nhà cung cấp exec trong các luồng kiểm tra trước và áp dụng có chứa exec).openclaw secrets apply --from <plan.json>— áp dụng một kế hoạch đã được tạo trước đó (--dry-runđược hỗ trợ; sử dụng--allow-execđể cho phép các nhà cung cấp exec trong các kế hoạch ghi chạy thử và có chứa exec).
Plugins
Quản lý các tiện ích mở rộng và cấu hình của chúng:openclaw plugins list— khám phá các plugin (sử dụng--jsonđể có đầu ra máy).openclaw plugins inspect <id>— hiển thị chi tiết cho một plugin (infolà một bí danh).openclaw plugins install <path|.tgz|npm-spec|plugin@marketplace>— cài đặt một plugin (hoặc thêm đường dẫn plugin vàoplugins.load.paths).openclaw plugins marketplace list <marketplace>— liệt kê các mục trong marketplace trước khi cài đặt.openclaw plugins enable <id>/disable <id>— chuyển đổiplugins.entries.<id>.enabled.openclaw plugins doctor— báo cáo lỗi tải plugin.
Memory
Tìm kiếm vector quaMEMORY.md + memory/*.md:
openclaw memory status— hiển thị thống kê chỉ mục.openclaw memory index— lập chỉ mục lại các tệp nhớ.openclaw memory search "<query>"(hoặc--query "<query>") — tìm kiếm ngữ nghĩa qua bộ nhớ.
Lệnh gạch chéo trong chat
Tin nhắn chat hỗ trợ các lệnh/... (văn bản và gốc). Xem /tools/slash-commands.
Điểm nổi bật:
/statusđể chẩn đoán nhanh./configđể thay đổi cấu hình được lưu trữ./debugđể ghi đè cấu hình chỉ trong runtime (bộ nhớ, không phải đĩa; yêu cầucommands.debug: true).
Thiết lập + onboarding
setup
Khởi tạo cấu hình + workspace.
Tùy chọn:
--workspace <dir>: đường dẫn workspace của agent (mặc định~/.openclaw/workspace).--wizard: chạy onboarding.--non-interactive: chạy onboarding không có nhắc nhở.--mode <local|remote>: chế độ onboard.--remote-url <url>: URL Gateway từ xa.--remote-token <token>: token Gateway từ xa.
--non-interactive, --mode, --remote-url, --remote-token).
onboard
Onboarding tương tác cho gateway, workspace và kỹ năng.
Tùy chọn:
--workspace <dir>--reset(đặt lại cấu hình + thông tin xác thực + phiên trước khi onboarding)--reset-scope <config|config+creds+sessions|full>(mặc địnhconfig+creds+sessions; sử dụngfullđể cũng xóa workspace)--non-interactive--mode <local|remote>--flow <quickstart|advanced|manual>(manual là bí danh cho advanced)--auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ollama|ai-gateway-api-key|moonshot-api-key|moonshot-api-key-cn|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|mistral-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|opencode-go|custom-api-key|skip>--token-provider <id>(không tương tác; sử dụng với--auth-choice token)--token <token>(không tương tác; sử dụng với--auth-choice token)--token-profile-id <id>(không tương tác; mặc định:<provider>:manual)--token-expires-in <duration>(không tương tác; ví dụ:365d,12h)--secret-input-mode <plaintext|ref>(mặc địnhplaintext; sử dụngrefđể lưu trữ các tham chiếu môi trường mặc định của nhà cung cấp thay vì các khóa văn bản thuần túy)--anthropic-api-key <key>--openai-api-key <key>--mistral-api-key <key>--openrouter-api-key <key>--ai-gateway-api-key <key>--moonshot-api-key <key>--kimi-code-api-key <key>--gemini-api-key <key>--zai-api-key <key>--minimax-api-key <key>--opencode-zen-api-key <key>--opencode-go-api-key <key>--custom-base-url <url>(không tương tác; sử dụng với--auth-choice custom-api-keyhoặc--auth-choice ollama)--custom-model-id <id>(không tương tác; sử dụng với--auth-choice custom-api-keyhoặc--auth-choice ollama)--custom-api-key <key>(không tương tác; tùy chọn; sử dụng với--auth-choice custom-api-key; quay lạiCUSTOM_API_KEYkhi bị bỏ qua)--custom-provider-id <id>(không tương tác; id nhà cung cấp tùy chỉnh tùy chọn)--custom-compatibility <openai|anthropic>(không tương tác; tùy chọn; mặc địnhopenai)--gateway-port <port>--gateway-bind <loopback|lan|tailnet|auto|custom>--gateway-auth <token|password>--gateway-token <token>--gateway-token-ref-env <name>(không tương tác; lưugateway.auth.tokendưới dạng một env SecretRef; yêu cầu biến môi trường đó được đặt; không thể kết hợp với--gateway-token)--gateway-password <password>--remote-url <url>--remote-token <token>--tailscale <off|serve|funnel>--tailscale-reset-on-exit--install-daemon--no-install-daemon(bí danh:--skip-daemon)--daemon-runtime <node|bun>--skip-channels--skip-skills--skip-health--skip-ui--node-manager <npm|pnpm|bun>(pnpm được khuyến nghị; bun không được khuyến nghị cho runtime Gateway)--json
configure
Trình hướng dẫn cấu hình tương tác (mô hình, kênh, kỹ năng, gateway).
config
Trình trợ giúp cấu hình không tương tác (get/set/unset/file/validate). Chạy openclaw config mà không có
lệnh con sẽ khởi chạy trình hướng dẫn.
Lệnh con:
config get <path>: in một giá trị cấu hình (đường dẫn dot/bracket).config set: hỗ trợ bốn chế độ gán:- chế độ giá trị:
config set <path> <value>(phân tích cú pháp JSON5-hoặc-chuỗi) - chế độ xây dựng SecretRef:
config set <path> --ref-provider <provider> --ref-source <source> --ref-id <id> - chế độ xây dựng nhà cung cấp:
config set secrets.providers.<alias> --provider-source <env|file|exec> ... - chế độ hàng loạt:
config set --batch-json '<json>'hoặcconfig set --batch-file <path>
- chế độ giá trị:
config set --dry-run: xác thực các gán mà không ghiopenclaw.json(kiểm tra SecretRef exec bị bỏ qua theo mặc định).config set --allow-exec --dry-run: chọn tham gia kiểm tra SecretRef exec dry-run (có thể thực thi các lệnh của nhà cung cấp).config set --dry-run --json: phát ra đầu ra dry-run có thể đọc được bằng máy (kiểm tra + tín hiệu hoàn chỉnh, hoạt động, tham chiếu đã kiểm tra/bỏ qua, lỗi).config set --strict-json: yêu cầu phân tích cú pháp JSON5 cho đầu vào đường dẫn/giá trị.--jsonvẫn là một bí danh cũ cho phân tích cú pháp nghiêm ngặt ngoài chế độ đầu ra dry-run.config unset <path>: xóa một giá trị.config file: in đường dẫn tệp cấu hình đang hoạt động.config validate: xác thực cấu hình hiện tại so với lược đồ mà không khởi động gateway.config validate --json: phát ra đầu ra JSON có thể đọc được bằng máy.
doctor
Kiểm tra sức khỏe + sửa chữa nhanh (cấu hình + gateway + dịch vụ cũ).
Tùy chọn:
--no-workspace-suggestions: tắt gợi ý bộ nhớ workspace.--yes: chấp nhận mặc định mà không nhắc nhở (không đầu).--non-interactive: bỏ qua nhắc nhở; chỉ áp dụng các di chuyển an toàn.--deep: quét các dịch vụ hệ thống để tìm các cài đặt gateway bổ sung.
Trợ giúp kênh
channels
Quản lý tài khoản kênh chat (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Microsoft Teams).
Lệnh con:
channels list: hiển thị các kênh đã cấu hình và hồ sơ xác thực.channels status: kiểm tra khả năng truy cập gateway và sức khỏe kênh (--probechạy các kiểm tra bổ sung; sử dụngopenclaw healthhoặcopenclaw status --deepđể thăm dò sức khỏe gateway).- Mẹo:
channels statusin cảnh báo với các đề xuất sửa chữa khi nó có thể phát hiện các cấu hình sai phổ biến (sau đó chỉ bạn đếnopenclaw doctor). channels logs: hiển thị nhật ký kênh gần đây từ tệp nhật ký gateway.channels add: thiết lập kiểu wizard khi không có cờ nào được truyền; cờ chuyển sang chế độ không tương tác.- Khi thêm một tài khoản không mặc định vào một kênh vẫn sử dụng cấu hình cấp cao nhất cho một tài khoản, OpenClaw di chuyển các giá trị phạm vi tài khoản vào
channels.<channel>.accounts.defaulttrước khi ghi tài khoản mới. channels addkhông tương tác không tự động tạo/nâng cấp các ràng buộc; các ràng buộc chỉ kênh tiếp tục khớp với tài khoản mặc định.
- Khi thêm một tài khoản không mặc định vào một kênh vẫn sử dụng cấu hình cấp cao nhất cho một tài khoản, OpenClaw di chuyển các giá trị phạm vi tài khoản vào
channels remove: tắt theo mặc định; truyền--deleteđể xóa các mục cấu hình mà không cần nhắc nhở.channels login: đăng nhập kênh tương tác (chỉ WhatsApp Web).channels logout: đăng xuất khỏi phiên kênh (nếu được hỗ trợ).
--channel <name>:whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams--account <id>: id tài khoản kênh (mặc địnhdefault)--name <label>: tên hiển thị cho tài khoản
channels login:
--channel <channel>(mặc địnhwhatsapp; hỗ trợwhatsapp/web)--account <id>--verbose
channels logout:
--channel <channel>(mặc địnhwhatsapp)--account <id>
channels list:
--no-usage: bỏ qua ảnh chụp nhanh sử dụng/định mức của nhà cung cấp mô hình (chỉ hỗ trợ OAuth/API).--json: đầu ra JSON (bao gồm sử dụng trừ khi--no-usageđược đặt).
channels logs:
--channel <name|all>(mặc địnhall)--lines <n>(mặc định200)--json
skills
Liệt kê và kiểm tra các kỹ năng có sẵn cùng thông tin sẵn sàng.
Lệnh con:
skills list: liệt kê các kỹ năng (mặc định khi không có lệnh con).skills info <name>: hiển thị chi tiết cho một kỹ năng.skills check: tóm tắt các yêu cầu sẵn sàng so với thiếu.
--eligible: chỉ hiển thị các kỹ năng sẵn sàng.--json: đầu ra JSON (không có định dạng).-v,--verbose: bao gồm chi tiết yêu cầu thiếu.
npx clawhub để tìm kiếm, cài đặt và đồng bộ hóa kỹ năng.
pairing
Phê duyệt yêu cầu ghép đôi DM trên các kênh.
Lệnh con:
pairing list [channel] [--channel <channel>] [--account <id>] [--json]pairing approve <channel> <code> [--account <id>] [--notify]pairing approve --channel <channel> [--account <id>] <code> [--notify]
devices
Quản lý các mục ghép đôi thiết bị gateway và token thiết bị theo vai trò.
Lệnh con:
devices list [--json]devices approve [requestId] [--latest]devices reject <requestId>devices remove <deviceId>devices clear --yes [--pending]devices rotate --device <id> --role <role> [--scope <scope...>]devices revoke --device <id> --role <role>
webhooks gmail
Thiết lập hook Pub/Sub Gmail + runner. Xem /automation/gmail-pubsub.
Lệnh con:
webhooks gmail setup(yêu cầu--account <email>; hỗ trợ--project,--topic,--subscription,--label,--hook-url,--hook-token,--push-token,--bind,--port,--path,--include-body,--max-bytes,--renew-minutes,--tailscale,--tailscale-path,--tailscale-target,--push-endpoint,--json)webhooks gmail run(ghi đè runtime cho cùng các cờ)
dns setup
Trợ giúp DNS khám phá diện rộng (CoreDNS + Tailscale). Xem /gateway/discovery.
Tùy chọn:
--apply: cài đặt/cập nhật cấu hình CoreDNS (yêu cầu sudo; chỉ macOS).
Nhắn tin + agent
message
Nhắn tin ra ngoài hợp nhất + hành động kênh.
Xem: /cli/message
Lệnh con:
message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|banmessage thread <create|list|reply>message emoji <list|upload>message sticker <send|upload>message role <info|add|remove>message channel <info|list>message member infomessage voice statusmessage event <list|create>
openclaw message send --target +15555550123 --message "Hi"openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi
agent
Chạy một lượt agent thông qua Gateway (hoặc --local nhúng).
Yêu cầu:
--message <text>
--to <dest>(cho khóa phiên và tùy chọn giao hàng)--session-id <id>--thinking <off|minimal|low|medium|high|xhigh>(chỉ mô hình GPT-5.2 + Codex)--verbose <on|full|off>--channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>--local--deliver--json--timeout <seconds>
agents
Quản lý các agent cô lập (workspaces + xác thực + định tuyến).
agents list
Liệt kê các agent đã cấu hình.
Tùy chọn:
--json--bindings
agents add [name]
Thêm một agent cô lập mới. Chạy trình hướng dẫn có hướng dẫn trừ khi có cờ (hoặc --non-interactive) được truyền; --workspace là bắt buộc trong chế độ không tương tác.
Tùy chọn:
--workspace <dir>--model <id>--agent-dir <dir>--bind <channel[:accountId]>(lặp lại)--non-interactive--json
channel[:accountId]. Khi accountId bị bỏ qua, OpenClaw có thể giải quyết phạm vi tài khoản thông qua các mặc định kênh/plugin hooks; nếu không, đó là một ràng buộc kênh mà không có phạm vi tài khoản rõ ràng.
agents bindings
Liệt kê các ràng buộc định tuyến.
Tùy chọn:
--agent <id>--json
agents bind
Thêm các ràng buộc định tuyến cho một agent.
Tùy chọn:
--agent <id>--bind <channel[:accountId]>(lặp lại)--json
agents unbind
Xóa các ràng buộc định tuyến cho một agent.
Tùy chọn:
--agent <id>--bind <channel[:accountId]>(lặp lại)--all--json
agents delete <id>
Xóa một agent và cắt tỉa workspace + trạng thái của nó.
Tùy chọn:
--force--json
acp
Chạy cầu nối ACP kết nối IDE với Gateway.
Xem acp để biết đầy đủ tùy chọn và ví dụ.
status
Hiển thị sức khỏe phiên được liên kết và người nhận gần đây.
Tùy chọn:
--json--all(chẩn đoán đầy đủ; chỉ đọc, có thể dán)--deep(thăm dò các kênh)--usage(hiển thị sử dụng/định mức của nhà cung cấp mô hình)--timeout <ms>--verbose--debug(bí danh cho--verbose)
- Tổng quan bao gồm trạng thái dịch vụ máy chủ Gateway + node khi có sẵn.
Theo dõi sử dụng
OpenClaw có thể hiển thị sử dụng/định mức của nhà cung cấp khi có thông tin xác thực OAuth/API. Bề mặt:/status(thêm một dòng sử dụng nhà cung cấp ngắn khi có sẵn)openclaw status --usage(in đầy đủ phân tích nhà cung cấp)- thanh menu macOS (phần Sử dụng dưới Context)
- Dữ liệu đến trực tiếp từ các điểm cuối sử dụng của nhà cung cấp (không có ước tính).
- Nhà cung cấp: Anthropic, GitHub Copilot, OpenAI Codex OAuth, cộng với Gemini CLI thông qua plugin
googleđi kèm và Antigravity khi được cấu hình. - Nếu không có thông tin xác thực phù hợp, việc sử dụng sẽ bị ẩn.
- Chi tiết: xem Theo dõi sử dụng.
health
Lấy sức khỏe từ Gateway đang chạy.
Tùy chọn:
--json--timeout <ms>--verbose
sessions
Liệt kê các phiên hội thoại đã lưu trữ.
Tùy chọn:
--json--verbose--store <path>--active <minutes>
Đặt lại / Gỡ cài đặt
reset
Đặt lại cấu hình/trạng thái cục bộ (giữ CLI được cài đặt).
Tùy chọn:
--scope <config|config+creds+sessions|full>--yes--non-interactive--dry-run
--non-interactiveyêu cầu--scopevà--yes.
uninstall
Gỡ cài đặt dịch vụ gateway + dữ liệu cục bộ (CLI vẫn còn).
Tùy chọn:
--service--state--workspace--app--all--yes--non-interactive--dry-run
--non-interactiveyêu cầu--yesvà các phạm vi rõ ràng (hoặc--all).
Gateway
gateway
Chạy Gateway WebSocket.
Tùy chọn:
--port <port>--bind <loopback|tailnet|lan|auto|custom>--token <token>--auth <token|password>--password <password>--password-file <path>--tailscale <off|serve|funnel>--tailscale-reset-on-exit--allow-unconfigured--dev--reset(đặt lại cấu hình dev + thông tin xác thực + phiên + workspace)--force(giết listener hiện có trên cổng)--verbose--claude-cli-logs--ws-log <auto|full|compact>--compact(bí danh cho--ws-log compact)--raw-stream--raw-stream-path <path>
gateway service
Quản lý dịch vụ Gateway (launchd/systemd/schtasks).
Lệnh con:
gateway status(thăm dò RPC Gateway theo mặc định)gateway install(cài đặt dịch vụ)gateway uninstallgateway startgateway stopgateway restart
gateway statusthăm dò RPC Gateway theo mặc định sử dụng cổng/cấu hình đã giải quyết của dịch vụ (ghi đè bằng--url/--token/--password).gateway statushỗ trợ--no-probe,--deep,--require-rpc, và--jsoncho scripting.gateway statuscũng hiển thị các dịch vụ gateway cũ hoặc bổ sung khi nó có thể phát hiện chúng (--deepthêm các quét cấp hệ thống). Các dịch vụ OpenClaw được đặt tên theo hồ sơ được coi là hạng nhất và không bị gắn cờ là “bổ sung”.gateway statusin đường dẫn cấu hình mà CLI sử dụng so với cấu hình mà dịch vụ có thể sử dụng (môi trường dịch vụ), cộng với URL mục tiêu thăm dò đã giải quyết.- Nếu các SecretRefs xác thực gateway chưa được giải quyết trong đường dẫn lệnh hiện tại,
gateway status --jsonbáo cáorpc.authWarningchỉ khi kết nối thăm dò/xác thực thất bại (cảnh báo bị ẩn khi thăm dò thành công). - Trên các cài đặt Linux systemd, kiểm tra trôi dạt token trạng thái bao gồm cả nguồn
Environment=vàEnvironmentFile=của đơn vị. gateway install|uninstall|start|stop|restarthỗ trợ--jsoncho scripting (đầu ra mặc định vẫn thân thiện với con người).gateway installmặc định sử dụng runtime Node; bun không được khuyến nghị (lỗi WhatsApp/Telegram).- Tùy chọn
gateway install:--port,--runtime,--token,--force,--json.
logs
Theo dõi nhật ký tệp Gateway qua RPC.
Ghi chú:
- Các phiên TTY hiển thị chế độ xem có cấu trúc, có màu sắc; không TTY quay lại văn bản thuần túy.
--jsonphát ra JSON phân dòng (một sự kiện nhật ký mỗi dòng).
gateway <subcommand>
Trình trợ giúp CLI Gateway (sử dụng --url, --token, --password, --timeout, --expect-final cho các lệnh con RPC).
Khi bạn truyền --url, CLI không tự động áp dụng cấu hình hoặc thông tin xác thực môi trường.
Bao gồm --token hoặc --password một cách rõ ràng. Thiếu thông tin xác thực rõ ràng là một lỗi.
Lệnh con:
gateway call <method> [--params <json>]gateway healthgateway statusgateway probegateway discovergateway install|uninstall|start|stop|restartgateway run
config.apply(xác thực + ghi cấu hình + khởi động lại + đánh thức)config.patch(hợp nhất một bản cập nhật một phần + khởi động lại + đánh thức)update.run(chạy cập nhật + khởi động lại + đánh thức)
config.set/config.apply/config.patch trực tiếp, truyền baseHash từ
config.get nếu một cấu hình đã tồn tại.
Models
Xem /concepts/models để biết hành vi dự phòng và chiến lược quét. Thiết lập token Anthropic (được hỗ trợ):models (gốc)
openclaw models là một bí danh cho models status.
Tùy chọn gốc:
--status-json(bí danh chomodels status --json)--status-plain(bí danh chomodels status --plain)
models list
Tùy chọn:
--all--local--provider <name>--json--plain
models status
Tùy chọn:
--json--plain--check(thoát 1=hết hạn/thiếu, 2=sắp hết hạn)--probe(thăm dò trực tiếp các hồ sơ xác thực đã cấu hình)--probe-provider <name>--probe-profile <id>(lặp lại hoặc phân tách bằng dấu phẩy)--probe-timeout <ms>--probe-concurrency <n>--probe-max-tokens <n>
--probe chạy các yêu cầu trực tiếp (có thể tiêu thụ token và kích hoạt giới hạn tốc độ).
models set <model>
Đặt agents.defaults.model.primary.
models set-image <model>
Đặt agents.defaults.imageModel.primary.
models aliases list|add|remove
Tùy chọn:
list:--json,--plainadd <alias> <model>remove <alias>
models fallbacks list|add|remove|clear
Tùy chọn:
list:--json,--plainadd <model>remove <model>clear
models image-fallbacks list|add|remove|clear
Tùy chọn:
list:--json,--plainadd <model>remove <model>clear
models scan
Tùy chọn:
--min-params <b>--max-age-days <days>--provider <name>--max-candidates <n>--timeout <ms>--concurrency <n>--no-probe--yes--no-input--set-default--set-image--json
models auth add|setup-token|paste-token
Tùy chọn:
add: trợ giúp xác thực tương tácsetup-token:--provider <name>(mặc địnhanthropic),--yespaste-token:--provider <name>,--profile-id <id>,--expires-in <duration>
models auth order get|set|clear
Tùy chọn:
get:--provider <name>,--agent <id>,--jsonset:--provider <name>,--agent <id>,<profileIds...>clear:--provider <name>,--agent <id>
Hệ thống
system event
Xếp hàng một sự kiện hệ thống và tùy chọn kích hoạt một nhịp tim (RPC Gateway).
Yêu cầu:
--text <text>
--mode <now|next-heartbeat>--json--url,--token,--timeout,--expect-final
system heartbeat last|enable|disable
Điều khiển nhịp tim (RPC Gateway).
Tùy chọn:
--json--url,--token,--timeout,--expect-final
system presence
Liệt kê các mục hiện diện hệ thống (RPC Gateway).
Tùy chọn:
--json--url,--token,--timeout,--expect-final
Cron
Quản lý các công việc đã lên lịch (RPC Gateway). Xem /automation/cron-jobs. Lệnh con:cron status [--json]cron list [--all] [--json](đầu ra bảng theo mặc định; sử dụng--jsonđể có thô)cron add(bí danh:create; yêu cầu--namevà chính xác một trong--at|--every|--cron, và chính xác một payload của--system-event|--message)cron edit <id>(sửa các trường)cron rm <id>(bí danh:remove,delete)cron enable <id>cron disable <id>cron runs --id <id> [--limit <n>]cron run <id> [--force]
cron chấp nhận --url, --token, --timeout, --expect-final.
Máy chủ node
node chạy một máy chủ node không đầu hoặc quản lý nó như một dịch vụ nền. Xem
openclaw node.
Lệnh con:
node run --host <gateway-host> --port 18789node statusnode install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]node uninstallnode stopnode restart
nodegiải quyết xác thực gateway từ env/config (không có cờ--token/--password):OPENCLAW_GATEWAY_TOKEN/OPENCLAW_GATEWAY_PASSWORD, sau đógateway.auth.*. Trong chế độ cục bộ, máy chủ node cố ý bỏ quagateway.remote.*; tronggateway.mode=remote,gateway.remote.*tham gia theo các quy tắc ưu tiên từ xa.- Các biến môi trường
CLAWDBOT_GATEWAY_*cũ cố ý bị bỏ qua để giải quyết xác thực máy chủ node.
Nodes
nodes nói chuyện với Gateway và nhắm mục tiêu các node đã ghép đôi. Xem /nodes.
Tùy chọn phổ biến:
--url,--token,--timeout,--json
nodes status [--connected] [--last-connected <duration>]nodes describe --node <id|name|ip>nodes list [--connected] [--last-connected <duration>]nodes pendingnodes approve <requestId>nodes reject <requestId>nodes rename --node <id|name|ip> --name <displayName>nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...>(node mac hoặc máy chủ node không đầu)nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>](chỉ mac)
nodes camera list --node <id|name|ip>nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]
nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]
nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]
Trình duyệt
CLI điều khiển trình duyệt (Chrome/Brave/Edge/Chromium chuyên dụng). Xemopenclaw browser và Công cụ trình duyệt.
Tùy chọn phổ biến:
--url,--token,--timeout,--json--browser-profile <name>
browser statusbrowser startbrowser stopbrowser reset-profilebrowser tabsbrowser open <url>browser focus <targetId>browser close [targetId]browser profilesbrowser create-profile --name <name> [--color <hex>] [--cdp-url <url>]browser delete-profile --name <name>
browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]
browser navigate <url> [--target-id <id>]browser resize <width> <height> [--target-id <id>]browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]browser press <key> [--target-id <id>]browser hover <ref> [--target-id <id>]browser drag <startRef> <endRef> [--target-id <id>]browser select <ref> <values...> [--target-id <id>]browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]browser console [--level <error|warn|info>] [--target-id <id>]browser pdf [--target-id <id>]
Tìm kiếm tài liệu
docs [query...]
Tìm kiếm chỉ mục tài liệu trực tiếp.
TUI
tui
Mở giao diện người dùng terminal kết nối với Gateway.
Tùy chọn:
--url <url>--token <token>--password <password>--session <key>--deliver--thinking <level>--message <text>--timeout-ms <ms>(mặc định làagents.defaults.timeoutSeconds)--history-limit <n>