Mister Morph 安装与初始化

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. 初始化运行文件与内置技能

mistermorph install
# 或
mistermorph install <dir>

这一步会把运行所需文件和内置技能安装到 ~/.morph/skills/（或你指定的 <dir>）。

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 先创建 Telegram 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 里开始对话

先给 bot 发送 /id，拿到当前 chat id。
把这个 id 填进 telegram.allowed_chat_ids，然后重启 mistermorph telegram --log-level info。
如果是在 Telegram 群里使用，可能需要给机器人开启“读取消息”相关权限，否则它可能收不到群消息。
私聊里可直接发问题；群聊里用 /ask <任务>，或 @ 机器人 / 回复机器人消息。
需要清空历史时，发送 /reset。

6. 下一步

想看完整且最新的文档，请直接前往 GitHub：

Mister Morph GitHub 文档