OpenClaw macOS 入門指南：快速搞定你的 AI Agent 設定
剛拿到一個強大的 AI 工具，最想做的就是趕快跑起來，而不是對著一堆設定文件發呆。尤其是當你需要 AI Agent 幫你處理檔案或執行程式碼時，如果一開始的權限和環境沒設好，後續的使用體驗會大打折扣。
這篇指南會帶你走過 OpenClaw 在 macOS 上的「Day 0」流程。我們的目標很簡單：選好 Gateway 執行位置、連上驗證機制、跑完設定精靈，剩下的就交給 Agent 自動引導。
需要準備的東西
Section titled “需要準備的東西”- 一台 macOS 裝置
- npm 或 pnpm（如果你需要安裝 CLI 工具）
- 基本的網路連接權限
跟著設定精靈走，大約 5 分鐘就能完成基礎配置：
1. 通過系統安全檢查
Section titled “1. 通過系統安全檢查”啟動 App 後，你會看到 macOS 的安全性警告。請核准執行，並允許 App 尋找並連接區域網路上的裝置，這對於 Gateway 的運作至關重要。
2. 確認安全信任模型
Section titled “2. 確認安全信任模型”OpenClaw 預設是作為「個人 Agent」運作：
- 預設設定：新的本地配置會自動將
tools.profile設為"coding"。這樣你在本地環境就能直接使用檔案系統和執行環境工具，不需要手動開啟權限全開的full設定檔。 - 多用戶環境：如果你是在共享機器上使用，請務必參考 Security 文件進行權限隔離。
3. 選擇你的 Gateway 執行位置
Section titled “3. 選擇你的 Gateway 執行位置”你需要決定 Gateway 要跑在哪裡：
- 這台 Mac (Local only)：設定精靈會自動幫你寫入本地憑證。
- 遠端 (Remote via SSH/Tailnet)：設定精靈不會幫你配置本地驗證，你需要確保遠端主機上已經存有憑證。
- 稍後配置：跳過設定，稍後再手動調整。
關於驗證的建議： 即使是本地迴路（loopback）連線，設定精靈現在也會產生一個 token。如果你關閉驗證，任何本地程序都能連接你的 Agent，請務必在完全信任的機器上才這麼做。
4. 授權系統權限 (TCC)
Section titled “4. 授權系統權限 (TCC)”為了讓 OpenClaw 能幫你自動化操作，你需要授予以下權限：
- 自動化 (AppleScript)
- 通知與輔助使用
- 螢幕錄製與麥克風
- 語音辨識、相機與定位
5. 安裝 CLI（選配）
Section titled “5. 安裝 CLI（選配）”App 可以透過 npm 或 pnpm 幫你安裝全域的 openclaw CLI。這對於想在終端機操作或設定 launchd 自動化任務的開發者非常方便。
6. 開始引導對話
Section titled “6. 開始引導對話”完成設定後，App 會開啟一個專屬的引導對話 Session。Agent 會在這裡自我介紹並帶領你進行後續操作，這能確保你的正式對話視窗保持乾淨。
- 無法連接本地 Gateway：請檢查是否已產生 token。現在即使是本地連線也需要通過 token 驗證。
- 工具無法存取檔案：確認你的
tools.profile是否設定為"coding"。如果使用未受信任的內容輸入（如 Webhooks），建議使用更高等級的模型並嚴格執行沙盒化。 - 遠端連線失敗：若選擇 Remote 模式，請手動確認 Gateway 主機上的憑證是否正確配置，設定精靈不會自動處理遠端憑證。
如果你在設定過程中遇到任何奇怪的問題，可以直接詢問 AI Setup Assistant 獲取即時幫助。
- Onboarding Overview：了解不同的安裝路徑
- Security：深入了解安全模型與工具限制
- Bootstrapping：查看 Gateway 主機在首次執行時做了什麼
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。