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 输出。

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

注意：Plugin 可以添加额外的顶级命令（例如 openclaw voicecall）。

安全

  • openclaw security audit — 审计配置和本地状态，检查常见的安全隐患。
  • openclaw security audit --deep — 尽力对运行中的 Gateway 进行实时探测。
  • openclaw security audit --fix — 加强安全默认设置并修改状态/配置文件权限。

Plugin

管理扩展及其配置：

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

大多数 Plugin 更改需要重启 Gateway。参见 /plugin。

Memory

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

  • openclaw memory status — 显示索引统计信息。
  • openclaw memory index — 重新索引 memory 文件。
  • openclaw memory search "<query>" — 对 memory 进行语义搜索。

聊天斜杠命令

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

重点：

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

设置和引导

setup

初始化配置和 Workspace。

选项：

  • --workspace <dir>: Agent Workspace 路径（默认 ~/.openclaw/workspace）。
  • --wizard: 运行引导向导。
  • --non-interactive: 无提示运行向导。
  • --mode <local|remote>: 向导模式。
  • --remote-url <url>: 远程 Gateway URL。
  • --remote-token <token>: 远程 Gateway Token。

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

onboard

交互式向导，用于设置 Gateway、Workspace 和 Skill。

选项：

  • --workspace <dir>
  • --reset（在向导前重置配置、凭据、Session 和 Workspace）
  • --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|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>（非交互式；与 --auth-choice token 一起使用）
  • --token <token>（非交互式；与 --auth-choice token 一起使用）
  • --token-profile-id <id>（非交互式；默认：<provider>:manual）
  • --token-expires-in <duration>（非交互式；例如 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（别名：--skip-daemon）
  • --daemon-runtime <node|bun>
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun>（推荐 pnpm；不推荐 bun 作为 Gateway Runtime）
  • --json

configure

交互式配置向导（模型、Channel、Skill、Gateway）。

config

非交互式配置助手（get/set/unset）。不带子命令运行 openclaw config 会启动向导。

子命令：

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

doctor

健康检查和快速修复（配置、Gateway、旧版服务）。

选项：

  • --no-workspace-suggestions: 禁用 Workspace 内存提示。
  • --yes: 接受默认值而不提示（无头模式）。
  • --non-interactive: 跳过提示；仅应用安全迁移。
  • --deep: 扫描系统服务以查找额外的 Gateway 安装。

Channel 助手

channels

管理聊天 Channel 账户（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/MS Teams）。

子命令：

  • channels list: 显示已配置的 Channel 和认证配置文件。
  • channels status: 检查 Gateway 可达性和 Channel 健康状况（--probe 运行额外检查；使用 openclaw health 或 openclaw status --deep 进行 Gateway 健康探测）。
  • 提示：channels status 在检测到常见配置错误时会打印警告和建议修复（然后指向 openclaw doctor）。
  • channels logs: 从 Gateway 日志文件显示最近的 Channel 日志。
  • channels add: 不带标志时为向导式设置；标志切换到非交互模式。
  • channels remove: 默认禁用；传递 --delete 可无提示删除配置条目。
  • channels login: 交互式 Channel 登录（仅限 WhatsApp Web）。
  • channels logout: 退出 Channel Session（如果支持）。

常用选项：

  • --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>: Channel 账户 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

列出并检查可用的 Skill 及就绪信息。

子命令：

  • skills list: 列出 Skill（无子命令时的默认行为）。
  • skills info <name>: 显示单个 Skill 的详细信息。
  • skills check: 就绪与缺失要求的摘要。

选项：

  • --eligible: 仅显示就绪的 Skill。
  • --json: 输出 JSON（无样式）。
  • -v, --verbose: 包含缺失要求的详细信息。

提示：使用 npx clawhub 搜索、安装和同步 Skill。

pairing

批准跨 Channel 的 DM 配对请求。

子命令：

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

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）。

消息和 Agent

message

统一的出站消息和 Channel 操作。

参见：/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

通过 Gateway（或 --local 嵌入式）运行一次 Agent 回合。

必需：

  • --message <text>

选项：

  • --to <dest>（用于 Session 密钥和可选传递）
  • --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

管理隔离的 Agent（Workspace + 认证 + 路由）。

agents list

列出已配置的 Agent。

选项：

  • --json
  • --bindings

agents add [name]

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

选项：

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

绑定规范使用 channel[:accountId]。当 WhatsApp 省略 accountId 时，使用默认账户 ID。

agents delete <id>

删除 Agent 并清理其 Workspace 和状态。

选项：

  • --force
  • --json

acp

运行连接 IDE 到 Gateway 的 ACP 桥接。

完整选项和示例参见 acp。

status

显示关联的 Session 健康状况和最近的接收者。

选项：

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

注意：

  • 概览包括 Gateway 和 node 主机服务状态（如果可用）。

使用量跟踪

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

显示位置：

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

注意：

  • 数据直接来自提供商使用量端点（无估算）。
  • 提供商：Anthropic、GitHub Copilot、OpenAI Codex OAuth，以及启用这些 Provider Plugin 时的 Gemini CLI/Antigravity。
  • 如果不存在匹配的凭据，则隐藏使用量。
  • 详情：参见 使用量跟踪。

health

从运行中的 Gateway 获取健康状态。

选项：

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

sessions

列出存储的对话 Session。

选项：

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

重置/卸载

reset

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

选项：

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

注意：

  • --non-interactive 需要 --scope 和 --yes。

uninstall

卸载 Gateway 服务和本地数据（CLI 保留）。

选项：

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

注意：

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

Gateway

gateway

运行 WebSocket Gateway。

选项：

  • --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（重置 dev 配置、凭据、Session 和 Workspace）
  • --force（强制终止端口上的现有监听器）
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact（--ws-log compact 的别名）
  • --raw-stream
  • --raw-stream-path <path>

gateway service

管理 Gateway 服务（launchd/systemd/schtasks）。

子命令：

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

注意：

  • gateway status 默认使用服务解析的端口/配置探测 Gateway RPC（使用 --url/--token/--password 覆盖）。
  • gateway status 支持 --no-probe、--deep 和 --json 用于脚本编写。
  • gateway status 在检测到旧版或额外的 Gateway 服务时也会显示（--deep 添加系统级扫描）。以配置文件命名的 OpenClaw 服务被视为一等公民，不会被标记为”额外”。
  • gateway status 打印 CLI 使用的配置路径与服务可能使用的配置（服务环境），以及解析的探测目标 URL。
  • gateway install|uninstall|start|stop|restart 支持 --json 用于脚本编写（默认输出保持人性化）。
  • gateway install 默认使用 Node Runtime；不推荐 bun（WhatsApp/Telegram 存在 bug）。
  • gateway install 选项：--port、--runtime、--token、--force、--json。

logs

通过 RPC 跟踪 Gateway 文件日志。

注意：

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

示例：

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

gateway <subcommand>

Gateway CLI 助手（RPC 子命令使用 --url、--token、--password、--timeout、--expect-final）。

子命令：

  • 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（根命令）

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=过期/缺失，2=即将过期）
  • --probe（对已配置的认证配置文件进行实时探测）
  • --probe-provider <name>
  • --probe-profile <id>（可重复或逗号分隔）
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

始终包含认证概览和认证存储中配置文件的 OAuth 过期状态。 --probe 运行实时请求（可能消耗 Token 并触发速率限制）。

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

system event

将系统事件加入队列并可选触发 Heartbeat（Gateway RPC）。

必需：

  • --text <text>

选项：

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

system heartbeat last|enable|disable

Heartbeat 控制（Gateway RPC）。

选项：

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

system presence

列出系统存在条目（Gateway RPC）。

选项：

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

Cron

管理定时任务（Gateway 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 主机

node 运行无头 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 与 Gateway 通信并针对配对的 node。参见 /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 node 或无头 node 主机）
  • 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>]

Browser

Browser 控制 CLI（专用 Chrome/Brave/Edge/Chromium）。参见 openclaw browser 和 Browser 工具。

常用选项：

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

打开连接到 Gateway 的终端界面。

选项：

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