OpenClaw支持三种自定义地图导入方式：一、手动复制含map.json和terrain.map的地图文件夹至maps目录；二、用map.register_path命令注册外部路径，但需每次启动后重新执行；三、用MapBuilder CLI工具将elevation.png等素材打包为合规地图包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在OpenClaw中使用非内置的地图，需通过规范路径放置地图文件并完成格式识别与注册。以下是实现自定义地图导入的多种方法：
一、手动复制地图文件至资源目录
此方法适用于已具备正确结构的外部地图包（含.map、.json配置及纹理资源），通过标准路径部署使OpenClaw自动扫描加载。
1、确认OpenClaw安装目录下的maps子文件夹存在；若不存在，请手动创建该文件夹。
2、将解压后的自定义地图文件夹整体复制到maps目录内，确保其内部包含map.json和terrain.map（或同名.map文件）。
3、检查map.json中"version"字段值是否为OpenClaw当前支持的版本号，不匹配将导致地图无法显示。
4、启动OpenClaw，在地图选择界面刷新列表，新地图应出现在“本地地图”分类下。
二、通过控制台命令注册外部地图路径
此方法允许OpenClaw从任意指定位置读取地图，无需移动文件，适合多项目协作或地图频繁更新场景。
1、打开OpenClaw主程序，按下~键调出开发者控制台。
2、输入指令：map.register_path "D:/MyMaps/CustomIsland"，其中路径需替换为实际存放地图的绝对路径。
3、执行后控制台返回Registered 1 map(s)表示成功识别；若返回0，请检查路径内是否含有合法map.json文件。
4、关闭并重启OpenClaw，仅注册路径不会持久化，每次启动需重新执行该命令。
三、使用地图打包工具生成兼容包
针对原始素材（如高度图、遮罩图等）尚未封装为OpenClaw可识别格式的情况，需借助官方地图打包工具进行转换。
1、下载OpenClaw配套工具集MapBuilder CLI，解压至本地非中文路径目录。
2、准备素材：将PNG格式的高度图命名为elevation.png，遮罩图命名为mask.png，置于同一文件夹。
3、在该文件夹路径下打开命令行，运行：mapbuilder build --name "DesertRuins" --author "User" --output ../maps/。
4、生成完成后，检查../maps/DesertRuins/目录中是否存在map.json与terrain.map；缺少任一文件则打包失败。
