OpenClawセットアップガイド
Amiにデスクトップ制御機能を — メモ、リマインダー、カレンダー、音楽など。
前提条件
macOS はApple Notes、リマインダー、カレンダー、ミュージックのツールに必要です。
Node.js 22+ — 確認： node --version
Node 22+がない場合：
brew install node@22OpenClawのインストール
ターミナルでインストーラスクリプトを実行：
curl -fsSL https://openclaw.ai/install.sh | bashCLIがインストールされ、セットアップウィザードが自動的に開始されます。
インストールを確認
openclaw doctoropenclaw が見つからない場合、PATHに追加：
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcゲートウェイの起動
セットアップウィザードがバックグラウンドデーモンをインストールします。実行状態を確認：
openclaw gateway status手動で起動する場合：
openclaw gateway --port 18789ゲートウェイトークンを見つける
トークンは ~/.openclaw/openclaw.json の gateway.auth.token. 確認コマンド：
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1AmiをOpenClawに接続
- Amiアプリを開いて設定（歯車アイコン）に移動
- 詳細設定セクションまでスクロール
- OpenClaw Gatewayを展開
- フィールドを入力：
| フィールド | 値 |
|---|---|
| ゲートウェイURL | ws://127.0.0.1:18789 |
| ゲートウェイトークン | （ステップ2のトークンを貼り付け） |
5. WebチャットをOpenClaw経由でルーティングを有効にする
6. 保存をクリック
オプション設定
| 設定 | 機能 |
|---|---|
| アイデンティティを同期 | Amiの名前と性格をゲートウェイに送信し、他のチャネルで同じキャラクターを使用 |
| メモリを取得 | キャラクターロード時にワークスペースからメモリをインポート |
| メモリを送信 | 10分ごとにアプリのメモリをワークスペースに自動同期 |
エージェントワークスペースの設定
OpenClawはワークスペースフォルダを使用します。デフォルトは ~/.openclaw/workspace-ami/
2つのファイルが必要です：
SOUL.md — パーソナリティ
このファイルはアプリから自動同期されます。Amiの性格と応答方法を定義します。
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — ツール手順
Amiの macOS ツール使用チートシート。すでに設定済みのはずです。
~/.openclaw/workspace-ami/TOOLS.mdファイルには osascript コマンドが含まれています。
利用可能なツール
接続後、Amiに以下のことを頼めます：
Apple Notes
“買い物リストのメモを書いて”
“週末の計画というタイトルのメモを保存”
リマインダー
“午後3時に歯医者に電話するリマインダーを”
“明日植物に水をやるリマインダーを”
カレンダー
“今日の予定は？”
“金曜日午後2時にJakeとの会議を追加”
ミュージック
“音楽をかけて”
“音楽を一時停止”
“次の曲に”
“今何がかかってる？”
システムコントロール
“ダークモードに切替”
“5分タイマーを設定”
“バッテリー残量は？”
アプリとURLを開く
“Safariを開いて”
“twitter.comを開いて”
トラブルシューティング
OpenClawの更新
npm update -g openclawまたはインストーラを再実行：
curl -fsSL https://openclaw.ai/install.sh | bashアーキテクチャ
興味のある方へ — AmiがデスクトップとどのようにM通信するか：
┌──────────────┐ 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があなたに話しかけます