所有指南
桌面整合
OpenClaw設定指南
賦予Ami控制桌面的能力 — 筆記、提醒、行事曆、音樂等。
隱私說明： OpenClaw完全在你的裝置上執行。閘道器令牌永遠不會離開你的機器。
先決條件
macOS 需要用於Apple備忘錄、提醒、行事曆和音樂工具。
Node.js 22+ — 檢查： node --version
如果沒有Node 22+：
bash
brew install node@22Step 1
安裝OpenClaw
在終端機執行安裝腳本：
bash
curl -fsSL https://openclaw.ai/install.sh | bash將安裝CLI並自動啟動設定精靈。
驗證安裝
bash
openclaw doctoropenclaw 未找到，新增到PATH：
bash
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcStep 2
啟動閘道器
設定精靈安裝背景常駐程式。檢查執行狀態：
bash
openclaw gateway status手動啟動：
bash
openclaw gateway --port 18789找到你的閘道器令牌
令牌在 ~/.openclaw/openclaw.json 的 gateway.auth.token. 查看命令：
bash
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1儲存此令牌 — 下一步需要。
Step 3
將Ami連結到OpenClaw
- 開啟Ami應用程式，進入設定
- 捲動到進階部分
- 展開OpenClaw Gateway
- 填寫欄位：
| 欄位 | 值 |
|---|---|
| 閘道器URL | ws://127.0.0.1:18789 |
| 閘道器令牌 | （貼上步驟2的令牌） |
5. 啟用透過OpenClaw路由網頁聊天
6. 點擊儲存
可選設定
| 設定 | 功能 |
|---|---|
| 同步身份 | 將Ami的名字和個性推送到閘道器 |
| 拉取記憶 | 角色載入時從工作區匯入記憶 |
| 推送記憶 | 每10分鐘自動同步應用程式記憶到工作區 |
Step 4
設定代理工作區
OpenClaw使用工作區資料夾。預設路徑： ~/.openclaw/workspace-ami/
需要兩個檔案：
SOUL.md — 個性
此檔案從應用程式自動同步。定義Ami是誰以及如何回應。
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — 工具說明
Ami使用 macOS 工具的速查表。
~/.openclaw/workspace-ami/TOOLS.md檔案包含 osascript 命令。
可用工具
連結後，你可以讓Ami執行以下操作：
Apple備忘錄
“幫我寫個購物清單”
“儲存一個標題為週末計畫的備忘錄”
提醒
“下午3點提醒我打電話給牙醫”
“設定明天澆花的提醒”
行事曆
“今天有什麼行程？”
“週五下午2點新增與Jake的會議”
音樂
“播放音樂”
“暫停音樂”
“下一首”
“現在在播放什麼？”
系統控制
“切換深色模式”
“設定5分鐘計時器”
“電池電量？”
開啟應用程式和URL
“開啟Safari”
“開啟twitter.com”
疑難排解
更新OpenClaw
bash
npm update -g openclaw或重新執行安裝程式：
bash
curl -fsSL https://openclaw.ai/install.sh | bash架構
給好奇的人 — Ami如何與你的桌面通訊：
┌──────────────┐ WebSocket ┌──────────────────┐ osascript ┌──────────────┐
│ Ami App │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │ macOS APIs │
│ (browser) │ ◄────────────────── │ (localhost) │ ◄──────────────── │ Notes, Music │
│ │ SSE streaming │ Port 18789 │ tool results │ Calendar etc │
└──────────────┘ └──────────────────┘ └──────────────┘
│
┌──────┴──────┐
│ Workspace │
│ SOUL.md │
│ TOOLS.md │
└─────────────┘1. 在瀏覽器中向Ami發送訊息
2. 應用程式偵測工具請求並立即顯示預覽卡
3. 訊息透過WebSocket路由到OpenClaw閘道器
4. 閘道器代理讀取TOOLS.md，執行相應的osascript命令
5. 代理回覆確認，Ami對你說出來