AGI-Walker 是一个面向机器人设计、仿真、工作流编排和 Web/Godot 集成的 Python 平台。仓库当前包含 Skills 系统、Workflow Orchestrator、Web Panel、Godot Agent backend,以及一个可直接接入 MCP 客户端的 stdio server。
Skills + Workflows:用SKILL.md和 workflow 定义组织机器人建模、参数优化、任务执行等流程。Web Panel:基于 FastAPI 的控制面板,提供 workflow、服务状态、Godot 会话和 nightly 状态接口。Godot 集成:同时支持 legacy backend 和 moderngodot-agentbackend。Distributed / Smoke:仓库内置 CLI、workflow、Web、distributed 和可选的 Godot headless smoke 测试。MCP Server:通过agi_walker.mcp.server把任务执行、workflow、skills 和 Godot 能力暴露给 MCP 客户端。
要求:
- Python
>=3.10
基础安装:
pip install -e .开发依赖:
pip install -e ".[dev]"列出 skills:
python -m agi_walker.cli skills list运行环境自检:
python -m agi_walker.cli doctor查看 workflow 帮助:
python -m agi_walker.cli workflows run --help启动 Web Panel:
python -m web_panel.server默认地址:
http://localhost:8000
仓库已经提供 MCP stdio server。安装后可以直接启动:
agi-walker-mcp也可以使用模块入口:
python -m agi_walker.mcp.server当前暴露的工具包括:
mission_executerobot_telemetryrag_queryworkflows_listworkflow_getworkflow_executeskills_listskill_getgodot_agent_statusgodot_agent_templatesgodot_agent_plangodot_agent_doctorgodot_agent_history
这些工具覆盖的能力范围:
- 自然语言任务规划与执行
- workflow 查询与执行
- skills 元数据和文档读取
- Godot Agent backend 状态、模板、计划、自检和历史记录
更完整的说明见 docs/mcp.md。
MCP 相关测试:
python -m pytest tests/test_mcp_tools.py tests/test_mcp_server.py -q仓库 smoke 测试:
python tests/run_smoke_tests.py可选的 Godot headless smoke:
$env:AGI_WALKER_ENABLE_GODOT_HEADLESS_SMOKE='1'
python -m pytest tests/test_godot_headless_smoke.py -q -m integration --tb=short -vvagi_walker/:核心 Python 包,包含 CLI、workflow、skills、integrations 和 MCP server。web_panel/:FastAPI Web 控制面板和相关 API。godot_project/:Godot 工程与场景资源。godot_studio_agent/:Godot Agent 侧角色、路由和工具。tests/:单元测试、smoke 测试和集成测试。docs/:架构、迁移、CLI/Web/MCP 指南及当前状态说明。