Mister Morph 安装与初始化

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 运行所需文件与内置技能

mistermorph install
# 或
mistermorph install &lt;dir&gt;

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

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. 一次性运行测试

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

能正常返回结果，就说明本地 Quick Start 完成了。

5. 接入 Telegram，并开始和 Agent 聊天

5.1 先创建 Telegram Bot Token

打开 Telegram，找到 @BotFather。
输入 /newbot，按提示创建机器人。
复制生成的 bot 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 里开始对话

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

6. 下一步

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

Mister Morph GitHub 文档