# Ruoyi-Cloud-Claw

**Repository Path**: yonja/ruoyi-cloud-claw

## Basic Information

- **Project Name**: Ruoyi-Cloud-Claw
- **Description**: 将lingclaw作为一个微服务嵌入到了Ruoyi-Cloud-Plus
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# LingClaw 微服务整合指南 (RuoYi-Cloud-Plus)

本文档详细说明了如何将 **LingClaw** 业务模块作为独立微服务整合到 **RuoYi-Cloud-Plus** 分布式系统中。通过本指南，您将完成从项目结构创建、依赖配置、Nacos注册到服务间调用的全过程。

## 1. 前置准备

在开始之前，请确保您的开发环境已满足以下条件：
- **JDK**: 1.8 或 11 (推荐 JDK 11)
- **Maven**: 3.6+
- **RuoYi-Cloud-Plus**: 已克隆并能在本地正常启动基础服务 (Gateway, Auth, System等)
- **Nacos**: 服务注册与配置中心已启动
- **LingClaw**: 假设 LingClaw 是一个基于 Spring Boot 的业务服务，具备标准的 RESTful API 或 Dubbo 接口

## 2. 项目结构规划

克隆Ruoyi-Cloud-Claw到本地，合并到Ruoyi-Cloud-PLus。

相关内容的标准目录结构如下：

RuoYi-Cloud-Plus/
├── ruoyi-ai/                   # AI 定义模块
│   └── ruoyi-law/              # Claw 定义模块
│       ├── ruoyi-ai-core       # 核心定义模块
│       ├── ruoyi-ai-knowledge  # 核心定义模块
│       ├── ruoyi-ai-media      # 媒介定义模块
│       ├── ruoyi-ai-setting    # 设定定义模块
│       ├── ruoyi-ai-training   # 训练定义模块
│       ├── ruoyi-ai-wechat     # 微信模块
│       └── ruoyi-ai-workflow   # 工作流定义模块
└── ruoyi-modules/              # 业务模块
    └── ruoyi-claw-admin/       # LingClaw 服务实现
        

## 3. 整合步骤

### 3.1 配置Nacos

在Nacos增加配置 `ruoyi-claw-admin.yml`，内容为 `./script/config/nacos/ruoyi-claw-admin.yml`

### 3.2 创建数据库

在mysql数据库上创建数据库 easyai, 建库脚本及数据在 `./script/sql/` 下。

修改 nacos 的 `datasource.yml`, 增加关于 easyai 相关信息。

### 3.3 配置网关

为了让外部能够访问 LingClaw 服务，需要在 `ruoyi-gateway` 的配置中添加路由规则。

```yaml
spring:
  cloud:
    gateway:
      routes:
        - id: ruoyi-lingclaw
          uri: lb://ruoyi-lingclaw # 负载均衡指向服务名
          predicates:
            - Path=/lingclaw/**
          filters:
            - StripPrefix=1 # 去掉前缀 /lingclaw，根据实际路径需求调整
```



## 4. 启动与验证

1. **启动基础服务**: 确保 Nacos, Redis, MySQL, Ruoyi-Gateway, Ruoyi-Auth 已启动。
2. **启动 LingClaw**: 运行 `RuoYiLingClawApplication`。
3. **检查 Nacos**: 登录 Nacos 控制台，查看服务列表中是否出现 `ruoyi-lingclaw` 且状态健康。
4. **接口测试**:
   - 访问网关地址: `http://localhost:8080/lingclaw/your-api-endpoint`
   - 或直接访问服务: `http://localhost:9205/your-api-endpoint`

## 5. 常见问题 (FAQ)

- **Q: 服务启动后 Nacos 中看不到实例？**
  - A: 检查 `bootstrap.yml` 中的 `spring.cloud.nacos.discovery.server-addr` 是否正确，以及网络是否通畅。检查日志是否有连接拒绝错误。

- **Q: 网关访问返回 404？**
  - A: 检查网关路由配置中的 `predicates` 路径是否与请求 URL 匹配，以及 `filters` 是否正确处理了路径前缀。

- **Q: 如何开启 Sentinel 流量控制？**
  - A: 确保引入了 `spring-cloud-starter-alibaba-sentinel` 依赖，并在 Nacos 配置中启用 Sentinel 相关配置。