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@latest2. Agent の必要ファイルと内蔵 Skills を導入
mistermorph install
# または
mistermorph install <dir>install コマンドは ~/.morph/skills/(または <dir>)に必要ファイルと内蔵 Skills を配置します。
3. API Key を設定
config.yaml を作らずに、まず環境変数で実行できます:
export MISTER_MORPH_LLM_API_KEY="YOUR_OPENAI_API_KEY_HERE"
# 任意: 明示的なデフォルト指定
export MISTER_MORPH_LLM_PROVIDER="openai"
export MISTER_MORPH_LLM_MODEL="gpt-5.2"Mister Morph は Azure OpenAI、Anthropic Claude、AWS Bedrock などもサポートしています(詳細は assets/config/config.example.yaml)。ファイル設定を使う場合は ~/.morph/config.yaml を利用してください。
4. 1回実行で動作確認
mistermorph run --task "Hello!"応答が返ればローカル Quick Start は完了です。
5. Telegram を接続して Agent と会話
5.1 Bot Token を作成
- Telegram で
@BotFatherを開きます。 /newbotで Bot を作成します。- 発行された token を控えます。
5.2 Telegram 設定を追加
~/.morph/config.yaml を編集:
telegram:
bot_token: "YOUR_TELEGRAM_BOT_TOKEN_HERE"
allowed_chat_ids: [] # 許可する chat id を追加5.3 Telegram モードを起動
mistermorph telegram --log-level info5.4 Telegram で会話開始
- まず
/idを送って chat id を取得します。 - その id を
telegram.allowed_chat_idsに追加して、mistermorph telegram --log-level infoを再起動します。 - Telegram グループで使う場合、Bot にメッセージ閲覧権限を付与しないと、グループの投稿を受け取れないことがあります。
- 個人チャットは通常メッセージで会話できます。グループでは
/ask <task>か、Bot へのメンション/返信を使います。 - 会話履歴を消すときは
/reset。
6. 次にやること
最新かつ完全なドキュメントは GitHub を参照してください: