核心用法
OpenClaw CLI Bridge 是一款集成型网关插件，通过四层架构将分散的AI工具统一接入OpenClaw生态：
Phase 1 - Codex认证桥接：自动读取~/.codex/auth.json本地令牌，无需重复登录即可注册OpenAI Codex提供商。
Phase 2 - 请求代理层：在本地127.0.0.1:31337启动OpenAI兼容HTTP代理，将vllm格式调用路由至各CLI子进程：
- Gemini系列（2.5 Pro/Flash、3 Pro）
- Claude系列（Sonnet/Opus/Haiku 4.x版本）
- 本地BitNet 2B模型
输入通过stdin/tmpfile传递，规避E2BIG参数过长错误。
Phase 3 - 快捷指令：10+条/cli-*斜杠命令实现秒级模型切换，支持分阶段确认（需/cli-apply生效）和回退机制。
Phase 4 - 浏览器提供商：为4大Web平台维护持久Chromium会话，无需API密钥：
- Grok、Gemini网页版、Claude.ai、ChatGPT
- 配备独立登录/状态/登出指令
- 网关重启后会话自动恢复，过期时触发WhatsApp告警
配套功能：浏览器健康仪表板（31337/status）、自动Cookie监控、30秒刷新状态页。
显著优点
| 维度 | 亮点 |
|------|------|
| 整合度 | 统一CLI+Web双通道，消除多工具切换摩擦 |
| 便捷性 | 聊天频道内直接切模型，无需离开对话上下文 |
| 成本 | Web通道零API费用，适合高频轻量使用 |
| 可靠性 | 持久化会话+自动过期告警，运维友好 |
| 安全性 | 令牌本地存储，长提示不暴露于进程列表 |
潜在局限
- 架构复杂度：四层代理增加故障排查难度，需理解vllm/OpenAI格式转换
- 浏览器依赖：Web通道受平台反爬虫策略影响，存在被封禁风险
- 本地前提：要求预装
claude、gemini等CLI工具，非开箱即用 - 授权限制：斜杠命令需配置"authorized senders"，多用户场景管理成本高
- 端口占用：硬编码31337端口可能与现有服务冲突
适合人群
- 已本地部署多模型CLI的进阶AI用户
- 希望统一管控API与Web会话的OpenClaw重度用户
- 需要团队共享模型访问权限的小型技术组织
- 追求"聊天即控制台"工作流效率极客
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证安全 | `auth.json`明文存储，需确保文件权限600 |
| 会话劫持 | 持久浏览器Cookie若泄露可导致账户被盗用 |
| 隐私合规 | Web自动化可能违反平台ToS（尤其商业场景） |
| 网络暴露 | 代理服务仅限本地回环，误配防火墙可能暴露 |
| 版本漂移 | CLI工具升级可能破坏vllm路径映射 |
建议：生产环境启用独立的浏览器配置文件隔离，定期轮换Web会话，监控31337/status异常流量。