[ INSTALL // FROM ZERO TO TELEGRAM ]

Mister Morph のインストールと初期化

バイナリ導入 -> Agent 必要ファイル導入 -> API Key 設定 -> 1回実行 -> Telegram 会話、の順で進めます。

1. ダウンロードしてインストール

推奨: GitHub release スクリプトでインストールします。

curl -fsSL -o /tmp/install-mistermorph.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install-mistermorph.sh

インストーラーは次の使い方にも対応しています:

  • bash install-release.sh <version-tag>
  • INSTALL_DIR=$HOME/.local/bin bash install-release.sh <version-tag>

代替: ソースからインストールする場合。

go install github.com/quailyquaily/mistermorph/cmd/mistermorph@latest

2. Agent の必要ファイルと内蔵 Skills を導入

mistermorph install
# または
mistermorph install &lt;dir&gt;

install コマンドは ~/.morph/skills/(または <dir>)に必要ファイルと内蔵 Skills を配置します。

3. API Key を設定

config.yaml を作らずに、まず環境変数で実行できます:

export MISTER_MORPH_LLM_API_KEY=&#34;YOUR_OPENAI_API_KEY_HERE&#34;
# 任意: 明示的なデフォルト指定
export MISTER_MORPH_LLM_PROVIDER=&#34;openai&#34;
export MISTER_MORPH_LLM_MODEL=&#34;gpt-5.2&#34;

Mister Morph は Azure OpenAI、Anthropic Claude、AWS Bedrock などもサポートしています(詳細は assets/config/config.example.yaml)。ファイル設定を使う場合は ~/.morph/config.yaml を利用してください。

4. 1回実行で動作確認

mistermorph run --task &#34;Hello!&#34;

応答が返ればローカル Quick Start は完了です。

5. Telegram を接続して Agent と会話

5.1 Bot Token を作成

  1. Telegram で @BotFather を開きます。
  2. /newbot で Bot を作成します。
  3. 発行された token を控えます。

5.2 Telegram 設定を追加

~/.morph/config.yaml を編集:

telegram:
  bot_token: &#34;YOUR_TELEGRAM_BOT_TOKEN_HERE&#34;
  allowed_chat_ids: [] # 許可する chat id を追加

5.3 Telegram モードを起動

mistermorph telegram --log-level info

5.4 Telegram で会話開始

  1. まず /id を送って chat id を取得します。
  2. その id を telegram.allowed_chat_ids に追加して、mistermorph telegram --log-level info を再起動します。
  3. Telegram グループで使う場合、Bot にメッセージ閲覧権限を付与しないと、グループの投稿を受け取れないことがあります。
  4. 個人チャットは通常メッセージで会話できます。グループでは /ask <task> か、Bot へのメンション/返信を使います。
  5. 会話履歴を消すときは /reset

6. 次にやること

最新かつ完全なドキュメントは GitHub を参照してください: