CLI 参?

此页面描述当?CLI 行为。如果命令更改，请更新此文档?

命令页面

全局标志

  • --dev：在 ~/.openclaw-dev 下隔离状态并转移默认端口?
  • --profile <name>：在 ~/.openclaw-<name> 下隔离状态?
  • --no-color：禁?ANSI 颜色?
  • --update：openclaw update 的简写（仅限源码安装）?
  • -V、--version、-v：打印版本并退出?

输出样式

  • ANSI 颜色和进度指示器仅在 TTY 会话中呈现?
  • OSC-8 超链接在支持的终端中呈现为可点击链接；否则我们回退到纯 URL?
  • --json（以及支持的 --plain）禁用样式以获得清晰输出?
  • --no-color 禁用 ANSI 样式；也尊重 NO_COLOR=1?
  • 长时间运行的命令显示进度指示器（OSC 9;4 如果支持）?

调色?

OpenClaw ?CLI 输出使用 lobster 调色板?

  • accent (#FF5A2D)：标题、标签、主要高亮?
  • accentBright (#FF7A3D)：命令名称、强调?
  • accentDim (#D14A22)：次要高亮文本?
  • info (#FF8A5B)：信息值?
  • success (#2FBF71)：成功状态?
  • warn (#FFB020)：警告、后备、注意?
  • error (#E23D2D)：错误、失败?
  • muted (#8B7F77)：去强调、元数据?

调色板的真相来源：src/terminal/palette.ts（又?“lobster seam”）?

命令?

openclaw [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  completion
  doctor
  dashboard
  security
    audit
  secrets
    reload
    migrate
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  directory
  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
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  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
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

注意：插件可以添加额外的顶级命令（例?openclaw voicecall）?

安全

  • openclaw security audit ?审计配置 + 本地状态的常见安全隐患?
  • openclaw security audit --deep ?尽最大努力进行网关实时探测?
  • openclaw security audit --fix ?收紧安全默认值并 chmod 状?配置?

密钥

  • openclaw secrets reload ?重新解析引用并原子交换运行时快照?
  • openclaw secrets audit ?扫描明文残留、未解析的引用和优先级漂移?
  • openclaw secrets configure ?用于提供商设?+ SecretRef 映射的交互式辅助程序 + 预检/应用?
  • openclaw secrets apply --from <plan.json> ?应用先前生成的计划（支持 --dry-run）?

插件

管理扩展及其配置?

  • openclaw plugins list ?发现插件（使?--json 获取机器输出）?
  • openclaw plugins info <id> ?显示插件的详细信息?
  • openclaw plugins install <path|.tgz|npm-spec> ?安装插件（或将插件路径添加到 plugins.load.paths）?
  • openclaw plugins enable <id> / disable <id> ?切换 plugins.entries.<id>.enabled?
  • openclaw plugins doctor ?报告插件加载错误?

大多数插件更改需要网关重启。请参阅 /plugin?

内存

?MEMORY.md + memory/*.md 进行向量搜索?

  • openclaw memory status ?显示索引统计信息?
  • openclaw memory index ?重新索引内存文件?
  • openclaw memory search "<query>"（或 --query "<query>"）?在内存上进行语义搜索?

聊天斜杠命令

聊天消息支持 /... 命令（文本和原生）。请参阅 /tools/slash-commands?

要点?

  • /status 用于快速诊断?
  • /config 用于持久化的配置更改?
  • /debug 用于仅运行时配置覆盖（内存中，不在磁盘；需?commands.debug: true）?

设置 + 入职

setup

初始化配?+ 工作区?

选项?

  • --workspace <dir>：代理工作区路径（默?~/.openclaw/workspace）?
  • --wizard：运行入职向导?
  • --non-interactive：运行向导而不提示?
  • --mode <local|remote>：向导模式?
  • --remote-url <url>：远程网?URL?
  • --remote-token <token>：远程网关令牌?

当存在任何向导标志（--non-interactive、--mode、--remote-url、--remote-token）时，向导自动运行?

onboard

交互式向导，用于设置网关、工作区和技能?

选项?

  • --workspace <dir>
  • --reset（重置配?+ 凭据 + 会话，然后在向导之前?
  • --reset-scope <config|config+creds+sessions|full>（默?config+creds+sessions；使?full 同时删除工作区）
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual>（manual ?advanced 的别名）
  • --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|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|custom-api-key|skip>
  • --token-provider <id>（非交互式；?--auth-choice token 一起使用）
  • --token <token>（非交互式；?--auth-choice token 一起使用）
  • --token-profile-id <id>（非交互式；默认：<provider>:manual?
  • --token-expires-in <duration>（非交互式；例如 365d、12h?
  • --secret-input-mode <plaintext|ref>（默?plaintext；使?ref 存储提供商默认环境引用而不是明文密钥）
  • --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>
  • --custom-base-url <url>（非交互式；?--auth-choice custom-api-key 一起使用）
  • --custom-model-id <id>（非交互式；?--auth-choice custom-api-key 一起使用）
  • --custom-api-key <key>（非交互式；可选；?--auth-choice custom-api-key 一起使用；如果省略，则回退?CUSTOM_API_KEY?
  • --custom-provider-id <id>（非交互式；可选的自定义提供商 ID?
  • --custom-compatibility <openai|anthropic>（非交互式；可选；默认 openai?
  • --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（别名：--skip-daemon?
  • --daemon-runtime <node|bun>（推?pnpm；不建议?bun 用于网关运行时）
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun>（pnpm 推荐；不建议?bun 用于网关运行时）
  • --json

configure

交互式配置向导（模型、频道、技能、网关）?

config

非交互式配置辅助程序（get/set/unset）。在没有子命令的情况下运?openclaw config 会启动向导?

子命令：

  • config get <path>：打印配置值（?括号路径）?
  • config set <path> <value>：设置值（JSON5 或原始字符串）?
  • config unset <path>：删除值?

doctor

健康检?+ 快速修复（配置 + 网关 + 传统服务）?

选项?

  • --no-workspace-suggestions：禁用工作区内存提示?
  • --yes：接受默认值而不提示（无头模式）?
  • --non-interactive：跳过提示；仅应用安全迁移?
  • --deep：扫描系统服务中的额外网关安装?

频道辅助程序

channels

管理聊天频道帐户（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost（插件）/Signal/iMessage/MS Teams）?

子命令：

  • channels list：显示配置的频道和身份验证配置文件?
  • channels status：检查网关可达性和频道健康状况（--probe 运行额外检查；使用 openclaw health ?openclaw status --deep 进行网关健康状况探测）?
  • 提示：channels status 在可以检测常见错误配置时打印带有建议修复的警告（然后指向您到 openclaw doctor）?
  • channels logs：从网关日志文件显示最近的频道日志?
  • channels add：当没有传递标志时向导样式设置；标志切换到非交互模式?
    • 将非默认帐户添加到仍在使用单帐户顶级配置的频道时，OpenClaw 在写入新帐户之前将帐户范围的值移动到 channels.<channel>.accounts.default?
    • 非交互式 channels add 不会自动创建/升级绑定；仅频道的绑定继续匹配默认帐户?
  • channels remove：默认禁用；传?--delete 可在不提示的情况下删除配置条目?
  • channels login：交互式频道登录（仅?WhatsApp Web）?
  • channels logout：注销频道会话（如果支持）?

常用选项?

  • --channel <name>：whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>：频道帐?ID（默?default?
  • --name <label>：帐户的显示名称

channels login 选项?

  • --channel <channel>（默?whatsapp；支?whatsapp/web?
  • --account <id>
  • --verbose

channels logout 选项?

  • --channel <channel>（默?whatsapp?
  • --account <id>

channels list 选项?

  • --no-usage：跳过模型提供商使用?配额快照（仅?OAuth/API 后端）?
  • --json：输?JSON（除非设?--no-usage，否则包括使用量）?

channels logs 选项?

  • --channel <name|all>（默?all?
  • --lines <n>（默?200?
  • --json

更多详细信息：/concepts/oauth

示例?

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

列出和检查可用技能以及就绪信息?

子命令：

  • skills list：列出技能（当没有子命令时默认）?
  • skills info <name>：显示一个技能的详细信息?
  • skills check：就绪与缺少要求的摘要?

选项?

  • --eligible：仅显示就绪技能?
  • --json：输?JSON（无样式）?
  • -v、--verbose：包括缺少要求的详细信息?

提示：使?npx clawhub 搜索、安装和同步技能?

pairing

跨频道批?DM 配对请求?

子命令：

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

devices

管理网关设备配对条目和每个角色的设备令牌?

子命令：

  • 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

Gmail Pub/Sub hook 设置 + 运行程序。请参阅 /automation/gmail-pubsub?

子命令：

  • webhooks gmail setup（需?--account <email>；支?--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（相同标志的运行时覆盖）

dns setup

广域发现 DNS 辅助程序（CoreDNS + Tailscale）。请参阅 /gateway/discovery?

选项?

  • --apply：安?更新 CoreDNS 配置（需?sudo；仅?macOS）?

消息 + 代理

message

统一出站消息 + 频道操作?

请参阅：/cli/message

子命令：

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

示例?

  • 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

通过网关运行一个代理轮（或 --local 嵌入式）?

必需?

  • --message <text>

选项?

  • --to <dest>（用于会话密钥和可选传递）
  • --session-id <id>
  • --thinking <off|minimal|low|medium|high|xhigh>（仅?GPT-5.2 + Codex 模型?
  • --verbose <on|full|off>
  • --channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
  • --local
  • --deliver
  • --json
  • --timeout <seconds>

agents

管理隔离的代理（工作?+ 身份验证 + 路由）?

agents list

列出配置的代理?

选项?

  • --json
  • --bindings

agents add [name]

添加新的隔离代理。除非传递标志（?--non-interactive），否则运行引导向导；在非交互模式下需?--workspace?

选项?

  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]>（可重复?
  • --non-interactive
  • --json

绑定规范使用 channel[:accountId]。当省略 accountId 时，OpenClaw 可以通过频道默认?插件钩子解析帐户范围；否则它是没有明确帐户范围的频道绑定?

agents bindings

列出路由绑定?

选项?

  • --agent <id>
  • --json

agents bind

为代理添加路由绑定?

选项?

  • --agent <id>
  • --bind <channel[:accountId]>（可重复?
  • --json

agents unbind

移除代理的路由绑定?

选项?

  • --agent <id>
  • --bind <channel[:accountId]>（可重复?
  • --all
  • --json

agents delete <id>

删除代理并修剪其工作?+ 状态?

选项?

  • --force
  • --json

acp

运行?IDE 连接到网关的 ACP 桥?

请参?acp 获取完整选项和示例?

status

显示链接的会话健康状况和最近的接收者?

选项?

  • --json
  • --all（完整诊断；只读，可粘贴?
  • --deep（探测频道）
  • --usage（显示模型提供商使用?配额?
  • --timeout <ms>
  • --verbose
  • --debug（--verbose 的别名）

注意?

  • 概述包括网关 + 节点主机服务状态（当可用时）?

使用跟踪

?OAuth/API 凭据可用时，OpenClaw 可以显示提供商使用量/配额?

界面?

  • /status（添加一个短提供商使用量行，当可用时?
  • openclaw status --usage（打印完整的提供商细分）
  • macOS 菜单栏（Context 下的 Usage 部分?

注意?

  • 数据直接来自提供商使用量端点（无估算）?
  • 提供商：Anthropic、GitHub Copilot、OpenAI Codex OAuth，以及在启用这些提供商插件时?Gemini CLI/Antigravity?
  • 如果不存在匹配的凭据，则隐藏使用量?
  • 详细信息：请参阅 Usage tracking?

health

从正在运行的网关获取健康状况?

选项?

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

sessions

列出存储的对话会话?

选项?

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

重置 / 卸载

reset

重置本地配置/状态（保留 CLI 安装）?

选项?

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

注意?

  • --non-interactive 需?--scope ?--yes?

uninstall

卸载网关服务 + 本地数据（CLI 保留）?

选项?

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

注意?

  • --non-interactive 需?--yes 和明确的范围（或 --all）?

网关

gateway

运行 WebSocket 网关?

选项?

  • --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（重置开发配?+ 凭据 + 会话 + 工作区）
  • --force（杀死端口上的现有侦听器?
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact（--ws-log compact 的别名）
  • --raw-stream
  • --raw-stream-path <path>

gateway service

管理网关服务（launchd/systemd/schtasks）?

子命令：

  • gateway status（默认探测网?RPC?
  • gateway install（服务安装）
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart

注意?

  • gateway status 默认使用服务的已解析端口/配置探测网关 RPC（使?--url/--token/--password 覆盖）?
  • gateway status 支持 --no-probe、--deep ?--json 用于脚本?
  • gateway status 在可以检测到它们时还会显示传统或额外的网关服务（--deep 添加系统级扫描）。以配置文件命名?OpenClaw 服务被视为一流的，不会被标记?额外”?
  • gateway status 打印 CLI 使用的配置路径与服务可能使用的配置路径（服务环境变量），加上已解析的探测目标 URL?
  • gateway install|uninstall|start|stop|restart 支持 --json 用于脚本（默认输出保持对用户友好）?
  • gateway install 默认?Node 运行时；*不推? bun（WhatsApp/Telegram 错误）?
  • gateway install 选项：--port、--runtime、--token、--force、--json?

logs

通过 RPC 尾随网关文件日志?

注意?

  • TTY 会话呈现彩色、结构化视图；非 TTY 回退到纯文本?
  • --json 发出行分隔的 JSON（每行一个日志事件）?

示例?

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

gateway <subcommand>

网关 CLI 辅助程序（对 RPC 子命令使?--url、--token、--password、--timeout、--expect-final）?

当您传?--url 时，CLI 不会自动应用配置或环境凭据? 显式包含 --token ?--password。缺少显式凭据是一个错误?

子命令：

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

常用 RPC?

  • config.apply（验?+ 写入配置 + 重启 + 唤醒?
  • config.patch（合并部分更?+ 重启 + 唤醒?
  • update.run（运行更?+ 重启 + 唤醒?

提示：当直接调用 config.set/config.apply/config.patch 时，?config.get 传?baseHash（如果配置已存在）?

模型

请参?/concepts/models 了解后备行为和扫描策略?

首?Anthropic 身份验证（setup-token）：

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

models (root)

openclaw models ?models status 的别名?

根选项?

  • --status-json（models status --json 的别名）
  • --status-plain（models status --plain 的别名）

models list

选项?

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

models status

选项?

  • --json
  • --plain
  • --check（退?1=过期/缺失?=即将过期?
  • --probe（配置的身份验证配置文件的实时探测）
  • --probe-provider <name>
  • --probe-profile <id>（重复或逗号分隔?
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

始终包括身份存储中配置文件的认证概述?OAuth 到期状态? --probe 运行实时请求（可能消耗令牌并触发速率限制）?

models set <model>

设置 agents.defaults.model.primary?

models set-image <model>

设置 agents.defaults.imageModel.primary?

models aliases list|add|remove

选项?

  • list：--json、--plain
  • add <alias> <model>
  • remove <alias>

models fallbacks list|add|remove|clear

选项?

  • list：--json、--plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear

选项?

  • list：--json、--plain
  • add <model>
  • remove <model>
  • clear

models scan

选项?

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

选项?

  • add：交互式身份验证辅助程序
  • setup-token：--provider <name>（默?anthropic）、--yes
  • paste-token：--provider <name>、--profile-id <id>、--expires-in <duration>

models auth order get|set|clear

选项?

  • get：--provider <name>、--agent <id>、--json
  • set：--provider <name>、--agent <id>、<profileIds...>
  • clear：--provider <name>、--agent <id>

系统

system event

将系统事件排入队列并可选择触发心跳（网?RPC）?

必需?

  • --text <text>

选项?

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

system heartbeat last|enable|disable

心跳控制（网?RPC）?

选项?

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

system presence

列出系统存在条目（网?RPC）?

选项?

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

Cron

管理计划作业（网?RPC）。请参阅 /automation/cron-jobs?

子命令：

  • cron status [--json]
  • cron list [--all] [--json]（默认表格输出；使用 --json 获取原始?
  • cron add（别名：create；需?--name ?--at | --every | --cron 之一，以?--system-event | --message 之一的确切有效负载）
  • cron edit <id>（补丁字段）
  • cron rm <id>（别名：remove、delete?
  • cron enable <id>
  • cron disable <id>
  • cron runs --id <id> [--limit <n>]
  • cron run <id> [--force]

所?cron 命令接受 --url、--token、--timeout、--expect-final?

节点主机

node 运行无头节点主机或将其作为后台服务管理。请参阅 openclaw node?

子命令：

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

常用选项?

  • --url、--token、--timeout、--json

子命令：

  • 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 节点或无头节点主机）
  • nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>]（仅?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>]

Canvas + 屏幕?

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

浏览?

浏览器控?CLI（专?Chrome/Brave/Edge/Chromium）。请参阅 openclaw browser ?Browser tool?

常用选项?

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

管理?

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

检查：

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

文档搜索

docs [query...]

搜索实时文档索引?

TUI

tui

打开连接到网关的终端 UI?

选项?

  • --url <url>
  • --token <token>
  • --password <password>
  • --session <key>
  • --deliver
  • --thinking <level>
  • --message <text>
  • --timeout-ms <ms>（默认为 agents.defaults.timeoutSeconds?
  • --history-limit <n>