オンボーディングウィザード（CLI）

オンボーディングウィザードは、macOS、Linux、またはWindows（WSL2経由。強く推奨）でMayrosをセットアップするための推奨方法です。 ローカルGatewayまたはリモートGateway接続、さらにチャネル、スキル、 ワークスペースのデフォルトを1つのガイド付きフローで設定します。

bash
mayros onboard

最速の最初のチャット：Control UIを開きます（チャネルセットアップ不要）。 mayros dashboardを実行してブラウザでチャットします。ドキュメント：ダッシュボード。

後で再設定するには：

bash
mayros configure
mayros agents add <name>

--jsonは非インタラクティブモードを意味しません。スクリプトには--non-interactiveを使用してください。

推奨：エージェントがweb_searchを使用できるようにBrave Search APIキーをセットアップします （web_fetchはキーなしで動作します）。最も簡単なパス：mayros configure --section web でtools.web.search.apiKeyを保存します。ドキュメント：Webツール。

QuickStart vs Advanced

ウィザードはQuickStart（デフォルト）vs Advanced（完全制御）で始まります。

  • ローカルgateway（ループバック）
  • ワークスペースデフォルト（または既存のワークスペース）
  • Gatewayポート18789
  • Gateway認証トークン（自動生成、ループバックでも）
  • Tailscale公開オフ
  • Telegram + WhatsApp DMはデフォルトで許可リスト（電話番号の入力を求められます）

ウィザードが設定するもの

**ローカルモード（デフォルト）**は、これらのステップを順に進めます：

  1. モデル/認証 — Anthropic APIキー（推奨）、OpenAI、またはカスタムプロバイダー （OpenAI互換、Anthropic互換、または不明自動検出）。デフォルトモデルを選択。
  2. ワークスペース — エージェントファイルの場所（デフォルト~/.mayros/workspace）。ブートストラップファイルをシード。
  3. Gateway — ポート、バインドアドレス、認証モード、Tailscale公開。
  4. チャネル — WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles、またはiMessage。
  5. デーモン — LaunchAgent（macOS）またはsystemdユーザーユニット（Linux/WSL2）をインストール。
  6. ヘルスチェック — Gatewayを起動して実行中であることを確認。
  7. スキル — 推奨スキルとオプションの依存関係をインストール。

ウィザードを再実行しても、明示的にリセットを選択（または--resetを渡す）しない限り、何も削除されません。 設定が無効またはレガシーキーが含まれている場合、ウィザードは最初にmayros doctorを実行するように求めます。

リモートモードは、他の場所のGatewayに接続するようにローカルクライアントのみを設定します。 リモートホスト上で何もインストールまたは変更しません。

別のエージェントを追加

mayros agents add <name>を使用して、独自のワークスペース、 セッション、認証プロファイルを持つ個別のエージェントを作成します。--workspaceなしで実行するとウィザードが起動します。

設定するもの：

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

注意事項：

  • デフォルトのワークスペースは~/.mayros/workspace-<agentId>に従います。
  • インバウンドメッセージをルーティングするためにbindingsを追加（ウィザードがこれを実行できます）。
  • 非インタラクティブフラグ：--model、--agent-dir、--bind、--non-interactive。

完全リファレンス

詳細なステップバイステップの内訳、非インタラクティブスクリプト、Signalセットアップ、 RPC API、およびウィザードが書き込む設定フィールドの完全なリストについては、 ウィザードリファレンスを参照してください。

関連ドキュメント