文档中心

硬件适配 · 安装教程 · Token计费 · API对接 · FAQ

1. 硬件适配指南

一莲AI 采用「端应用 + 本机算力网关 + 云端/本地算力」三层架构:端应用负责交互与业务,本机算力网关(自动部署,监听 127.0.0.1:8000)负责调度与硬件识别,算力由本地 Ollama 或一莲云网关提供。安装时会自动识别硬件并推荐适配模型档位,硬件要求视部署模式而定。

云端托管模式

算力运行于一莲云网关,本地无需任何硬件,通过浏览器访问即可使用全部云端能力。推荐使用 Chrome / Edge 最新版。

本地私有化模式

端应用与本机算力网关在 Windows 本地运行,本地推理能力由 GPU 显存决定可运行的模型档位:

  • 无独立显卡(核显):CPU 推理,适配轻量模型(如 qwen2.5:3b)
  • 显存 5.8GB 以下:适配 qwen2.5:3b 级模型
  • 显存 5.8GB 及以上:可运行默认完整模型 qwen2.5-coder:7b(约 4.7GB,仅首次下载)

本地私有化基础要求

  • 系统:Windows 10 x64(20H2及以上,推荐22H2)、Windows 11 x64
  • 内存:8GB 起步,推荐 16GB
  • 磁盘:可用空间 10GB 以上(含本地模型与部署组件缓存)
  • 网络:首次部署需联网下载组件与模型,运行期可离线推理

兼容性说明

  • 不支持:Win7 / Win8.1 / Windows 11 S模式
  • ARM64 Windows 可运行但存在性能下降风险
  • 本地推理数据不出本机;硬件信息仅存单向SHA256摘要,不采集私人文档

2. 客户端安装教程

获取安装包

仅授权付费用户可下载 Windows 本地部署客户端。登录后前往首页「下载专区」获取。

安装步骤

  1. 下载安装包后,右键 → 属性 → 勾选「解除锁定」
  2. 运行安装程序,阅读并勾选同意《最终用户许可协议》
  3. 安装器自动完成环境检查与授权存证,安装到用户目录
  4. 首次启动:游客身份可直接部署体验,或登录账号获取完整能力
  5. 自动下载部署组件(Git / Node.js / Ollama 本地模型)并完成 OpenClaw 部署

游客模式说明

  • 游客可体验本地部署与基础 AI 能力,登录授权后解锁完整模型与更高 Token 配额
  • 付款升级后自动转为付费授权账户,解锁全部模型能力与更高 Token 配额

本地模型(Ollama)

  • 部署时自动安装 Ollama 引擎并下载 qwen2.5-coder:7b 本地模型(约 4.7GB,仅首次)
  • 本地模型离线推理,数据不出本机,Token 不消耗云端额度

安装位置

程序固定安装至 %localappdata%\YilianAIDeploy,无需管理员权限。

3. Token计费规则说明

统一Token体系

云端SaaS与本地私有化共用同一套Token额度体系。本地智能体所有运算请求,实时回传云端中台计量扣费。

计费模式

  • 端应用开通:199 元一次性开通端应用下载与使用权限,首次开通赠送1000万Token算力额度(有效期365天)
  • 算力预充值:1 元 = 10 万基础 Token,按需充值、付费额度永久有效

超额拦截

Token额度耗尽后,系统自动拦截AI服务并提示充值升级,杜绝超支。

用量查询

后台「Token监控」可实时查看全站用量统计与个人用量明细。

4. API对接文档

统一入口

所有接口基于 HTTPS 加密传输,统一前缀 /api/v1。

用户注册

POST /api/v1/auth/register
{
  "account": "user@example.com",
  "password": "******",
  "display_name": "企业名称"
}

用户登录

POST /api/v1/auth/login
{
  "account": "user@example.com",
  "password": "******"
}
// 返回 JWT token,后续请求携带 Authorization: Bearer <token>

EULA存证

POST /api/v1/eula/evidence
// 设备锚定HMAC签名,返回 evidence_id
POST /api/v1/eula/verify    // 启动时存证校验

接口安全

  • 全部鉴权接口强制 HTTPS TLS1.2+
  • 计费、授权操作日志永久留存
  • 错误统一业务错误码,前端友好提示
  • 密钥全部服务端加密托管,前端无明文

5. 常见问题FAQ

Q: 一莲AI 是 OpenClaw 官方软件吗?

A: 不是。一莲AI是第三方独立部署辅助工具,OpenClaw为MIT开源软件,付费购买的是部署辅助、网关中转、账号管理服务。

Q: 数据会泄露吗?

A: 云端模式数据托管于安全云服务器;本地私有化模式数据全部本地留存,可离线运行。硬件信息仅存单向SHA256摘要,不采集私人文档。

Q: Token 用完了怎么办?

A: AI服务自动拦截并提示,前往定价页充值升级即可,实时到账。

Q: 本地部署需要什么配置?

A: 8G内存起步(推荐16G),安装时自动识别GPU显存并适配模型档位,Windows 10 20H2+ 或 Windows 11 x64。

Q: 隐私协议与服务条款在哪?

A: 详见官网《最终用户许可协议(EULA)》——软件许可、数据与隐私、使用限制、免责与责任限制等全部条款均以官网权威版本为准,安装程序内展示文本与之一致。

Q: 199包含算力吗?

A: 不含。199 元为一次性开通端应用下载与使用权限的软件费,AI 算力需要预充值 Token。

Q: 赠送规则?

A: 全平台唯一的赠送是端应用安装赠送:首次激活端应用即赠送 1000 万 Token 算力额度,有效期 365 天,到期清零不补偿。除此之外没有任何赠送——注册无赠送、充值无赠送、首充无赠送、活动无赠送;充值所得 Token 永久有效。