設備運行
支援哪些硬體與作業系統？
1.0.0 的已驗證平台是 AIR-075（NVIDIA Jetson AGX Thor、JetPack 7.1、Ubuntu 24.04）。技術上，具備 Docker Engine、Compose v2、4 GB 可用記憶體與約 5.8 GB 磁碟的 Linux 主機都跑得起來（設備要自己跑預設本機模型時為 16 GB RAM），但官方支援只涵蓋已驗證的 Advantech 硬體與作業系統組合。詳見系統需求。
支援哪些模型？
預設是本機 Ollama 的 qwen3.5:4b-q4_K_M，要換其他模型參考模型。每個 Agent 可以指定不同的已安裝模型。需注意模型 id 大小寫敏感。
admin 密碼忘了怎麼辦？
在設備上重設：
cd /opt/Advantech/Agentic/app/openclaw/.openclaw/workspace/skills/ai-agent-control-dashboard
python3 scripts/manage_auth.py reset-admin-password
初始 admin 有什麼特別？
設備出廠帶著的 admin 是唯一能刪除其他帳號、能強制他人登出的帳號，而且它本身不能被刪除、停用或改成別的角色。其他 Administrator 擁有其餘所有管理權限，但沒有這兩項。
一台設備可以多少人同時使用？
三個登入中的帳號，再加上永遠有位子的初始 admin。一台設備最多 50 個帳號、初始 admin 之外最多 10 個 Administrator，Session 壽命 24 小時，畫面閒置 30 分鐘會自行登出。完整表格見角色與限制。
點桌面捷徑後瀏覽器打不開怎麼辦？
Ubuntu 預設以 snap 安裝的 Firefox 讀不到 /opt 底下的設定檔，所以捷徑開不了它。改用 Firefox 官方的二進位檔案（Binary）即可：下載後解壓縮就能直接執行，不需要安裝。
下載點（Linux ARM64，適用 AIR-075）：
解壓縮到 /opt/firefox，再讓捷徑找得到它：
sudo tar -xJf firefox-*.tar.xz -C /opt
sudo ln -sf /opt/firefox/firefox /usr/local/bin/firefox
/usr/local/bin 排在 snap 前面，之後捷徑就會改用這個 Firefox。先關掉所有 Firefox 視窗，再點一次捷徑。仍然打不開時，見下方從終端機啟動服務。
雙擊桌面捷徑沒反應怎麼辦？
Launcher 在開啟瀏覽器前就結束了。從終端機跑一次 main/launcher.sh，訊息會直接印出來。
Firefox 說設定檔無法載入，或 Dashboard 出現在原本就開著的 Firefox 視窗裡，為什麼？
捷徑是用 IndustrialClaw 自己的設定檔目錄開瀏覽器。以 snap 安裝的 Firefox 讀不到 /opt 底下的設定檔，而已經在執行的 Firefox 會把這次開啟接收走，不會另外開一個 instance。
先關掉所有 Firefox 視窗，再點一次捷徑——關視窗會連服務一起停掉，捷徑會把它們重新啟動。仍然失敗時，改從終端機啟動服務，再手動開 https://<裝置位址>:18765/。裝 Chrome 或 Chromium 也能避開——捷徑會優先使用它們。
Launcher 停在 Environment check failed 怎麼辦？
可用記憶體不足 4 GB。關掉不需要的程式再啟動一次。
Launcher 停在 jq package not found 怎麼辦？
缺少必要工具，用 sudo apt install jq 安裝。
Launcher 停在 Connection timeout 怎麼辦？
60 秒內 Dashboard 沒有回應。用 docker ps -a 看哪個容器是 Exited。
瀏覽器說憑證不受信任，有問題嗎？
沒有問題，憑證是自簽的，出現這個警告是正常的。確認位址是你的設備之後繼續。
為什麼從別台機器連不到 Gateway？
這是刻意的設計，Gateway 只綁 127.0.0.1。請改用 18765 port 的 Dashboard。
匯入 Agent 說沒有權限怎麼辦？
尚未做過設備配對。在設備上跑一次 ./setup_pairing.sh。
怎麼從終端機啟動或停止服務？
關掉瀏覽器視窗會連同服務一起停掉，所以手動開網址之前，要先讓服務重新跑起來：
cd /opt/Advantech/Agentic/app/openclaw/scripts
./run-engine.sh # 啟動 IndustrialClaw 與模型 engine，等同桌面捷徑
./stop-engine.sh # 兩者一起停止
./run.sh # 只啟動 IndustrialClaw，不啟動 engine
./stop.sh # 只停止 IndustrialClaw
服務起來之後，用任何瀏覽器開 https://<裝置位址>:18765/。
回報問題時要附上什麼？
設備型號、安裝程式版本，以及終端機或 Dashboard 上顯示的完整訊息。