macOS 應用程式引導

概述

本指南描述了 Clawdbot macOS 應用程式的首次執行引導體驗，涵蓋從初始啟動到代理引導的設定過程。

設定流程

引導過程包含 8 個步驟：

步驟 1：歡迎

初始歡迎畫面，包含關於 Clawdbot 功能的安全通知。

步驟 2：閘道器選擇

選擇您的閘道器模式：

步驟 3：認證

對於本地設定，請使用您的 AI 提供者進行認證：

• Anthropic OAuth - 適用於 Claude Pro/Max 訂閱者
• Anthropic API Key - 直接 API 存取
• OpenAI - GPT 模型
• 其他提供者 - 各種選項

OAuth 流程會在瀏覽器中開啟進行 PKCE 認證。出現提示時貼上程式碼/狀態值。

憑證儲存位置：~/.clawdbot/credentials/oauth.json

步驟 4：設定精靈

閘道器驅動的配置，包括：

• 連接埠和網路設定
• 頻道整合
• 技能安裝

步驟 5：權限

macOS 需要明確的權限授予：

按照提示授予權限。某些功能需要特定權限才能運作。

步驟 6：CLI 安裝

選擇性安裝全域 clawdbot 指令：

# 安裝到 /usr/local/bin/clawdbot
clawdbot --version

步驟 7：引導對話

用於代理介紹的專用對話階段：

• 代理建立工作區（~/.clawdbot/workspace）
• 初始化初始檔案：AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
• 進行問答以個人化您的體驗
• 了解您的偏好和使用案例

步驟 8：完成

設定完成。您現在可以：

• 與您的助理對話
• 設定額外的頻道
• 安裝技能
• 自訂您的工作區

閘道器模式

本地模式

• 閘道器在您的 Mac 上執行
• OAuth 流程直接運作
• 憑證儲存在本地
• 最適合個人使用

遠端模式

使用遠端閘道器時：

• 所有憑證都在閘道器主機上
• 工作區檔案在遠端機器上
• 本地 Mac 僅作為客戶端
• 適用於共享或伺服器部署

代理引導

首次執行時，代理會：

1. 建立工作區目錄
2. 初始化指令檔案
3. 進行個人化問答
4. 配置初始偏好設定

引導檔案

疑難排解

權限問題

如果功能無法運作：

1. 開啟系統偏好設定 → 隱私與安全性
2. 檢查每個權限類別
3. 確保 Clawdbot 已啟用
4. 如有需要，重新啟動應用程式

OAuth 失敗

如果認證失敗：

1. 檢查您的網路連線
2. 驗證您的訂閱狀態
3. 嘗試手動輸入 API 金鑰
4. 檢查 ~/.clawdbot/credentials/ 是否有問題

閘道器無法啟動

1. 檢查連接埠 18789 是否可用
2. 查看 /tmp/clawdbot/ 中的日誌
3. 從終端機嘗試 clawdbot health

後續步驟

• 設定指南 - 詳細配置
• 建立助理 - 建立您的助理
• 頻道 - 連接訊息平台