セットアップ

​

概要 (TL;DR)

• カスタマイズはリポジトリの外部に置きます: ~/.openclaw/workspace (ワークスペース) + ~/.openclaw/openclaw.json (設定)。
• 安定したワークフロー: macOS アプリをインストールし、バンドルされた Gateway を実行させます。
• 最先端 (Bleeding edge) のワークフロー: pnpm gateway:watch を介して自分で Gateway を実行し、macOS アプリをローカルモードでアタッチさせます。

​

前提条件 (ソースから)

• Node >=22
• pnpm
• Docker (オプション。コンテナ化されたセットアップ/e2e のみ — Docker を参照してください)

​

カスタマイズ戦略 (アップデートで壊れないようにする)

• 設定: ~/.openclaw/openclaw.json (JSON / JSON5 風)
• ワークスペース: ~/.openclaw/workspace (スキル、プロンプト、記憶。プライベートな git リポジトリにしてください)

openclaw setup

openclaw setup

​

このリポジトリから Gateway を実行する

node openclaw.mjs gateway --port 18789 --verbose

​

安定したワークフロー (macOS アプリ優先)

1. OpenClaw.app (メニューバー) をインストールして起動します。
2. オンボーディング / 権限チェックリスト (TCC プロンプト) を完了します。
3. Gateway が Local になっており、実行されていることを確認します (アプリが管理します)。
4. サーフェスをリンクします (例：WhatsApp)：

openclaw channels login

5. サニティチェック：

openclaw health

• openclaw setup を実行し、次に openclaw channels login を実行して、手動で Gateway を起動します (openclaw gateway)。

​

最先端のワークフロー (ターミナルでの Gateway)

​

0) (オプション) macOS アプリもソースから実行する

./scripts/restart-mac.sh

​

1) 開発用 Gateway を起動する

pnpm install
pnpm gateway:watch

​

2) macOS アプリを実行中の Gateway に向ける

• 接続モード (Connection Mode): Local アプリは、設定されたポートで実行中のゲートウェイにアタッチします。

​

3) 確認

• アプリ内の Gateway ステータスが “Using existing gateway …” になっているはずです
• または CLI 経由：

openclaw health

​

よくある落とし穴

• 間違ったポート: Gateway WS のデフォルトは ws://127.0.0.1:18789 です。アプリと CLI を同じポートに保ってください。
• 状態が保存される場所:
  • 資格情報: ~/.openclaw/credentials/
  • セッション: ~/.openclaw/agents/<agentId>/sessions/
  • ログ: /tmp/openclaw/

​

資格情報ストレージマップ

• WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
• Telegram ボットトークン: config/env または channels.telegram.tokenFile
• Discord ボットトークン: config/env または SecretRef (env/file/exec プロバイダー)
• Slack トークン: config/env (channels.slack.*)
• ペアリング許可リスト:
  • ~/.openclaw/credentials/<channel>-allowFrom.json (デフォルトアカウント)
  • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (非デフォルトアカウント)
• モデル認証プロファイル: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• ファイルバックアップされたシークレットペイロード (オプション): ~/.openclaw/secrets.json
• レガシー OAuth インポート: ~/.openclaw/credentials/oauth.json 詳細: セキュリティ。

​

アップデート (セットアップを壊さずに)

• ~/.openclaw/workspace と ~/.openclaw/ は「あなたのもの」として保持してください。個人のプロンプトや設定を openclaw リポジトリに入れないでください。
• ソースのアップデート：git pull + pnpm install (ロックファイルが変更された場合) + 引き続き pnpm gateway:watch を使用します。

​

Linux (systemd ユーザーサービス)

sudo loginctl enable-linger $USER

​

関連ドキュメント

• Gateway ランブック (フラグ、監視、ポート)
• Gateway の構成 (設定スキーマ + 例)
• Discord および Telegram (返信タグ + replyToMode 設定)
• OpenClaw アシスタントのセットアップ
• macOS アプリ (ゲートウェイのライフサイクル)