用途与实际影响
这项功能怎样使用
为什么需要它
过去的直接接法在实际协议握手上不兼容。网关端口在线只说明有程序在听，不能证明 CodeG 已经能调用工具。
举个实际例子
我可以说：“保留 CodeG 里已有的 MCP Server（模型上下文协议服务），只增加 OpenClaw 桥接，不要把密码写进配置。”刷新后必须真实连通、列出工具并完成一次只读调用；连接失败就不能说接入完成。
最后我会得到什么
先得到保留其他工具连接的安全配置；只有 CodeG 真正列出并调用工具后，才算桥接完成。目前只验证了前一层。
正常时
CodeG 刷新后确实列出 OpenClaw 工具，并完成一次本人选定的只读调用。
发现问题时
目前只有桥接配置和隔离验证，真实客户端工具调用还没有验收。
入口不可用或证据不足时
启动器、配置或身份握手缺失时停止，不把密码明文写进配置凑可用。
从哪里开始
在已安装 CodeG/Cline 的电脑上运行 tools/setup-codeg-bridge.ps1，随后在 CodeG 的 MCP 页面刷新并启用 openclaw-bridge。
需要准备什么
- 是否要在 CodeG/Cline 使用 OpenClaw 工具
- 一个不含私人内容的只读试用问题
从开始到拿到结果
- 1
保留原有工具连接
安装入口只加入 OpenClaw 这一项，写入不含明文密码的桥接配置。
- 2
在 CodeG 里实际启用
刷新客户端，确认能看到 OpenClaw 提供的工具列表。
- 3
试一次只读工具
调用成功才算真正接通；文件已写好或网关端口在线都不能代替。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
受控桥接配置已存在，隔离插入/更新测试通过；真实 MCP（模型上下文协议）初始化、工具列表与工具调用未验关键规则与设计选择
当前公开路线是 Cline stdio MCP（标准输入输出模型上下文协议），不把 OpenClaw ACP 直连写成可用。
配置只保存 loopback（本机回环）Gateway URL（网关地址）；密码由受控启动器注入目标子进程。
脚本列出的候选工具名只是说明，实际数量和名称以 tools/list 为准。
消息发送能力若出现仍需单独授权，不能由一次只读工具验收扩权。
本模块用到的名词
- stdio MCP（标准输入输出模型上下文协议）
- Cline 以子进程方式启动 bridge，通过标准流交换协议消息。
- upsert（插入或更新）
- 有同名项就更新，没有就新增，同时保留其他 Server。
- initialize / tools/list（初始化/工具列表）
- MCP 客户端与服务端真正握手并回读能力的基础步骤。
专业定义
这条路线让 CodeG 里的 Cline 使用 OpenClaw 工具，但不把网关密码复制进配置。
解决什么
避免破坏已有 Cline 配置、泄露 Gateway 密码，或把网络探活当成 MCP 工具真的可用。
当前怎样实现
- 脚本要求 PowerShell 7 与 PCConfig managed launcher（受控启动器）都存在，否则先失败。
- 解析现有 JSON 并保留未知根键和所有其他 mcpServers（模型上下文协议服务集合），只 upsert（插入或更新）openclaw-bridge。
- 首次修改保存稳定 recovery backup（恢复副本），使用 UTF-8（通用文本编码）且无 BOM（字节顺序标记）原子替换，写后按完整 JSON 回读；重复结果不改字节。
执行流程
- 1
确认受控启动器存在。
- 2
读取并验证 Cline MCP JSON。
- 3
保留其他键并 upsert bridge，原子写后回读。
- 4
在 CodeG MCP 页面刷新并启用给 Cline。
- 5
完成 initialize 与 tools/list。
- 6
先做不含私人内容的只读工具调用，再按实际用途判断后续。
边界
- 不把 Gateway 密码写进 JSON、参数或网页。
- 不替用户清空其他 MCP Server。
- 不把端口在线、配置存在或测试夹具当真实握手。
失败与恢复
- 受控启动器不存在
- 在读取后写入前失败，不降级到明文。
- 现有 JSON 畸形
- 备份与写入前停止，原文件字节不变。
- CodeG initialize/tools/list 失败
- 保留配置层成功与运行层失败的分离结论，继续查真实握手。
真实入口
tools/setup-codeg-bridge.ps1保留式 upsert、受控启动与原子写
docs/CODEG.mdCline MCP 路线与真实验收步骤
tools/test-codeg-bridge.ps1隔离 JSON、幂等与失败关闭测试
如何验证
- 现有 managed bridge 配置已确认；端口探活仅作轻量条件。
- test-codeg-bridge.ps1 的 27/27 隔离断言通过，覆盖保留其他 Server、幂等、坏 JSON、不带 BOM 与缺启动器。
- 没有运行真实 CodeG/Cline initialize、tools/list 或任何工具调用。
与其他模块的关系
它是 Gateway 的一个客户端入口；渠道模块服务 Telegram/飞书，二者共享模型与 Gateway，但验收互不替代。