# 绿码 AI · Windows 客户端使用说明

> lvmaai.com · 智能体控制台 v1.0

## 🚀 快速开始（推荐）

### 一步启动：双击 `start.bat`

`start.bat` 会自动：
1. 检查 Node.js
2. 检查 / 安装 OpenClaw Gateway
3. 配置 `~/.openclaw/openclaw.json` 启用 `/v1/chat/completions` 端点
4. 后台启动 OpenClaw Gateway（端口 18789）
5. 启动 `绿码 AI.exe`

## 🔐 登录

- 任意手机号 + 用户名 + 邀请码都能进
- 推荐邀请码：`lvmaai` / `OpenClaw` / `DEMO888`

## ⚙️ 手动控制

如果 `start.bat` 不工作，可以手动：

```cmd
:: 1. 安装 OpenClaw
npm install -g openclaw

:: 2. 启动 Gateway
openclaw gateway --port 18789

:: 3. 双击 绿码 AI.exe
```

## 🔧 进阶：用 Node 脚本

```cmd
node setup-gateway.js install    :: 安装并配置
node setup-gateway.js start      :: 启动 Gateway
node setup-gateway.js status     :: 查看状态
```

## 🆘 故障排查

| 现象 | 原因 | 解决 |
|---|---|---|
| "未检测到 Node.js" | 没装 Node | https://nodejs.org/ 下载 18+ |
| "OpenClaw 安装失败" | 网络问题 / npm 配置 | 手动 `npm install -g openclaw` |
| "Gateway 启动失败" | 18789 端口被占 | `netstat -ano \| findstr :18789` 找占用进程 |
| 对话显示"调用失败" | Gateway 未运行 | 重跑 `start.bat` |
| Windows Defender 警告 | 未知应用 | 点「更多信息」→「仍要运行」 |

## 📦 目录结构

```
绿码 AI/
├── 绿码 AI.exe          ← 主程序
├── start.bat            ← 一键启动器
├── setup-gateway.js     ← Node 配置脚本
├── README-Windows.md    ← 本文件
├── resources/
│   └── app.asar         ← 应用代码
└── *.dll + locales/
```

## 🔗 链接

- 官网：https://lvmaai.com
- GitHub：https://github.com/lvmaai
- 下载页：https://download.yave520.com/?f=/绿码AI
