セットアップ

初めてセットアップする場合は、はじめにから始めてください。ウィザードの詳細については、オンボーディングウィザードを参照してください。

最終更新：2026-01-01

要約

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

前提条件（ソースから）

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

カスタマイズ戦略（更新を妨げないように）

「100%自分用にカスタマイズ」_かつ_簡単な更新が必要な場合、カスタマイズを以下に保存します：

設定： ~/.mayros/mayros.json（JSON/JSON5-ish）
ワークスペース： ~/.mayros/workspace（スキル、プロンプト、メモリ。プライベートgitリポジトリにしてください）

一度だけブートストラップ：

bash
mayros setup

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

bash
mayros setup

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

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

pnpm buildの後、パッケージ化されたCLIを直接実行できます：

bash
node mayros.mjs gateway --port 18789 --verbose

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

Mayros.app（メニューバー）をインストール + 起動。
オンボーディング/権限チェックリストを完了（TCCプロンプト）。
Gatewayがローカルで実行中であることを確認（アプリが管理）。
サーフェスをリンク（例：WhatsApp）：

bash
mayros channels login

サニティチェック：

bash
mayros health

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

mayros setupを実行し、次にmayros channels login、次にGatewayを手動で開始（mayros gateway）。

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

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

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

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

bash
./scripts/restart-mac.sh

1）開発Gatewayを開始

bash
pnpm install
pnpm gateway:watch

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

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

Mayros.appで：

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

3）検証

アプリ内Gateway状態は**「既存のgatewayを使用中...」**と表示されるはずです
またはCLI経由で：

bash
mayros health

一般的な落とし穴

間違ったポート： Gateway WSのデフォルトはws://127.0.0.1:18789。アプリ + CLIを同じポートに保ちます。
状態の場所：
- 認証情報：~/.mayros/credentials/
- セッション：~/.mayros/agents/<agentId>/sessions/
- ログ：/tmp/mayros/

認証情報ストレージマップ

認証のデバッグやバックアップ対象の決定時に使用：

WhatsApp：~/.mayros/credentials/whatsapp/<accountId>/creds.json
Telegramボットトークン：設定/環境またはchannels.telegram.tokenFile
Discordボットトークン：設定/環境（トークンファイルはまだサポートされていません）
Slackトークン：設定/環境（channels.slack.*）
ペアリング許可リスト：~/.mayros/credentials/<channel>-allowFrom.json
モデル認証プロファイル：~/.mayros/agents/<agentId>/agent/auth-profiles.json
レガシーOAuthインポート：~/.mayros/credentials/oauth.json 詳細：セキュリティ。

更新（セットアップを台無しにしない）

~/.mayros/workspaceと~/.mayros/を「あなたのもの」として保ち、個人的なプロンプト/設定をmayrosリポジトリに入れないでください。
ソースの更新：git pull + pnpm install（ロックファイルが変更された場合）+ pnpm gateway:watchを引き続き使用。

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

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

bash
sudo loginctl enable-linger $USER

常時オンまたはマルチユーザーサーバーの場合、ユーザーサービスの代わりにシステムサービスを検討してください（lingering不要）。systemdノートについては、Gatewayランブックを参照してください。