openclawapi 1.3.13 → 1.3.14

package/README.md

@@ -316,6 +316,82 @@ openclaw doctor
 openclaw gateway
 ```
 
+## 访问 Web Dashboard
+
+### 本地安装后访问
+
+```bash
+# 方式1: 自动打开浏览器（推荐）
+clawdbot dashboard
+
+# 方式2: 仅显示 URL，手动复制到浏览器
+clawdbot dashboard --no-open
+```
+
+访问地址格式：
+```
+http://127.0.0.1:18789/?token=<你的token>
+```
+
+> ⚠️ **必须带 `?token=` 参数访问**，否则页面会报错。
+
+### VPS 远程部署后访问（SSH 隧道）
+
+如果 OpenClaw 部署在 VPS 上，需要通过 SSH 隧道访问：
+
+**步骤 1: 建立 SSH 隧道（保持终端运行）**
+```bash
+ssh -N -L 18789:127.0.0.1:18789 -i <密钥路径> ubuntu@<服务器IP>
+```
+
+**步骤 2: 浏览器访问**
+```
+http://127.0.0.1:18789/?token=<token>
+```
+
+**配置 SSH 快捷方式（推荐）**
+
+在 `~/.ssh/config` 添加：
+```
+Host openclaw
+    HostName <服务器IP>
+    User ubuntu
+    IdentityFile ~/.ssh/openclaw-key
+    LocalForward 18789 localhost:18789
+```
+
+然后只需运行 `ssh openclaw -N` 即可建立隧道。
+
+### 其他访问方式
+
+| 方式 | 命令/地址 | 适用场景 |
+|------|----------|---------|
+| TUI 终端界面 | `clawdbot tui` | 无图形界面环境 |
+| 启动网关 | `clawdbot gateway` | 手动启动服务 |
+| 查看状态 | `clawdbot status` | 检查服务状态 |
+| 查看日志 | `clawdbot logs` | 排查问题 |
+
+### Dashboard 访问注意事项
+
+| 事项 | 说明 |
+|------|------|
+| 必须带 Token | ❌ 不带 token 访问会报错 ✅ 正确: `http://127.0.0.1:18789/?token=xxx` |
+| 获取 Token | 在服务器运行 `clawdbot dashboard --no-open` |
+| 保持终端运行 | SSH 隧道断开则无法访问 |
+| 安全设计 | Gateway 默认绑定 127.0.0.1，不直接暴露公网 |
+
+## Gateway API 端点
+
+OpenClaw Gateway 支持以下 HTTP 端点（需在配置中启用）：
+
+| 端点 | 配置项 | 默认状态 |
+|------|--------|---------|
+| `/v1/chat/completions` | `gateway.http.endpoints.chatCompletions.enabled` | 关闭 |
+| `/v1/responses` | `gateway.http.endpoints.responses.enabled` | 关闭 |
+| `/tools/invoke` | - | 内部使用 |
+
+> 注意：本工具的测试功能直接调用中转 API，不依赖 Gateway HTTP 端点。
+
 ## 故障排除
 
 ### 问题 1: 找不到配置文件
@@ -412,6 +488,17 @@ MIT
 
 ## 更新日志
 
+### v1.3.14 (2026-02-03)
+
+- ✅ 测试连接改为通过 Gateway API 端点测试（与 Web Dashboard 使用相同端点）
+- ✅ 测试成功即表示 Web Dashboard 可正常对话
+
+### v1.3.13 (2026-02-03)
+
+- ✅ 测试连接改为：先重启 Gateway，再测试中转 API
+- ✅ 修复 Gateway 重启命令兼容性（支持 openclaw/clawdbot/npx）
+- ✅ 测试问题改为"你是什么模型？"获取更详细回复
+
 ### v1.0.0 (2026-02-01)
 
 - ✅ 初始版本发布

package/cli.js

@@ -423,32 +423,38 @@ async function testConnection(paths) {
   console.log(chalk.gray(`模型: ${primary}`));
   console.log(chalk.gray(`Gateway: http://localhost:${gatewayPort}\n`));
 
+  // 获取 Gateway token
+  const gatewayToken = config.gateway?.auth?.token;
+  if (!gatewayToken) {
+    console.log(chalk.yellow('⚠️ Gateway token 未配置'));
+    return;
+  }
+
   // 步骤1: 先重启 Gateway 使配置生效
   console.log(chalk.cyan('步骤 1/2: 重启 Gateway 使配置生效...'));
   await restartGateway();
 
-  // 步骤2: 直接测试中转 API 验证配置
-  console.log(chalk.cyan(`\n步骤 2/2: 测试 ${typeLabel} 中转 API...`));
+  // 等待 Gateway 启动
+  console.log(chalk.gray('   等待 Gateway 启动...'));
+  await new Promise(resolve => setTimeout(resolve, 2000));
+
+  // 步骤2: 通过 Gateway 端点测试（与 Web Dashboard 使用相同端点）
+  console.log(chalk.cyan(`\n步骤 2/2: 测试 Gateway API 端点 (与 Web Dashboard 相同)...`));
+  console.log(chalk.gray(`   端点: http://localhost:${gatewayPort}/v1/chat/completions`));
 
   try {
     const startTime = Date.now();
-    let result;
-
-    if (type === 'claude') {
-      result = await testClaudeApi(provider.baseUrl, provider.apiKey, provider.models?.[0]?.id);
-    } else {
-      result = await testCodexApi(provider.baseUrl, provider.apiKey, provider.models?.[0]?.id);
-    }
-
+    const result = await testGatewayApi(gatewayPort, gatewayToken, primary);
     const latency = Date.now() - startTime;
 
     if (result.success) {
-      console.log(chalk.green(`\n✅ 测试成功！配置已生效`));
+      console.log(chalk.green(`\n✅ Gateway 测试成功！Web Dashboard 可正常使用`));
       console.log(chalk.cyan(`   响应时间: ${latency}ms`));
       console.log(chalk.yellow(`   模型回复: ${result.message}`));
     } else {
-      console.log(chalk.red(`\n❌ ${typeLabel} API 连接失败`));
+      console.log(chalk.red(`\n❌ Gateway API 连接失败`));
       console.log(chalk.red(`   错误: ${result.error}`));
+      console.log(chalk.gray(`\n   提示: 如果 Gateway 未运行，请执行: openclaw gateway`));
     }
   } catch (error) {
     console.log(chalk.red(`❌ 测试失败: ${error.message}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclawapi",
-  "version": "1.3.13",
+  "version": "1.3.14",
   "description": "跨平台 OpenClaw/Clawdbot 配置管理工具 - 管理中转地址、模型切换、API Keys、测速优化",
   "main": "cli.js",
   "bin": {