如何 5 分钟上手 Echo Agent：从安装到首次对话的完整新手教程

• 人工智能
• AI Agent
• 大模型
• Agent 记忆
• 工具调用
• RAG
• MCP 服务
• MCP Clients

Echo Agent 是一款面向长期运行与桌面协作的开源 AI Agent，自带常驻 Runtime、长期记忆与技能自进化能力。这篇 Echo Agent 新手教程将带你用约 5 分钟完成安装、模型配置与首次对话，无需任何编程基础。

学完本教程后，你将掌握：

• Echo Agent 适合哪些场景、有哪些核心功能
• 一条命令完成安装并验证成功
• 通过setup向导完成模型配置
• 启动 Agent 并发送第一条消息
• 如何验证长期记忆是否正常工作

什么是 Echo Agent：适合新手的 AI Agent 运行时

Echo Agent 不是一个聊天机器人，而是一个可自托管的 Agent 运行时（Runtime），核心能力包括：

它提供三种使用形态，本教程从最简单的本地终端形态（echo-agent run）入手。

准备工作：Echo Agent 安装前的环境检查

在安装之前，确认你的电脑满足以下要求：

💡小贴士：Windows 用户推荐通过 WSL2 运行；安装前需要准备好一个模型提供商（如 OpenAI、Anthropic、Gemini 等）的 API Key，后面的配置向导会用到。

详细系统要求见 安装指南。

一键安装 Echo Agent：pip 安装最快步骤

打开终端，执行一条命令即可完成安装：

pip install "echo-agent[all]"

[all]表示安装常用的可选依赖集合。如果想精简安装，也可以只装核心 + 指定提供商：

pip install echo-agent # 仅核心运行时 pip install "echo-agent[openai]" # 按需添加模型提供商

国内网络加速：中国大陆用户可指定 PyPI 镜像源：

pip install "echo-agent[all]" -i https://mirrors.aliyun.com/pypi/simple/

推荐在虚拟环境中安装，避免依赖冲突：

python -m venv ~/.echo-agent/venv source ~/.echo-agent/venv/bin/activate pip install "echo-agent[all]"

安装完成后验证一下：

echo-agent --version # 输出: echo-agent 0.3.8

看到版本号输出，说明安装成功。✅

配置模型：setup 向导四步搞定

安装后运行配置向导：

echo-agent setup

向导会依次引导你完成 4 项配置，全程交互式菜单，直接按提示选择即可：

1. 选择模型提供商— OpenAI、Anthropic、Gemini、Bedrock、OpenRouter 或 OpenAI 兼容端点
2. 输入 API Key— 对应提供商的密钥
3. 选择模型— 如gpt-4o、claude-sonnet-4-20250514、gemini-2.0-flash
4. 基本参数— Agent 名称、语言偏好等

配置文件会保存在~/.echo-agent/config.yaml。如果不想用向导，也可以直接手动编辑该文件，然后用echo-agent config validate校验。完整配置项说明见 配置指南。

首次对话：启动 Agent 并发送第一条消息

一切就绪，启动你的第一个 Echo Agent：

echo-agent run

在终端提示符中直接输入消息并回车：

You: 你好，请介绍一下你自己

Agent 会回复你，并且记住这次对话——这就是长期记忆系统的第一个体现。

如果连接模型失败，先运行echo-agent config validate检查配置是否有误。

验证安装成功与记忆是否生效

在另一个终端确认运行状态与费用统计：

echo-agent status # 查看配置与运行能力摘要 echo-agent cost # 查看费用统计

验证记忆的小技巧🧪：退出后重新启动 Agent，问它"我们上次聊了什么"——如果它能回忆起来，说明记忆系统工作正常。

进阶一步：打开 Dashboard 管理你的 Agent

当你想管理会话、记忆、技能和定时任务时，可以启动 Gateway 服务：

echo-agent gateway

然后浏览器访问http://127.0.0.1:58123/，即可看到 Dashboard 管理面板，包含 Overview、Sessions、Memory、Skills、Cron 等页面。用法详见 Dashboard 指南。

此外，Echo Agent 还提供EchoAgent Desktop桌面工作台，把 Agent 能力带入本地工作区，支持文件操作、浏览器自动化、代码开发与 Diff 审阅等场景：

桌面端的构建与使用说明见 EchoAgent Desktop 文档。

新手常见问题 FAQ

更多命令详见 CLI 参考。

接下来去哪：Echo Agent 学习路线

恭喜你，5 分钟跑通了从安装到首次对话的完整流程！接下来可以按兴趣继续探索：

核心代码位于 echo_agent/ 目录，终端与 Gateway 的运行时逻辑都从这里开始；完整目录结构说明见 代码地图。现在，去给你的 Echo Agent 起个名字，开始第一次真正的对话吧！🚀

• 人工智能
• AI Agent
• 大模型
• Agent 记忆
• 工具调用
• RAG
• MCP 服务
• MCP Clients