核心要求
需要 Python >= 3.10 和 Git。
快速开始
几步即可安装并启动 NeuroClaw
在这一页中，你可以完成 NeuroClaw 的安装、启动与验证。
前置条件
可选项
建议使用 Conda 或 Mamba 隔离环境，GPU 场景可检查 nvidia-smi 或 nvcc。
Web UI 附件
建议安装 pypdf、python-docx、openpyxl、python-pptx。
自包含
NeuroClaw 已经自包含，不需要单独安装 OpenClaw。
安装
克隆并配置
内置安装器会引导你完成 Python 运行时、CUDA/GPU、神经影像工具链、LLM 后端、默认目录以及 Web UI 依赖的配置。
- 克隆仓库。
- 运行安装向导：
python installer/setup.py - 如需快速配置，可使用
--non-interactive。 - 如有需要，可手动安装 Web UI 依赖。
git clone https://github.com/CUHK-AIM-Group/NeuroClaw.git
cd NeuroClaw
python installer/setup.py
python installer/setup.py --non-interactive
pip install "fastapi[standard]" uvicorn pypdf python-docx openpyxl python-pptx快速使用
启动 NeuroClaw
你可以在终端里使用 REPL，也可以使用浏览器 Web UI。
- 终端 REPL：
python core/agent/main.py - Web UI：
python core/agent/main.py --web - 浏览器访问
http://localhost:7080。 - 如需远程访问或自定义端口，可使用
--port和--host。
python core/agent/main.py
python core/agent/main.py --web
python core/agent/main.py --web --port 8080 --host 0.0.0.0验证安装
可以用下面的检查确认环境文件和技能注册表工作正常。
# 检查环境文件是否有效
python installer/setup.py --check
# 列出已注册的神经科学技能（Python）
python -c "
from core.skill_loader.loader import SkillLoader
from pathlib import Path
skills = SkillLoader(Path('skills')).load_all()
for s in skills:
print(s['name'])
"下一步
NeuroClaw 启动后，你就可以从主页继续浏览 benchmark、FAQ 和其他页面。