ドキュメント · ガイド

OpenMausBot を任意のモデルで

OpenMausBot はオープンソースの Electron チャットアプリで、そのボットはコンピューターにインストールされた CLI を動かします。設定はデータフォルダーの config.json にあり、$OMB_DATA_DIR があればそこ、なければどのシステムでも ~/.openmausbot です。ボットが使える各エンジンはこのファイルの instances の 1 項目です。magpie はここに自分のエンジン magpie を加えるので、ボットが DeepSeek・GLM・Kimi・Qwen・Claude・ChatGPT サブスクリプションなど magpie のモデルで動きます。

OpenMausBot の設定

  1. magpie でプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. OpenMausBot を終了OpenMausBot が開いている間、magpie は変更を断ります(Windows では開いているか分からないので、先に終了してください)。
  3. エージェント ページで OpenMausBot のプロバイダーを magpie にするmagpie はすべての magpie のモデルを magpie エンジンのピッカーに入れます。
  4. OpenMausBot を開き、ボットのエンジンに magpie を選ぶそれからエンジンのピッカーでモデルを選びます。

magpie エンジン

専用のエンジンが要る理由:OpenMausBot の Claude ボットは Claude Code を隔離して動かし、~/.claude/settings.json のサインイン関連のキーだけを引き継ぐので、magpie につないだ Claude Code はゲートウェイに届いても、ピッカーには Claude 自身のモデルしか出ません。Codex ボットは ~/.codex をそのまま使い、これは magpie の Codex の接続ですでにカバーされます。

magpie は OpenMausBot 自身が Claude エンドポイントを書く形でこのエンジンを書きます。access が custom の claudeAgent で、専用の Claude ホームを持ち、API キーを必須にし、ゲートウェイのアドレスと magpie のキーを ANTHROPIC_BASE_URL・ANTHROPIC_AUTH_TOKEN・ANTHROPIC_API_KEY に、すべての magpie のモデルを endpointModels に入れます。これらのキーを持つエンジンは自分でルーティングを決め、あなたの設定も OpenMausBot でのプロバイダー切り替えも届きません。OpenMausBot に自分の Claude Code を指定していれば、magpie エンジンもそれを使います。

ターミナル
// ~/.openmausbot/config.json
"instances": {
  "magpie": {
    "driver": "claudeAgent",
    "displayName": "magpie",
    "access": "custom",
    "config": {
      "configDir": "~/.openmausbot/providers/magpie",
      "requireApiKey": true,
      "endpointModels": […]
    },
    "environment": {
      "ANTHROPIC_BASE_URL": "http://127.0.0.1:3425",
      "ANTHROPIC_AUTH_TOKEN": "",
      "ANTHROPIC_API_KEY": "",
      "ANTHROPIC_MODEL": "…"
    }
  },
  …
}

1M のモデルには [1m] が付きます。OpenMausBot が受け付けないモデル ID は除きます。そうした ID が 1 つでもあると、エンジン全体が拒否されるからです。

既定のエンジンはそのまま

config.json にエンジンが保存されていないとき、OpenMausBot は既定のエンジン群で動きます。保存された instances がエンジンのすべてなので、magpie のものだけを書くとほかのエンジンが消えてしまいます。そのためファイルにエンジンがないとき、magpie は既定のエンジン群を自分のものと一緒に書きます。

先に終了する理由

OpenMausBot は起動時にこのファイルを読み、設定でエンジンを 1 つ変えると、メモリにあるエンジン表をまるごと書き戻します。そのため開いている間は magpie が変更を断ります。同期はそれでも書き込み、OpenMausBot が上書きした分は次の同期か 30 秒以内に書き直されます。OpenMausBot がファイルより古いリストで動いているときは、magpie のエージェントページから再起動できます。

自分の設定はそのまま

magpie エンジンの名前・色・アイコン・オンかどうかと非表示かどうか、magpie が書かないキー、ルーティング以外の環境変数はあなたのものです。最初に選んだモデルも、magpie がまだ載せている限りそのままです。ルーティング、Claude ホーム、モデルのリストは magpie のものです。

元に戻す

magpie で OpenMausBot をオフにすると、magpie は自分のエンジンを取り除き、一緒に書いた既定のエンジン群もそのままなら取り除きます。OpenMausBot はその時点の既定のエンジンで動きます。

よくある質問

OpenMausBot のボットで DeepSeek や GLM を使えますか?

使えます。magpie が config.json に magpie エンジンを加えるので、ボットのエンジンにそれを選び、モデルを選んでください。

なぜ先に OpenMausBot を終了するのですか?

エンジンを変えるとエンジン表をまるごと書き戻し、magpie の変更を上書きするので、開いている間は magpie が変更を断ります。

ほかのエンジンは消えますか?

消えません。ファイルにエンジンが保存されていないとき、magpie は OpenMausBot の既定のエンジン群を一緒に書きます。

Codex ボットで magpie を使うには?

OpenMausBot の Codex ボットは ~/.codex をそのまま使い、magpie の Codex の接続ですでにカバーされます。

同じモデルを他のエージェントでも:Mistral Vibe を任意のモデルで、Pencil を任意のモデルで、Claude Desktop を任意のモデルで、JetBrains Copilot を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。