# openclawcontrol

**Repository Path**: bigplan/openclawcontrol

## Basic Information

- **Project Name**: openclawcontrol
- **Description**: openclawcontrol 常方哲维护
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw Control

OpenClaw 本地控制端 — 通过 SSH 隧道为 HK 服务器提供本地服务。

## 架构

```
┌─────────────────────────────────────────────────────────┐
│  HK 服务器 (43.161.216.215)                             │
│                                                         │
│  OpenClaw Gateway (:18789) ──→ 飞书/钉钉/企微/QQ/微信   │
│       │                                                 │
│       ├─ 🧠 main (调度中枢)  [Qwen3.5 Plus]            │
│       │   轻脑重调度：理解→路由→验收→回复               │
│       │       │                                         │
│       │       ├─ 💻 coder    [GLM-5]     代码开发       │
│       │       ├─ 📝 writer   [Qwen3.5+]  文档写作       │
│       │       ├─ 🔬 researcher [Kimi2.5] 调研策划       │
│       │       └─ 📊 analyst  [DS V3.2]   数据分析       │
│       │                                                 │
│       所有LLM → SSH隧道 → 本地代理 → 百炼API           │
│       :7891 ──→ :7893 (代理)  :7895 ──→ RAG            │
└──────────────────────┬──────────────────────────────────┘
                       │ SSH Tunnel
┌──────────────────────┴──────────────────────────────────┐
│  本地 Windows                                           │
│                                                         │
│  direct-proxy.js (:7893)  HTTP CONNECT 代理             │
│  rag-service (:7895)      知识库检索 (ChromaDB)         │
└─────────────────────────────────────────────────────────┘
```

## 可用模型（全部走百炼API + SSH隧道）

| Provider | 模型 |
|----------|------|
| `qwencode` | Qwen3.5 Plus, Qwen3 Max, Qwen3 Coder Plus, Kimi K2.5, GLM-5, GLM-4.7 |
| `qwen` | Qwen3.5 Plus, Qwen Max/Plus/Turbo, Qwen3 Coder Plus, Kimi K2.5, GLM-5, GLM-4.7, DeepSeek V3.2 |

> 所有大模型流量均通过 SSH 隧道 → 本地代理 → 各API，实现国内网络加速。

## 文件说明

| 文件 | 说明 |
|------|------|
| `start-all.bat` | 一键启动所有服务（含状态验证） |
| `stop-all.bat` | 一键停止所有服务 |
| `status.bat` | 检查所有服务运行状态 |
| `start-proxy-hidden.vbs` | 启动代理服务（隐藏窗口） |
| `start-rag-hidden.vbs` | 启动 RAG 服务（隐藏窗口） |
| `start-tunnel-hidden.vbs` | 启动 SSH 隧道（指数退避自动重连） |
| `direct-proxy.js` | HTTP CONNECT 代理（超时/限流/健康检查） |
| `rag-service/` | RAG 知识库服务 |
| `knowledge-base/` | 知识库文档目录 |
| `memory-log.md` | 操作记录（所有变更历史） |

## 快速使用

### 启动所有服务

```powershell
& 'D:\01App\02 hot_project\01openclawcontrol\start-all.bat'
```

### 检查服务状态

```powershell
& 'D:\01App\02 hot_project\01openclawcontrol\status.bat'
```

### 停止所有服务

```powershell
& 'D:\01App\02 hot_project\01openclawcontrol\stop-all.bat'
```

## API 端点

| 端点 | 方法 | 说明 |
|------|------|------|
| `/health` | GET | 服务健康检查 |
| `/query` | POST | 知识库查询 |
| `/ingest` | POST | 手动触发知识库摄入 |
| `/rebuild` | POST | 清空并完全重建知识库 |
| `/stats` | GET | 知识库统计信息 |
| `/documents` | GET | 列出所有已摄入文档 |
| `/document/{name}` | DELETE | 删除指定文档 |
| `/watcher/status` | GET | 文件监控状态 |

## 故障排查

### SSH 隧道断开
- 查看日志: `logs/tunnel.log`
- 隧道会自动以指数退避（5s→60s）重连
- 检查服务器 `43.161.216.215:22` 是否可达

### RAG 服务异常
- 查看日志: `rag-service/logs/rag-service.log`
- 检查端口: `netstat -an | find ":7895"`
- 健康检查: `curl http://127.0.0.1:7895/health`

### 代理服务异常
- 检查端口: `netstat -an | find ":7893"`
- 健康检查: `curl http://127.0.0.1:7893/health`