入门指南
架构概览
NiceClaw 与 OpenClaw 的关系，以及内部模块结构。
架构概览
NiceClaw 与 OpenClaw
┌─────────────────────────────────────────────┐
│ NiceClaw（桌面层） │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ GUI 界面 │ │ 技能商店 │ │ 工作流编排│ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────┐ │
│ │ OpenClaw Agent Runtime │ │
│ │ 工具调用 · 模型抽象 · 上下文管理 │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
↓
┌──────────────────────────┐
│ AI 模型提供商 │
│ OpenAI / Claude / Ollama │
└──────────────────────────┘OpenClaw 是底层引擎，负责：
- Agent 生命周期管理
- 工具（Tool）调用调度
- 多模型统一 API 抽象
- 上下文窗口管理
- Skill 机制与能力组织
NiceClaw 是桌面增强层，负责：
- 跨平台原生 GUI（Electron）
- Nice 账号登录与开箱即用体验
- 技能商店与 Skill 安装管理
- 可视化工作流编排
- 本地数据持久化（SQLite）
- 用户配置与主题管理
核心模块
Agent Runtime
由 OpenClaw 提供，支持：
- ReAct 模式：思考 → 工具调用 → 观察 → 重复
- Plan & Execute：先规划任务步骤，再逐步执行
- 单次调用：直接问答，无工具调用
模型抽象层
NiceClaw 通过统一接口对接模型，并提供两种使用方式：
NiceClaw Model Adapter
├── Nice 账号默认模型
├── 自定义 OpenAI Compatible
├── 自定义其他第三方模型
└── Ollama / 本地模型Skill 能力层
NiceClaw 面向用户提供的是 Skill。在 OpenClaw 的术语里，Skill 用来组织能力、提示和工具使用方式，方便按场景安装与复用。
Skill 包
├── SKILL.md — 告诉 Agent 何时、如何使用能力
├── tools/ — 可调用工具
└── assets/ — 提示与附加资源数据层
所有数据存储在本地 SQLite 数据库，包括：
| 表 | 内容 |
|---|---|
conversations | 对话历史 |
messages | 消息记录 |
skills | 已安装 Skill |
settings | 用户配置 |
workflows | 工作流定义 |
消息流转
用户输入
↓
NiceClaw GUI
↓
OpenClaw Agent Runtime
↓ (需要工具时)
Skill / 工具调用
↓
模型 API
↓
流式输出 → GUI 渲染