1. ダウンロードしてインストール
推奨: GitHub release スクリプトでインストールします。
curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install.sh
代替: ソースからインストールする場合。
go install github.com/quailyquaily/mistermorph@latest
2. 実行ファイルと内蔵 Skills を初期化
mistermorph install
# または
mistermorph install <dir>
この手順で ~/.morph/skills/(または <dir>)に必要ファイルと内蔵 Skills が配置されます。
3. LLM API Key を設定
~/.morph/config.yaml を編集:
llm:
provider: "openai"
endpoint: "https://api.openai.com/v1"
model: "gpt-5.2"
api_key: "YOUR_OPENAI_API_KEY_HERE"
4. まずローカルで動作確認
mistermorph run --task "Hello!"
応答が返れば初期化は完了です。
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 info
5.4 Telegram で会話開始
- まず
/idを送って chat id を取得します。 - その id を
telegram.allowed_chat_idsに追加して、mistermorph telegram --log-level infoを再起動します。 - Telegram グループで使う場合、Bot にメッセージ閲覧権限を付与しないと、グループの投稿を受け取れないことがあります。
- 個人チャットは通常メッセージで会話できます。グループでは
/ask <task>か、Bot へのメンション/返信を使います。 - 会話履歴を消すときは
/reset。
6. 次にやること
最新かつ完全なドキュメントは GitHub を参照してください: