核心要求
需要 Python >= 3.10 和 Git。
快速开始
几步即可安装并启动 NeuroClaw
在这一页中，你可以完成 NeuroClaw 的安装、启动与验证。
前置条件
可选项
建议使用 Conda 或 Mamba 隔离环境，GPU 场景可检查 nvidia-smi 或 nvcc。
Web UI 附件
建议安装 pypdf、python-docx、openpyxl、python-pptx。
安装向导
NeuroClaw 提供安装向导，帮助配置运行环境、工具链路径和 Web UI 相关依赖。
安装
克隆并配置
内置安装器会引导你完成 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在其他 Agent 系统中使用 NeuroClaw
将 NeuroClaw 安装为 router skill 或规则包，使宿主 agent 进入 NeuroClaw mode，并获得 NeuroClaw catalogs、NeuroOracle、NeuroBench、 模型工作流和神经影像技能。
| 宿主 agent | 安装命令 | 生成的集成位置 |
|---|---|---|
| Codex | python installer/install_agent_integration.py --target codex |
~/.codex/skills/neuroclaw/ |
| Claude Code | python installer/install_agent_integration.py --target claude-code |
~/.claude/skills/neuroclaw/ |
| Cursor | python installer/install_agent_integration.py --target cursor --scope project |
.cursor/rules/neuroclaw.mdc 和生成的 references |
| OpenClaw | python installer/install_agent_integration.py --target openclaw |
~/.openclaw/skills/neuroclaw/ |
| Hermes | python installer/install_agent_integration.py --target hermes |
~/.hermes/skills/neuroclaw/ |
| WorkBuddy | python installer/install_agent_integration.py --target workbuddy |
~/.workbuddy/skills/neuroclaw/ |
| QClaw | python installer/install_agent_integration.py --target qclaw |
~/.qclaw/skills/neuroclaw/ |
python installer/install_agent_integration.py --target both
python installer/install_agent_integration.py --target all
python installer/install_agent_integration.py --target all --export ./dist/agent-integrations安装后，可以让宿主 agent “use NeuroClaw” 或 “enter NeuroClaw mode” 来处理神经影像和 autoresearch 任务。如果宿主 agent 使用不同的导入位置， 可以先导出生成的 skill pack，再手动导入或复制。
如果希望 Codex、Claude Code、Cursor 或其他宿主 agent 使用自己的内置模型， 而不是 NeuroClaw 配置中的 LLM API key 来做 autoresearch，可以启动基于文件协议的 host-agent 循环：
python -m neurooracle.src.hypothesis_cli host-agent-init case1_transdiagnostic --output-dir neurooracle/data/host_agent_runs/case1 --max-rounds 5
宿主 agent 会读取 tasks/round_XXX_task.json，以 NeuroClaw 的身份承担假设生成、
critic 审核和实验监督，写入 host_outputs/round_XXX_result.json，
然后用下面的命令推进下一轮：
python -m neurooracle.src.hypothesis_cli host-agent-next --run-dir neurooracle/data/host_agent_runs/case1验证安装
可以用下面的检查确认环境文件和技能注册表工作正常。
# 检查环境文件是否有效
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 和其他页面。