> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 螢幕

`screen` 工具可讓代理安排瀏覽器式控制介面的版面。它是具型別的版面配置與導覽介面，而非螢幕截圖擷取或瀏覽器自動化工具。

只有當來源用戶端宣告 `ui-commands` 能力時，才會提供此工具。工具執行時，仍須至少有一個具備該能力的控制介面保持連線；否則閘道會傳回 `UNAVAILABLE`。

## 動作

| 動作                                | 效果            | 選用輸入                             |
| --------------------------------- | ------------- | -------------------------------- |
| `split_right`                     | 將目標工作階段窗格向右分割 | `sessionKey`（預設為目前工作階段）          |
| `split_down`                      | 將目標工作階段窗格向下分割 | `sessionKey`（預設為目前工作階段）          |
| `close_pane`                      | 關閉目標工作階段窗格    | `sessionKey`（預設為目前工作階段）          |
| `focus`                           | 聚焦目標工作階段窗格    | `sessionKey`（預設為目前工作階段）          |
| `navigate`                        | 開啟目標工作階段      | `sessionKey`（預設為目前工作階段）          |
| `sidebar_show` / `sidebar_hide`   | 顯示或隱藏主側邊欄     | -                                |
| `terminal_show` / `terminal_hide` | 顯示或隱藏操作員終端面板  | 顯示時使用 `dock`（`bottom` 或 `right`） |
| `browser_show` / `browser_hide`   | 顯示或隱藏瀏覽器面板    | 顯示時使用 `dock`（`bottom` 或 `right`） |

命令成功後，閘道會廣播具型別的 `ui.command` 事件，接著傳回 `{ "ok": true }`。

## 路由與安全性

通訊協定 v1 會刻意將命令傳送給每個已連線且宣告 `ui-commands` 的控制介面；它不會以單一瀏覽器分頁為目標。當同一位操作員開啟數個儀表板時，這一點很重要。

閘道 RPC 需要 `operator.write`。此工具只能變更呈現狀態：它無法讀取像素、擷取螢幕截圖、點擊任意頁面內容，或繞過所選工作階段與操作員面板的權限。

## 相關內容

* [控制介面](/zh-TW/web/control-ui)
* [閘道通訊協定](/zh-TW/gateway/protocol#method-families)
* [瀏覽器工具](/zh-TW/tools/browser)