OMP 遠端 Coding Agent（3/5）：Collab 遠端控制¶

摘要¶

Collab 讓其他電腦和手機透過瀏覽器加入筆電上的 OMP Session。工具一律在筆電執行；Collab URL 要當成密碼保管。

資料基準：2026-09。執行前請以 omp --help、omp config list 與 omp models 核對目前版本支援的選項。

系列目錄

1. Collab：遠端控制¶

在私人筆電：

cd ~/Projects/my-project
omp

進入 OMP 後：

/collab

OMP 會顯示：

Join from another terminal:
omp join "..."

Browser:
https://my.omp.sh/#...

OMP 也會顯示 QR Code。

Collab 控制流程¶

圖 1：Collab 資料與控制流程

工具由私人筆電的 Host 執行。

2. 其他電腦使用¶

其他電腦用瀏覽器開啟 Collab URL，無須安裝 OMP：

https://my.omp.sh/#你的-session-key

例如：

幫我查看目前 git status。

先不要修改任何東西。

實際流程：

其他電腦 Browser
      ↓
OMP Collab
      ↓
私人筆電 OMP
      ↓
Git / Docker / Files / DB

3. 手機使用¶

手機 Safari / Chrome 打開同一個 Collab URL。

或者：

/collab

後直接掃 QR Code。

例如外出時：

現在進度到哪？

或：

分析目前失敗的 test。

先不要修改 database migration。

4. Collab 指令¶

完整控制：

/collab

唯讀：

/collab view

狀態：

/collab status

停止：

/collab stop

Guest 離開：

/leave

查看 Active Hosts：

omp collab list

取得連結：

omp collab link <instanceId>

唯讀連結：

omp collab link <instanceId> --view

5. Collab URL 是敏感憑證¶

Collab URL 是敏感憑證

Full-control Collab URL 必須當成 Password。

不要：

貼到 Slack 公開頻道
貼到 GitHub Issue
放在公開 Notion
放進 Repository
寄到多人 Mailing List

Full-control 使用者可能可以：

發送 Prompt
Interrupt Agent
讓 Host 執行 Tool
間接操作你的開發環境

需要分享畫面時，優先：

/collab view

6. 自動開啟 Collab¶

設定 Full Control：

omp config set collab.autoStart control

唯讀：

omp config set collab.autoStart view

關閉：

omp config set collab.autoStart off

設定名稱：

omp config set collab.displayName Shane-Laptop

7. Host 筆電必須保持在線¶

這套架構的必要條件：

私人筆電
= 真正的 Agent Host

因此：

狀態	可否遠端工作
筆電開機 + OMP 執行中	可以
OMP 關閉	不行
筆電睡眠	通常不行
筆電斷網	不行
筆電關機	不行

因此應調整：

macOS / Windows Sleep
Lid close 行為
Network sleep
Power settings

8. 多專案使用¶

例如同時處理三個專案：

project-api
project-web
data-pipeline

各專案分別啟動 OMP。

查看：

omp collab list

Session 對應如下：

圖 2：多專案與 Collab Session 配置

9. OMP 與 Claude Code Web 的差異¶

OMP 在私人筆電執行 Agent：

AI Agent 真正執行位置
= 你的私人筆電

可直接使用該筆電上的：

本機 Docker
Local DB
尚未 Push 的 Git 修改
Local filesystem
私有 .env
本機 Python / Node 環境
大型 Dataset

Cloud Coding Agent 通常在以下環境執行：

Cloud Sandbox

執行位置不同，能直接使用的資源也不同。

上一篇：模型角色與日常 Coding　·　下一篇：設定、權限與安全

參考資料¶

Collab：https://github.com/can1357/oh-my-pi/blob/main/docs/collab.md
Settings：https://github.com/can1357/oh-my-pi/blob/main/docs/settings.md