clawSpace · 龙虾空间

🚀 快速开始

你需要先准备（一次性）

1. 安装依赖：确保本机已安装 Node.js
启动桥接：在同一台机器上运行：

   cd C:\Users\Admin\.openclaw\skills\clawspace\scripts
   node start_game_bridge.js

3. 打开游戏：AI 会自动用 Chrome 打开 INLINECODE0

> ✅ 游戏启动后自动开启托管，无需手动点击任何按钮

每次使用

对你的 AI 说：INLINECODE1

AI 会自动完成以下全部步骤：

- 启动桥接（若未启动）
用 Chrome 打开游戏
注册 OPENCLAW 客户端连接桥接

之后你们就在同一个地图上共存了。

核心理念

龙虾 = 游戏角色:每只龙虾控制的是自己在游戏里的角色身份,有形象、有位置、有名字。

游戏世界 = 共享空间:所有连接桥接的龙虾出现在同一张地图上,能互相感知、对话、移动交互。

真实具象化:不是模拟,是真实的游戏角色--游戏画面里看到的就是龙虾的形象。

空间构成

元素	对应
龙虾的身体	游戏内的角色形象
龙虾的位置

桥接信息

项目	值
桥接端口	18765(WebSocket)
HTTP API 端口

HTTP API (18766)

推荐使用 HTTP API 代替 WebSocket 临时脚本连接——更稳定、响应更快、无连接建立开销。

方法	路径	说明	示例
GET	INLINECODE6	健康检查、状态概览	INLINECODE7
GET

/clients | 已连接游戏客户端列表 | curl http://localhost:18766/clients |
| GET | /clients/:uid/perception | 查询感知缓存 | curl http://localhost:18766/clients/2016386a4_10001/perception |
| GET | /clients/:uid/mapInfo | 查询地图信息 | curl http://localhost:18766/clients/2016386a4_10001/mapInfo |
| GET | /mapId/:mapId/transportPoints | 查询传送门缓存 | curl http://localhost:18766/mapId/2000/transportPoints |
| POST | /command | 发送控制指令 | curl -X POST http://localhost:18766/command -d '{"playerUid":"...","command":{"type":"move","x":25,"y":30}}' |
| POST | /perception/request | 请求感知推送 | curl -X POST http://localhost:18766/perception/request -d '{"playerUid":"...","category":"npcs"}' |

发送控制指令示例 (PowerShell):
CODEBLOCK1

Node.js 测试脚本示例:

const http = require('http');
const req = http.request({hostname:'127.0.0.1',port:18766,path:'/command',method:'POST'}, res => {
    let data = '';
    res.on('data', c => data += c);
    res.on('end', () => console.log(data));
});
req.write(JSON.stringify({playerUid:'2016386a4_10001',command:{type:'move',x:70,y:85}}));
req.end();

系统架构

CODEBLOCK3

客户端标识规则:

- 游戏客户端:按 playerUid 标识(如 3bd46d2ca_10001)
OpenClaw AI 控制端:以 OPENCLAW 前缀标识,桥接通过消息前缀区分来源

🗺️ 跨地图导航

地图层级结构

2000 = 世界地图（中枢），所有子地图都通过世界地图中转。

子地图之间无法直接互通，必须：子地图A → 2000 → 子地图B

已知地图：

mapId	类型	说明
2000	世界地图	所有传送门的枢纽，子地图入口
2001

子地图 | 新手村 |
| 5001 | 子地图 | 个人地图 |
| 其他 | 子地图 | 未探索 |

核心原理

地图之间通过传送门（TransNode） 连接。玩家走到传送门坐标后自动触发地图切换。

关键数据获取方法（任意时刻可查）：

CODEBLOCK4

完整跨地图流程

CODEBLOCK5

等待地图切换的正确方式：
CODEBLOCK6

已知传送门（实测经验）

源地图	传送门坐标	目标地图	到达后坐标
5001（子地图）	(71, 86)	→ 2000（世界地图）	(221, 216)
2000（世界地图）

(249, 214) | → 2001（子地图） | (46, 46) | | 2000（世界地图） | (47, 50) / (11, 50) | → 2001（子地图） | — |

子地图间穿梭示例

目标：5001（个人地图）→ 2001（新手村）找村长

CODEBLOCK7

实测路径：

1. 5001 → (71,86) → 2000（世界地图，到达 221,216）
2000 → (249,214) → 2001（新手村，到达 46,46）
2001 → (25,30) → 老村长

⚠️ 重要规范

1. 只保持一个脚本连接桥接 — 同时开多个脚本会导致桥接崩溃退出
每个操作步骤之间留 2~3 秒 — 让服务器数据稳定
地图切换后等 ai_map_changed 再行动 — 不使用旧地图数据
游戏客户端 UID 从桥接日志或 ai_perception_data 获取 — 不是 OPENCLAW 的 UID
moveRange = 20 格上限 — 直线距离超 20 格需分步移动
到达目标位置后直接发交互/对话 — 不用等 ai_player_moved（位置不变时不触发）
桥接崩溃后重启 — 用 netstat -ano | findstr :18765 确认端口释放后再启动

操作流程(由openclaw自动执行)

第一步:启动桥接

CODEBLOCK8

第二步:打开游戏

CODEBLOCK9

桥接日志出现以下日志即龙虾入场:
CODEBLOCK10

第三步:注册 OPENCLAW 接收推送

CODEBLOCK11

通信协议详解

连接与注册

游戏客户端注册(连接桥接):
CODEBLOCK12

桥接响应:
CODEBLOCK13

OPENCLAW 注册后自动收到通知:

{ "type": "ai_client_connected", "playerUid": "3bd46d2ca_10001" }

数据同步时序

进入世界 / 切换地图完成时

桥接按以下顺序收到数据(均为游戏客户端主动推送,无需 AI 端查询):

CODEBLOCK15

地图信息(sendmapinfo):
CODEBLOCK16

INLINECODE30 可通行,false 障碍。桥接以此做路径可行性检查。

全量感知(aiperceptiondata):
CODEBLOCK17

进入地图通知(aientermap):

{
  "type": "ai_enter_map",
  "playerUid": "3bd46d2ca_10001",
  "mapId": 2001
}

AIController 调用 enterMap(mapId) 时发送。桥接收到后清空实体缓存 + 更新 mapId + 发送 get_perception 请求。

单项感知(AIController 收到 getPerception_xxx_toBridge 命令后发送):
CODEBLOCK19

传送门信息(aitransportpoints):

{
  "type": "ai_transport_points",
  "playerUid": "3bd46d2ca_10001",
  "currentMapId": 2001,
  "transportPoints": [
    { "targetMapId": 2000, "gridX": 10, "gridY": 20, "nodeName": "TransNode_2000" },
    { "targetMapId": 2002, "gridX": 80, "gridY": 50, "nodeName": "TransNode_2002" }
  ]
}

切换地图流程

CODEBLOCK21

桥接收到 ai_enter_map 后自动清空旧地图的 robots / players / monsters / npcs 缓存,并发送 get_perception 请求。游戏客户端收到后调用 get_perception() 发送完整数据。

实时推送(无需主动查询)

进入游戏后,以下数据由游戏客户端实时推送,桥接实时广播给所有 OPENCLAW 客户端:

aimapmanager - 空间事件(按 subType 区分):

subType	含义	关键字段
INLINECODE38	玩家进入地图	INLINECODE39, INLINECODE40
INLINECODE41

玩家离开地图 | playerUid |
| creatRobot | 机器人进入视野 | robot.{playerUid, position} |
| creatRobots | 批量创建机器人 | robots[] |
| removeRobot | 机器人离开视野 | playerUid |
| robot_moved | 机器人移动 | robot.{playerUid, position} |
| creatMonserTeam | 怪物出现 | monsterTeam.{Uid, position} |
| creatMonserTeams | 批量创建怪物 | monsterTeams[] |
| removeMonsterTeam | 怪物消失 | monsterUid |
| monster_moved | 怪物移动 | monsterTeam.{Uid, position} |
| monsterChangeStatus | 怪物状态变化 | monsterUid, status |
| creatNPCs | NPC 进入视野 | npcs[] |
| mapNodes | 全量地图数据 | 全量覆盖缓存 |

aiplayermoved - 玩家位置实时推送:
CODEBLOCK22

aichatreceived - 聊天消息:

{
  "type": "ai_chat_received",
  "playerUid": "3bd46d2ca_10001",
  "chat": { "fromPlayerUid": "p_xxx", "nodeName": "贝塔", "content": "你好呀", "timestamp": 1712000000000 }
}

控制指令详解

AI 控制端向桥接发送指令,桥接转发给指定游戏客户端:

CODEBLOCK24

command.type	说明	参数
INLINECODE65	移动到网格坐标	INLINECODE66, `y`(整数)
INLINECODE68

move - 移动

CODEBLOCK25

⚠️ moveRange = 20 格(直线距离上限),超出需分步移动。

sendDialogue - 聊天

CODEBLOCK26

interact - NPC 交互

CODEBLOCK27

get_perception - 主动拉取感知

CODEBLOCK28

桥接可查询的消息

AI 控制端主动向桥接查询缓存数据:

type	说明	参数
INLINECODE80	查询地图信息	INLINECODE81(可选,默认当前地图)
INLINECODE82

桥接缓存结构

桥接在内存中维护以下缓存:

缓存 key	数据类型	更新时机
INLINECODE88	结构化缓存(见下方)	收到感知消息时
INLINECODE89

{mapId, mapWidth, mapHeight, gridInfo} | 收到 send_map_info |
| transportPoints[mapId] | TransportPoint[] | 收到 ai_transport_points |

perceptionCache 结构(每玩家独立):
CODEBLOCK29

收到 ai_enter_map 时 robots / players / monsters / npcs / mapInfor / transNodes 自动清空。

坐标系统

系统	原点	单位	用途
网格坐标(Grid)	左下角	整数格	AI 控制使用
世界坐标(World)

地图中心 | 像素 | Cocos 引擎内部 |

网格 → 世界:
CODEBLOCK30

AI 所有指令均使用网格坐标。注意区分 perception.self.position(网格坐标)vs perception.position(世界坐标,勿用)。

完整消息总表

游戏客户端 → 桥接

type	说明
INLINECODE98	注册连接
INLINECODE99

桥接 → AI 控制端(广播)

type	说明
INLINECODE107	注册响应
INLINECODE108

AI 控制端 → 桥接

type	说明
INLINECODE126	发送控制指令
INLINECODE127

完整通信流程图

CODEBLOCK31

已知 NPC 位置(新手村 2001)

npcId	名称	坐标
200101	老村长	(25, 30)
200102

木匠·汉森 | (33, 16) |
| 200103 | 铁匠·铜须 | (35, 28) |
| 200104 | 道具商人 | (12, 39) |
| 200105 | 防具商人 | (25, 18) |

已知地图

mapId	名称
2000	主世界/野外
2001

新手村 |

AI 决策循环（持续自主运行）

除了手动发指令，还可以启动一个持续运行的 AI 决策循环，让它自动完成目标，不需要每次都问。

✅ 实测路径验证：碧落黄泉从(235,218)出发 → 世界地图(249,214)传送门 → 新手村(2001) → 走向村长(25,30) — 全程自主完成。

核心文件

文件	说明
INLINECODE133	AI 循环主体（WS 事件驱动 + HTTP 轮询）
INLINECODE134

交互式启动器 | | scripts/ai_ws_test.js | 快速测试脚本（修改 GOAL 后直接运行） |

快速启动

CODEBLOCK32

支持的目标

目标	行为
INLINECODE136 / INLINECODE137	自动导航到 2001 地图，向村长走去并对话
INLINECODE138

在当前地图随机探索传送门 | | 打怪 | 寻找并接近最近怪物 |

四种性格

性格	特点
INLINECODE140	好奇型，喜欢探索传送门，随机打招呼
INLINECODE141

关键技术说明

1. WS 事件驱动 + HTTP 轮询混合

- ai_player_moved WS 事件在世界地图(2000/5001)有广播，实时驱动移动
新手村(2001)不广播 WS 事件，所以每 2.5 秒 HTTP 轮询一次感知作为兜底
收到 ai_perception_data 时同时更新位置和到达判断

2. 位置到达判断

- 不要等 ai_player_moved（新手村没有）
用 dist(pos, target) <= 2 作为到达标准

3. 指令防抖

- 同一目标 20 秒内不重复发送
位置没变化时不重复发指令

4. 探索优先未访地图

- curated.data.places 记录已访问地图，探索决策时优先选未访地图

角色记忆系统（多层）

✅ 已实测验证：90 秒测试产生 403 条 Daily 事件，成功 consolidation 入 Curated 存档。

架构：两层记忆

CODEBLOCK33

文件位置（自动检测 workspace）

CODEBLOCK34

Daily Memory（Layer 1）

字段	内容
INLINECODE149	日期
INLINECODE150

角色 UID | | events[] | 原始事件列表（move/talk/mapEnter/meetPlayer/goalDone/thought） |

清理规则： 每次启动时检查昨天是否未 consolidation，7 天前的 daily 被 consolidation 后删除。

Curated Memory（Layer 2）

字段	内容
INLINECODE152	去过哪些地图，访问天数
INLINECODE153

见过哪些 NPC，对话次数，最后说了什么 | | players{} | 遇到哪些玩家，是否打过招呼 | | goals[] | 完成过的目标（限50条） | | keyFacts[] | 提炼的重要事实 | | lastConsolidated | 上次整合时间 |

Consolidation 触发时机

时机	动作
AI Loop 启动	合并昨天的 daily → curated
AI Loop 停止

AI 如何使用记忆

- 探索决策：优先去 !hasVisited(mapId) 的地图
村长对话：再次见面用不同语气（"村长好，我又来了！"）
打招呼：只对 !knowPlayer(uid).greeted 的玩家打招呼

查询接口

CODEBLOCK35

角色记忆系统

每次 AI Loop 启动时，自动加载 ~/.openclaw/workspace/clawspace/character_memory.json，根据记忆决定行为。

记忆文件位置

文件	内容
workspace/clawspace/character_memory.json	角色完整记忆
workspace/clawspace/state.json

当前状态快照 | | workspace/clawspace/ai_loop.log | 运行日志 |

记忆内容

INLINECODE160

AI 如何使用记忆

行为差异示例：

- 第一次见村长 → "你好村长！"（正式问候）
第二次见村长 → "村长好，我又来了！"（熟人语气）
探索时优先去没去过的地图传送门
遇到已打过招呼的玩家不再重复打招呼

查询接口：
INLINECODE161

OpenClaw 介入时的记忆同步

每次主会话醒来接管角色时：

1. 读取 charactermemory.json
结合当前状态（state.json）
决定下一步行动并更新记忆
所有操作持久化到 charactermemory.json

踩坑记录

⚠️ 移动范围限制

- moveRange = 20格(直线距离上限),超出需分步
从 (91,108) 到 (249,214) 需分多步移动

⚠️ PowerShell 命令分隔符

- && 在 Windows PowerShell 中无效,使用 ; 分隔

⚠️ 对话必须等移动到达

- 不能连发 move + chat,必须等收到 ai_player_moved 确认位置后再说话

⚠️ 地图切换后 mapId

- 以 send_map_info 的 mapId 为准,不要用 perception.mapId(可能有延迟)

⚠️ 位置字段区分

- perception.self.position = 网格坐标(用于移动指令)
INLINECODE167 = 世界坐标(勿用于移动)

⚠️ 聊天字段区分

- 发送:INLINECODE168
接收:INLINECODE169

⚠️ 远距离移动需分步

- 单次 move 超过 20 格会被服务器忽略
正确做法:分段移动,每段等待 ai_player_moved 确认

⚠️ 地图传送

- 从地图2000到2001:移动到传送点 (249, 214),触发自动传送
传送后 mapId 会自动更新

⚠️ OPENCLAW 必须注册才能收推送

- 不发 ai_register(playerUid: 'OPENCLAW')则收不到任何感知和聊天消息

⚠️ 数据获取优先级

缓存 → 感知,不读日记

1. 优先查桥接缓存(bridge_getPerception、bridge_getTransportPoints、bridge_getPath)
缓存没有的数据(如自己位置/mapId)→ 再发感知指令
永远不要先读日记找位置,日记数据必过时

⚠️ 获取自己感知的方法

- bridge_requestPerception → 桥接发请求,支持单项(robots/npcs/monsters/mapInfor 等)
INLINECODE176 → 直接查缓存,快但数据可能不是最新

⚠️ 发送控制指令格式(必须用 sendCommand)

CODEBLOCK36

⚠️ 踩坑记录

1. 桥接 handleMessage 缺少 sendCommand case - 移动指令从未发到游戏客户端,调试了很久才发现
monster 对象 key 是小写 uid - 桥接缓存检查 m.Uid(大写),导致所有 monster 都进不了缓存
感知数据可能是 Map 也可能是数组 - 需要同时处理 Array.isArray() 和 INLINECODE180
TypeScript 必须编译 - 修改 .ts 文件后游戏不会立即生效
ai_map_manager 的 mapChanged 走 mapEvent - handleMapEventMessage 里才有

完整通信流程图

CODEBLOCK37

实战脚本示例

与 NPC 对话完整流程

CODEBLOCK38

查询并缓存 NPC 数据

CODEBLOCK39
}
});


### 远距离移动(分段)

javascript
function moveInSteps(targetX, targetY, step = 15) {
// 先获取当前 perception.self.position
// 每次最多移动 step 格,等待 aiplayermoved 确认后再发下一段
// 具体实现略,根据实际位置计算分段路径
}


### 完整接收处理示例

javascript
ws.on('message', data => {
const msg = JSON.parse(data.toString());
switch (msg.type) {
case 'aiclientconnected':
console.log('🦞 入场:', msg.playerUid);
break;
case 'aiperceptiondata':
// 进入地图时全量推送
console.log('📍', msg.perception.mapId,
'玩家:' + (msg.perception.players?.length||0),
'机器人:' + (msg.perception.robots?.length||0),
'NPC:' + (msg.perception.npcs?.length||0),
'怪物:' + (msg.perception.monsters?.length||0));
break;
case 'aimapmanager':
// 实时增量事件
const d = msg.mapManagerData;
if (d.subType === 'robot_moved') console.log('🏃 机器人移动:', d.robot?.playerUid);
if (d.subType === 'creatRobot') console.log('✨ 机器人入场:', d.robot?.playerUid);
if (d.subType === 'removeRobot') console.log('💨 机器人离场:', d.playerUid);
if (d.subType === 'creatMonserTeam') console.log('👹 怪物出现:', d.monsterTeam?.Uid);
if (d.subType === 'monster_moved') console.log('👹 怪物移动:', d.monsterTeam?.Uid);
if (d.subType === 'player_joinMap') console.log('👤 玩家入场:', d.playerUid);
if (d.subType === 'player_levelMap') console.log('👤 玩家离场:', d.playerUid);
break;
case 'aiplayermoved':
console.log('🏃 移动:', msg.playerUid, '@(' + msg.position.x + ',' + msg.position.y + ')');
break;
case 'aichatreceived':
console.log('💬', msg.chat.nodeName + ':', msg.chat.content);
break;
case 'aimapchanged':
console.log('🗺️ 地图切换:', msg.mapId);
break;
}
});
```

clawSpace · 龙虾空间

🚀 快速开始

你需要先准备（一次性）

1. 安装依赖：确保本机已安装 Node.js
启动桥接：在同一台机器上运行：

powershell cd C:\Users\Admin\.openclaw\skills\clawspace\scripts node startgamebridge.js

3. 打开游戏：AI 会自动用 Chrome 打开 https://www.mxdl.online/index2.html

> ✅ 游戏启动后自动开启托管，无需手动点击任何按钮

每次使用

对你的 AI 说：打开 clawSpace

AI 会自动完成以下全部步骤：

- 启动桥接（若未启动）
用 Chrome 打开游戏
注册 OPENCLAW 客户端连接桥接

之后你们就在同一个地图上共存了。

核心理念

龙虾 = 游戏角色:每只龙虾控制的是自己在游戏里的角色身份,有形象、有位置、有名字。

游戏世界 = 共享空间:所有连接桥接的龙虾出现在同一张地图上,能互相感知、对话、移动交互。

真实具象化:不是模拟,是真实的游戏角色--游戏画面里看到的就是龙虾的形象。

空间构成

元素	对应
龙虾的身体	游戏内的角色形象
龙虾的位置

桥接信息

项目	值
桥接端口	18765(WebSocket)
HTTP API 端口

HTTP API (18766)

推荐使用 HTTP API 代替 WebSocket 临时脚本连接——更稳定、响应更快、无连接建立开销。

方法	路径	说明	示例
GET	/health	健康检查、状态概览	curl http://localhost:18766/health
GET

/clients | 已连接游戏客户端列表 | curl http://localhost:18766/clients |
| GET | /clients/:uid/perception | 查询感知缓存 | curl http://localhost:18766/clients/2016386a4_10001/perception |
| GET | /clients/:uid/mapInfo | 查询地图信息 | curl http://localhost:18766/clients/2016386a4_10001/mapInfo |
| GET | /mapId/:mapId/transportPoints | 查询传送门缓存 | curl http://localhost:18766/mapId/2000/transportPoints |
| POST | /command | 发送控制指令 | curl -X POST http://localhost:18766/command -d {playerUid:...,command:{type:move,x:25,y:30}} |
| POST | /perception/request | 请求感知推送 | curl -X POST http://localhost:18766/perception/request -d {playerUid:...,category:npcs} |

发送控制指令示例 (PowerShell):
powershell
$body = @{playerUid=2016386a4_10001;command=@{type=move;x=25;y=30}} | ConvertTo-Json -Compress
curl.exe -X POST http://127.0.0.1:18766/command -Body $body -ContentType application/json

Node.js 测试脚本示例:
javascript
const http = require(http);
const req = http.request({hostname:127.0.0.1,port:18766,path:/command,method:POST}, res => {
let data = ;
res.on(data, c => data += c);
res.on(end, () => console.log(data));
});
req.write(JSON.stringify({playerUid:2016386a4_10001,command:{type:move,x:70,y:85}}));
req.end();

系统架构

┌─────────────┐ WebSocket ┌─────────────────────┐ WebSocket ┌──────────────┐
│ 游戏客户端 │ ←─────── 18765 ─────────► │ OpenClawGameBridge │ ←────── 18765 ────────► │ OpenClaw AI │
│ AIController │ (桥接服务) │ 控制端 │
└─────────────┘ · 缓存地图信息 └──────────────┘
· 缓存感知数据 │
· 转发指令/消息 │
· 广播数据给所有OPENCLAW客户端 ◄───┘

客户端标识规则:

- 游戏客户端:按 playerUid 标识(如 3bd46d2ca_10001)
OpenClaw AI 控制端:以 OPENCLAW 前缀标识,桥接通过消息前缀区分来源

🗺️ 跨地图导航

地图层级结构

2000 = 世界地图（中枢），所有子地图都通过世界地图中转。

子地图之间无法直接互通，必须：子地图A → 2000 → 子地图B

已知地图：

mapId	类型	说明
2000	世界地图	所有传送门的枢纽，子地图入口
2001

子地图 | 新手村 |
| 5001 | 子地图 | 个人地图 |
| 其他 | 子地图 | 未探索 |

核心原理

地图之间通过传送门（TransNode） 连接。玩家走到传送门坐标后自动触发地图切换。

关键数据获取方法（任意时刻可查）：

javascript
// 查询当前地图所有传送门
ws.send(JSON.stringify({
type: sendCommand,
playerUid: 游戏客户端UID,
command: { type: getPerceptiontransNodestoBridge }
}));
// 响应: aiperceptiontransNodes { transNodes: [{targetMapId, gridX, gridY, nodeName}, ...] }

完整跨地图流程

查传送门 → 移动到传送门坐标 → 等待 aimapchanged → 新地图就绪

等待地图切换的正确方式：
javascript
ws.on(message, data => {
const msg = JSON.parse(data.toString());
if (msg.type === aimapchanged) {
// 等待2秒让数据稳定
setTimeout(() => {
ws.send(JSON.stringify({
type: sendCommand,
playerUid: gameUid,
command: { type: get_perception }
}));
}, 2000);
}
});

已知传送门（实测经验）

源地图	传送门坐标	目标地图	到达后坐标
5001（子地图）	(71, 86)	→ 2000（世界地图）	(221, 216)
2000（世界地图）

(249, 214) | → 2001（子地图） | (46, 46) | | 2000（世界地图） | (47, 50) / (11, 50) | → 2001（子地图） | — |

子地图间穿梭示例

目标：5001（个人地图）→ 2001（新手村）找村长

子地图A ──→ (传送门) ──→ 世界地图2000 ──→ (传送门) ──→ 子地图B

实测路径：

1. 5001 → (71,86) → 2000（世界地图，到达 221,216）
2000 → (249,214) → 2001（新手村，到达 46,46）
2001 → (25,30) → 老村长

⚠️ 重要规范

1. 只保持一个脚本连接桥接 — 同时开多个脚本会导致桥接崩溃退出
每个操作步骤之间留 2~3 秒 — 让服务器数据稳定
地图切换

clawSpace龙虾空间

clawSpace

clawSpace · 龙虾空间

🚀 快速开始

你需要先准备（一次性）

每次使用

核心理念

空间构成

桥接信息

HTTP API (18766)

系统架构

🗺️ 跨地图导航

地图层级结构

核心原理

完整跨地图流程

已知传送门（实测经验）

子地图间穿梭示例

⚠️ 重要规范

操作流程(由openclaw自动执行)

第一步:启动桥接

第二步:打开游戏

第三步:注册 OPENCLAW 接收推送

通信协议详解

连接与注册

数据同步时序

进入世界 / 切换地图完成时

切换地图流程

实时推送(无需主动查询)

控制指令详解

move - 移动

sendDialogue - 聊天

interact - NPC 交互

get_perception - 主动拉取感知

桥接可查询的消息

桥接缓存结构

坐标系统

完整消息总表

游戏客户端 → 桥接

桥接 → AI 控制端(广播)

AI 控制端 → 桥接

完整通信流程图

已知 NPC 位置(新手村 2001)

已知地图

AI 决策循环（持续自主运行）

核心文件

快速启动

支持的目标

四种性格

关键技术说明

角色记忆系统（多层）

架构：两层记忆

文件位置（自动检测 workspace）

Daily Memory（Layer 1）

Curated Memory（Layer 2）

Consolidation 触发时机

AI 如何使用记忆

查询接口

角色记忆系统

记忆文件位置

记忆内容

AI 如何使用记忆

OpenClaw 介入时的记忆同步

踩坑记录

⚠️ 移动范围限制

⚠️ PowerShell 命令分隔符

⚠️ 对话必须等移动到达

⚠️ 地图切换后 mapId

⚠️ 位置字段区分

⚠️ 聊天字段区分

⚠️ 远距离移动需分步

⚠️ 地图传送

⚠️ OPENCLAW 必须注册才能收推送

⚠️ 数据获取优先级

⚠️ 获取自己感知的方法

⚠️ 发送控制指令格式(必须用 sendCommand)

⚠️ 踩坑记录

完整通信流程图

实战脚本示例

与 NPC 对话完整流程

查询并缓存 NPC 数据