セットアップと設定
インストールと設定のガイド。自分向けにカスタムしつつ、更新も楽に。
Last updated: 2026-01-01
TL;DR
- **Keep personalization outside the repo:** `~/.openclaw/workspace` (workspace) + `~/.openclaw/openclaw.json` (config).
- **安定運用：** macOS アプリをインストールし、アプリ管理の Gateway を使う。
- **最先端運用：** `pnpm gateway:watch` で自分で Gateway を動かし、macOS アプリを Local モードで接続する。
前提条件（ソースから実行）
カスタマイズ方針（痛みなく更新する）
「自分向け 100%」を維持しつつ更新も楽にしたいなら、カスタム内容は次に置きます：
- **設定：** `~/.openclaw/openclaw.json`（JSON/JSON5）
- **ワークスペース：** `~/.openclaw/workspace`（スキル/プロンプト/メモリ。プライベート Git 管理推奨）
初回ブートストラップ：
openclaw setup
このリポジトリ内では、ローカルの CLI エントリを使います：
openclaw setup
グローバル未導入なら `pnpm openclaw setup` を使います。
安定運用（macOS アプリ優先）
1. 1. **OpenClaw.app**（メニューバー）をインストールして起動。
2. 2. オンボーディング/権限（TCC の許可ダイアログ）を完了。
3. 3. Gateway が **Native** モードで稼働していることを確認（アプリ管理）。
4. 4. チャットプラットフォームを接続（例：WhatsApp）。
openclaw channels login
5. 5. ヘルスチェック：
openclaw health
ビルドにオンボーディングが無い場合：
- `openclaw setup` → `openclaw channels login` の順に実行し、その後 Gateway を手動起動（`openclaw gateway`）。
最先端運用（ターミナルで Gateway）
目的：TypeScript Gateway をホットリロードで開発しつつ、macOS アプリの UI をその Gateway に接続したままにする。
0）任意：macOS アプリもソースから実行
macOS アプリも最新を使いたい場合：
./scripts/restart-mac.sh
1）開発用 Gateway を起動
pnpm install pnpm gateway:watch
`gateway:watch` は Gateway を監視モードで起動し、TypeScript 変更時に自動リロードします。
2）macOS アプリを稼働中 Gateway に接続
**OpenClaw.app** 側で：
- Connection Mode：**Local** を選択
アプリは設定されたポートの稼働中 Gateway に接続します。
3) Verify
- アプリの Gateway ステータスが **"Using existing gateway …"** になる
- もしくは CLI で確認：
openclaw health
よくある落とし穴
- **ポート不一致：** Gateway の WS 既定は `ws://127.0.0.1:18789`。アプリと CLI は同じポートを使う必要があります。
- **保存場所：**
- Credentials: `~/.openclaw/credentials/`
- Sessions: `<code1>~/.openclaw/agents/<agentId>/sessions/</code1>`
- Logs: `/tmp/openclaw/`
資格情報の保存先マップ
認証デバッグやバックアップ方針検討のための参照：
- **WhatsApp:** `<code1>~/.openclaw/credentials/whatsapp/<accountId>/creds.json</code1>`
- **Telegram bot token:** Config / Env, or `channels.telegram.tokenFile`
- **Discord bot token:** 設定 / 環境変数（トークンファイルは未対応）
- **Slack tokens:** Config / Env (`channels.slack.*`)
- **Pairing allowlists:** `<code1>~/.openclaw/credentials/<channel>-allowFrom.json</code1>`
- **Model Auth Profiles:** `<code1>~/.openclaw/agents/<agentId>/agent/auth-profiles.json</code1>`
- **Legacy OAuth Imports:** `~/.openclaw/credentials/oauth.json`
詳細：Security を参照。
更新（設定を壊さない）
- - `~/.openclaw/workspace` と `~/.openclaw/` は「自分のもの」として扱い、個人用プロンプト/設定を `openclaw` リポジトリ内に置かない。
- - ソース更新：`git pull` +（lockfile 変更時）`pnpm install` + `pnpm gateway:watch` を継続利用。
Linux（systemd ユーザーサービス）
Linux の導入では systemd の **ユーザー** サービスを使います。既定ではログアウト/アイドル時にユーザーサービスが停止されます。オンボーディングは lingering の有効化を試みます（sudo を求められる場合があります）。有効になっていなければ次を実行：
sudo loginctl enable-linger $USER
常駐運用やマルチユーザーサーバーでは、ユーザーサービスではなく **system** サービス（lingering 不要）も検討してください。systemd の注意点は Gateway runbook（運用） を参照。