セットアップ

最終更新：2026-01-01

TL;DR

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

前提条件（ソースから）

  • Node >=22
  • pnpm
  • Docker（オプション；コンテナ化されたセットアップ/e2eのみ — Dockerを参照）

カスタマイズ戦略（更新が痛くないように）

「100%自分用」かつ簡単な更新が必要な場合は、カスタマイズを以下に保持してください：

  • 設定： ~/.openclaw/openclaw.json（JSON/JSON5風）
  • ワークスペース： ~/.openclaw/workspace（スキル、プロンプト、メモリ；非公開gitリポジトリにしてください）

一度ブートストラップ：

openclaw setup

このリポジトリ内から、ローカルCLIエントリを使用：

openclaw setup

グローバルインストールがまだない場合は、pnpm openclaw setup経由で実行してください。

安定したワークフロー（macOSアプリ優先）

  1. OpenClaw.app（メニューバー）をインストール + 起動。
  2. オンボーディング/権限チェックリストを完了（TCCプロンプト）。
  3. Gatewayがローカルで実行されていることを確認（アプリが管理します）。
  4. サーフェスをリンク（例：WhatsApp）：
openclaw channels login
  1. サニティチェック：
openclaw health

ビルドでオンボーディングが利用できない場合：

  • openclaw setupを実行し、次にopenclaw channels loginを実行してから、Gatewayを手動で起動します（openclaw gateway）。

最先端のワークフロー（ターミナルでGateway）

目標：TypeScript Gateway上で作業し、ホットリロードを取得し、macOSアプリのUIをアタッチしたままにする。

0)（オプション）macOSアプリもソースから実行

macOSアプリも最先端にしたい場合：

./scripts/restart-mac.sh

1) 開発Gatewayを起動

pnpm install
pnpm gateway:watch

gateway:watchはウォッチモードでgatewayを実行し、TypeScriptの変更時にリロードします。

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

OpenClaw.appで：

  • 接続モード：ローカル アプリは設定されたポート上で実行中のgatewayにアタッチします。

3) 確認

  • アプリ内のGatewayステータスは**「既存の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ボットトークン：設定/環境またはchannels.telegram.tokenFile
  • Discordボットトークン：設定/環境（トークンファイルはまだサポートされていません）
  • Slackトークン：設定/環境（channels.slack.*）
  • ペアリング許可リスト：~/.openclaw/credentials/<channel>-allowFrom.json
  • モデル認証プロファイル：~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • レガシーOAuthインポート：~/.openclaw/credentials/oauth.json 詳細：Security。

更新（セットアップを壊さずに）

  • ~/.openclaw/workspaceと~/.openclaw/を「あなたのもの」として保持；個人のプロンプト/設定をopenclawリポジトリに入れないでください。
  • ソースの更新：git pull + pnpm install（lockfileが変更された時） + pnpm gateway:watchを使い続けます。

Linux（systemdユーザーサービス）

Linuxインストールはsystemd ユーザーサービスを使用します。デフォルトでは、systemdは ログアウト/アイドル時にユーザーサービスを停止し、Gatewayを終了させます。オンボーディングは あなたのためにlingeringを有効にしようとします（sudoを求める場合があります）。まだオフの場合は、実行：

sudo loginctl enable-linger $USER

常時接続またはマルチユーザーサーバーの場合は、ユーザーサービスの代わりにシステムサービスを検討してください （lingeringは不要）。systemdの注意事項についてはGateway runbookを参照してください。

関連ドキュメント

← ドキュメントに戻る