Tài liệu tham khảo CLI

Trang này mô tả hành vi CLI hiện tại. Nếu các lệnh thay đổi, hãy cập nhật tài liệu này.

Các trang lệnh

Cờ toàn cục

  • --dev: cô lập trạng thái trong ~/.openclaw-dev và thay đổi cổng mặc định.
  • --profile <name>: cô lập trạng thái trong ~/.openclaw-<name>.
  • --no-color: tắt màu ANSI.
  • --update: viết tắt của openclaw update (chỉ cho cài đặt từ source).
  • -V, --version, -v: in phiên bản và thoát.

Định dạng đầu ra

  • Màu ANSI và thanh tiến trình chỉ hiển thị trong phiên TTY.
  • Hyperlink OSC-8 hiển thị dưới dạng link có thể click trong terminal hỗ trợ; nếu không sẽ fallback về URL thuần.
  • --json (và --plain nếu được hỗ trợ) tắt định dạng để có đầu ra sạch.
  • --no-color tắt định dạng ANSI; NO_COLOR=1 cũng được hỗ trợ.
  • Các lệnh chạy lâu sẽ hiển thị thanh 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, highlight chính.
  • accentBright (#FF7A3D): tên lệnh, nhấn mạnh.
  • accentDim (#D14A22): văn bản highlight phụ.
  • info (#FF8A5B): giá trị thông tin.
  • success (#2FBF71): trạng thái thành công.
  • warn (#FFB020): cảnh báo, fallback, chú ý.
  • error (#E23D2D): lỗi, thất bại.
  • muted (#8B7F77): giảm nhấn mạnh, metadata.

Nguồn chính thức của bảng màu: src/terminal/palette.ts (còn gọi là “lobster seam”).

Cây lệnh

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  doctor
  security
    audit
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  skills
    list
    info
    check
  plugins
    list
    info
    install
    enable
    disable
    doctor
  memory
    status
    index
    search
  message
  agent
  agents
    list
    add
    delete
  acp
  status
  health
  sessions
  gateway
    call
    health
    status
    probe
    discover
    install
    uninstall
    start
    stop
    restart
    run
  logs
  system
    event
    heartbeat last|enable|disable
    presence
  models
    list
    status
    set
    set-image
    aliases list|add|remove
    fallbacks list|add|remove|clear
    image-fallbacks list|add|remove|clear
    scan
    auth add|setup-token|paste-token
    auth order get|set|clear
  sandbox
    list
    recreate
    explain
  cron
    status
    list
    add
    edit
    rm
    enable
    disable
    runs
    run
  nodes
  devices
  node
    run
    status
    install
    uninstall
    start
    stop
    restart
  approvals
    get
    set
    allowlist add|remove
  browser
    status
    start
    stop
    reset-profile
    tabs
    open
    focus
    close
    profiles
    create-profile
    delete-profile
    screenshot
    snapshot
    navigate
    resize
    click
    type
    press
    hover
    drag
    select
    upload
    fill
    dialog
    wait
    evaluate
    console
    pdf
  hooks
    list
    info
    check
    enable
    disable
    install
    update
  webhooks
    gmail setup|run
  pairing
    list
    approve
  docs
  dns
    setup
  tui

Lưu ý: các plugin có thể thêm lệnh cấp cao nhất (ví dụ openclaw voicecall).

Security

  • openclaw security audit — kiểm tra config + trạng thái local để tìm các lỗ hổng bảo mật phổ biến.
  • openclaw security audit --deep — thăm dò Gateway trực tiếp (best-effort).
  • openclaw security audit --fix — tăng cường các cài đặt mặc định an toàn và chmod state/config.

Plugins

Quản lý các extension và cấu hình của chúng:

  • openclaw plugins list — khám phá các plugin (dùng --json cho đầu ra máy).
  • openclaw plugins info <id> — hiển thị chi tiết của một plugin.
  • openclaw plugins install <path|.tgz|npm-spec> — cài đặt plugin (hoặc thêm đường dẫn plugin vào plugins.load.paths).
  • openclaw plugins enable <id> / disable <id> — bật/tắt plugins.entries.<id>.enabled.
  • openclaw plugins doctor — báo cáo lỗi tải plugin.

Hầu hết các thay đổi plugin đều yêu cầu khởi động lại gateway. Xem /plugin.

Memory

Tìm kiếm vector trên MEMORY.md + memory/*.md:

  • openclaw memory status — hiển thị thống kê index.
  • openclaw memory index — đánh index lại các file memory.
  • openclaw memory search "<query>" — tìm kiếm ngữ nghĩa trên memory.

Lệnh slash trong chat

Tin nhắn chat hỗ trợ lệnh /... (văn bản và native). Xem /tools/slash-commands.

Điểm nổi bật:

  • /status để chẩn đoán nhanh.
  • /config để thay đổi config lưu trữ.
  • /debug để ghi đè config chỉ trong runtime (memory, không ghi disk; yêu cầu commands.debug: true).

Setup + onboarding

setup

Khởi tạo config + workspace.

Tùy chọn:

  • --workspace <dir>: đường dẫn workspace của agent (mặc định ~/.openclaw/workspace).
  • --wizard: chạy wizard onboarding.
  • --non-interactive: chạy wizard không có prompt.
  • --mode <local|remote>: chế độ wizard.
  • --remote-url <url>: URL Gateway từ xa.
  • --remote-token <token>: token Gateway từ xa.

Wizard tự động chạy khi có bất kỳ cờ wizard nào (--non-interactive, --mode, --remote-url, --remote-token).

onboard

Wizard tương tác để thiết lập gateway, workspace và skills.

Tùy chọn:

  • --workspace <dir>
  • --reset (reset config + credentials + sessions + workspace trước wizard)
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual> (manual là alias của advanced)
  • --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ai-gateway-api-key|moonshot-api-key|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|skip>
  • --token-provider <id> (non-interactive; dùng với --auth-choice token)
  • --token <token> (non-interactive; dùng với --auth-choice token)
  • --token-profile-id <id> (non-interactive; mặc định: <provider>:manual)
  • --token-expires-in <duration> (non-interactive; ví dụ 365d, 12h)
  • --anthropic-api-key <key>
  • --openai-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>
  • --gateway-port <port>
  • --gateway-bind <loopback|lan|tailnet|auto|custom>
  • --gateway-auth <token|password>
  • --gateway-token <token>
  • --gateway-password <password>
  • --remote-url <url>
  • --remote-token <token>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --install-daemon
  • --no-install-daemon (alias: --skip-daemon)
  • --daemon-runtime <node|bun>
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun> (khuyên dùng pnpm; không khuyên dùng bun cho Gateway runtime)
  • --json

configure

Wizard cấu hình tương tác (models, channels, skills, gateway).

config

Các helper config không tương tác (get/set/unset). Chạy openclaw config không có lệnh con sẽ mở wizard.

Lệnh con:

  • config get <path>: in giá trị config (đường dẫn dot/bracket).
  • config set <path> <value>: đặt giá trị (JSON5 hoặc chuỗi thô).
  • config unset <path>: xóa giá trị.

doctor

Kiểm tra sức khỏe + sửa nhanh (config + gateway + legacy services).

Tùy chọn:

  • --no-workspace-suggestions: tắt gợi ý memory workspace.
  • --yes: chấp nhận mặc định không hỏi (headless).
  • --non-interactive: bỏ qua prompt; chỉ áp dụng migration an toàn.
  • --deep: quét system services để tìm cài đặt gateway thêm.

Channel helpers

channels

Quản lý tài khoản channel chat (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/MS Teams).

Lệnh con:

  • channels list: hiển thị các channel đã cấu hình và auth profiles.
  • channels status: kiểm tra khả năng kết nối gateway và sức khỏe channel (--probe chạy kiểm tra thêm; dùng openclaw health hoặc openclaw status --deep để thăm dó sức khỏe gateway).
  • Mẹo: channels status in cảnh báo với các sửa chữa được đề xuất khi phát hiện cấu hình sai phổ biến (sau đó chỉ bạn đến openclaw doctor).
  • channels logs: hiển thị log channel gần đây từ file log gateway.
  • channels add: thiết lập kiểu wizard khi không có cờ; các cờ chuyển sang chế độ non-interactive.
  • channels remove: tắt theo mặc định; dùng --delete để xóa các mục config không hỏi.
  • channels login: đăng nhập channel tương tác (chỉ WhatsApp Web).
  • channels logout: đăng xuất khỏi session channel (nếu được hỗ trợ).

Tùy chọn chung:

  • --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>: id tài khoản channel (mặc định default)
  • --name <label>: tên hiển thị cho tài khoản

Tùy chọn channels login:

  • --channel <channel> (mặc định whatsapp; hỗ trợ whatsapp/web)
  • --account <id>
  • --verbose

Tùy chọn channels logout:

  • --channel <channel> (mặc định whatsapp)
  • --account <id>

Tùy chọn channels list:

  • --no-usage: bỏ qua snapshot usage/quota của model provider (chỉ OAuth/API-backed).
  • --json: đầu ra JSON (bao gồm usage trừ khi đặt --no-usage).

Tùy chọn channels logs:

  • --channel <name|all> (mặc định all)
  • --lines <n> (mặc định 200)
  • --json

Chi tiết thêm: /concepts/oauth

Ví dụ:

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep

skills

Liệt kê và kiểm tra các skill có sẵn cùng thông tin sẵn sàng.

Lệnh con:

  • skills list: liệt kê skills (mặc định khi không có lệnh con).
  • skills info <name>: hiển thị chi tiết cho một skill.
  • skills check: tóm tắt các skill sẵn sàng vs thiếu yêu cầu.

Tùy chọn:

  • --eligible: chỉ hiển thị các skill sẵn sàng.
  • --json: đầu ra JSON (không định dạng).
  • -v, --verbose: bao gồm chi tiết yêu cầu còn thiếu.

Mẹo: dùng npx clawhub để tìm kiếm, cài đặt và đồng bộ skills.

pairing

Phê duyệt các yêu cầu pairing DM qua các channel.

Lệnh con:

  • pairing list <channel> [--json]
  • pairing approve <channel> <code> [--notify]

webhooks gmail

Thiết lập + runner hook Gmail Pub/Sub. 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ác cờ tương tự)

dns setup

Helper 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 config CoreDNS (yêu cầu sudo; chỉ macOS).

Messaging + agent

message

Messaging gửi đi thống nhất + các hành động channel.

Xem: /cli/message

Lệnh con:

  • message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
  • message thread <create|list|reply>
  • message emoji <list|upload>
  • message sticker <send|upload>
  • message role <info|add|remove>
  • message channel <info|list>
  • message member info
  • message voice status
  • message event <list|create>

Ví dụ:

  • 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 qua Gateway (hoặc --local nhúng).

Bắt buộc:

  • --message <text>

Tùy chọn:

  • --to <dest> (cho session key và delivery tùy chọn)
  • --session-id <id>
  • --thinking <off|minimal|low|medium|high|xhigh> (chỉ model 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 + auth + routing).

agents list

Liệt kê các agent đã cấu hình.

Tùy chọn:

  • --json
  • --bindings

agents add [name]

Thêm agent cô lập mới. Chạy wizard hướng dẫn trừ khi có cờ (hoặc --non-interactive); --workspace là bắt buộc trong chế độ non-interactive.

Tùy chọn:

  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]> (có thể lặp lại)
  • --non-interactive
  • --json

Binding specs dùng channel[:accountId]. Khi accountId bị bỏ qua cho WhatsApp, id tài khoản mặc định được dùng.

agents delete <id>

Xóa agent và dọn dẹp workspace + state của nó.

Tùy chọn:

  • --force
  • --json

acp

Chạy cầu nối ACP kết nối các IDE với Gateway.

Xem acp để biết đầy đủ tùy chọn và ví dụ.

status

Hiển thị sức khỏe session đã 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ể paste)
  • --deep (thăm dò channels)
  • --usage (hiển thị usage/quota của model provider)
  • --timeout <ms>
  • --verbose
  • --debug (alias của --verbose)

Lưu ý:

  • Tổng quan bao gồm trạng thái Gateway + node host service khi có sẵn.

Theo dõi usage

OpenClaw có thể hiển thị usage/quota của provider khi có OAuth/API creds.

Bề mặt:

  • /status (thêm dòng usage provider ngắn khi có sẵn)
  • openclaw status --usage (in phân tích provider đầy đủ)
  • thanh menu macOS (phần Usage trong Context)

Lưu ý:

  • Dữ liệu đến trực tiếp từ các endpoint usage của provider (không ước tính).
  • Providers: Anthropic, GitHub Copilot, OpenAI Codex OAuth, cộng với Gemini CLI/Antigravity khi các plugin provider đó được bật.
  • Nếu không có credentials phù hợp, usage sẽ bị ẩn.
  • Chi tiết: xem Usage tracking.

health

Lấy health từ Gateway đang chạy.

Tùy chọn:

  • --json
  • --timeout <ms>
  • --verbose

sessions

Liệt kê các session hội thoại đã lưu.

Tùy chọn:

  • --json
  • --verbose
  • --store <path>
  • --active <minutes>

Reset / Uninstall

reset

Reset config/state local (giữ CLI đã cài).

Tùy chọn:

  • --scope <config|config+creds+sessions|full>
  • --yes
  • --non-interactive
  • --dry-run

Lưu ý:

  • --non-interactive yêu cầu --scope và --yes.

uninstall

Gỡ cài đặt gateway service + dữ liệu local (CLI vẫn còn).

Tùy chọn:

  • --service
  • --state
  • --workspace
  • --app
  • --all
  • --yes
  • --non-interactive
  • --dry-run

Lưu ý:

  • --non-interactive yêu cầu --yes và scope rõ ràng (hoặc --all).

Gateway

gateway

Chạy WebSocket Gateway.

Tùy chọn:

  • --port <port>
  • --bind <loopback|tailnet|lan|auto|custom>
  • --token <token>
  • --auth <token|password>
  • --password <password>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --allow-unconfigured
  • --dev
  • --reset (reset dev config + credentials + sessions + workspace)
  • --force (kill listener hiện có trên port)
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact (alias của --ws-log compact)
  • --raw-stream
  • --raw-stream-path <path>

gateway service

Quản lý Gateway service (launchd/systemd/schtasks).

Lệnh con:

  • gateway status (thăm dò Gateway RPC theo mặc định)
  • gateway install (cài đặt service)
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart

Lưu ý:

  • gateway status thăm dò Gateway RPC theo mặc định bằng port/config đã resolve của service (ghi đè bằng --url/--token/--password).
  • gateway status hỗ trợ --no-probe, --deep và --json cho scripting.
  • gateway status cũng hiển thị các gateway service legacy hoặc thêm khi có thể phát hiện chúng (--deep thêm quét cấp system). Các OpenClaw service có tên profile được coi là first-class và không được đánh dấu là “extra”.
  • gateway status in đường dẫn config mà CLI dùng vs config mà service có thể dùng (service env), cộng với URL target probe đã resolve.
  • gateway install|uninstall|start|stop|restart hỗ trợ --json cho scripting (đầu ra mặc định vẫn thân thiện với người dùng).
  • gateway install mặc định là Node runtime; bun không được khuyến nghị (lỗi WhatsApp/Telegram).
  • Tùy chọn gateway install: --port, --runtime, --token, --force, --json.

logs

Tail log file Gateway qua RPC.

Lưu ý:

  • Phiên TTY hiển thị view có cấu trúc, màu sắc; non-TTY fallback về văn bản thuần.
  • --json xuất JSON phân tách dòng (một sự kiện log mỗi dòng).

Ví dụ:

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

gateway <subcommand>

Gateway CLI helpers (dùng --url, --token, --password, --timeout, --expect-final cho các lệnh con RPC).

Lệnh con:

  • gateway call <method> [--params <json>]
  • gateway health
  • gateway status
  • gateway probe
  • gateway discover
  • gateway install|uninstall|start|stop|restart
  • gateway run

RPC phổ biến:

  • config.apply (validate + ghi config + restart + wake)
  • config.patch (merge cập nhật một phần + restart + wake)
  • update.run (chạy update + restart + wake)

Mẹo: khi gọi config.set/config.apply/config.patch trực tiếp, truyền baseHash từ config.get nếu config đã tồn tại.

Models

Xem /concepts/models để biết hành vi fallback và chiến lược quét.

Auth Anthropic ưu tiên (setup-token):

claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models status

models (root)

openclaw models là alias của models status.

Tùy chọn root:

  • --status-json (alias của models status --json)
  • --status-plain (alias của models status --plain)

models list

Tùy chọn:

  • --all
  • --local
  • --provider <name>
  • --json
  • --plain

models status

Tùy chọn:

  • --json
  • --plain
  • --check (exit 1=expired/missing, 2=expiring)
  • --probe (thăm dò trực tiếp các auth profile đã 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>

Luôn bao gồm tổng quan auth và trạng thái hết hạn OAuth cho các profile trong auth store. --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, --plain
  • add <alias> <model>
  • remove <alias>

models fallbacks list|add|remove|clear

Tùy chọn:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear

Tùy chọn:

  • list: --json, --plain
  • add <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: helper auth tương tác
  • setup-token: --provider <name> (mặc định anthropic), --yes
  • paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

models auth order get|set|clear

Tùy chọn:

  • get: --provider <name>, --agent <id>, --json
  • set: --provider <name>, --agent <id>, <profileIds...>
  • clear: --provider <name>, --agent <id>

System

system event

Đưa sự kiện system vào hàng đợi và tùy chọn kích hoạt heartbeat (Gateway RPC).

Bắt buộc:

  • --text <text>

Tùy chọn:

  • --mode <now|next-heartbeat>
  • --json
  • --url, --token, --timeout, --expect-final

system heartbeat last|enable|disable

Điều khiển heartbeat (Gateway RPC).

Tùy chọn:

  • --json
  • --url, --token, --timeout, --expect-final

system presence

Liệt kê các mục system presence (Gateway RPC).

Tùy chọn:

  • --json
  • --url, --token, --timeout, --expect-final

Cron

Quản lý các job đã lên lịch (Gateway RPC). Xem /automation/cron-jobs.

Lệnh con:

  • cron status [--json]
  • cron list [--all] [--json] (đầu ra bảng theo mặc định; dùng --json cho raw)
  • cron add (alias: create; yêu cầu --name và 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> (patch các trường)
  • cron rm <id> (aliases: remove, delete)
  • cron enable <id>
  • cron disable <id>
  • cron runs --id <id> [--limit <n>]
  • cron run <id> [--force]

Tất cả lệnh cron chấp nhận --url, --token, --timeout, --expect-final.

Node host

node chạy headless node host hoặc quản lý nó như một background service. Xem openclaw node.

Lệnh con:

  • node run --host <gateway-host> --port 18789
  • node status
  • node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
  • node uninstall
  • node stop
  • node restart

Nodes

nodes giao tiếp với Gateway và nhắm đến các node đã pairing. Xem /nodes.

Tùy chọn chung:

  • --url, --token, --timeout, --json

Lệnh con:

  • nodes status [--connected] [--last-connected <duration>]
  • nodes describe --node <id|name|ip>
  • nodes list [--connected] [--last-connected <duration>]
  • nodes pending
  • nodes 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...> (mac node hoặc headless node host)
  • 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)

Camera:

  • 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>]

Canvas + screen:

  • 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>]

Location:

  • nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

Browser

Điều khiển browser CLI (Chrome/Brave/Edge/Chromium chuyên dụng). Xem openclaw browser và Browser tool.

Tùy chọn chung:

  • --url, --token, --timeout, --json
  • --browser-profile <name>

Quản lý:

  • browser status
  • browser start
  • browser stop
  • browser reset-profile
  • browser tabs
  • browser open <url>
  • browser focus <targetId>
  • browser close [targetId]
  • browser profiles
  • browser create-profile --name <name> [--color <hex>] [--cdp-url <url>]
  • browser delete-profile --name <name>

Kiểm tra:

  • 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>]

Hành động:

  • 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 docs

docs [query...]

Tìm kiếm trong index docs trực tiếp.

TUI

tui

Mở giao diện 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>

models fallbacks list|add|remove|clear

Tùy chọn:

  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear

Tùy chọn:

  • list: --json, --plain
  • add <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