75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
|
## 01 系统概述
|
|||
|
|
|
|||
|
|
> [OpenClaw 控制台使用手册](README.md) > 系统概述
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1.1 OpenClaw/Cloud Boot 在本机中的角色
|
|||
|
|
|
|||
|
|
OpenClaw 控制台可以理解为一层「本地 AI 网关 + 控制台」：
|
|||
|
|
|
|||
|
|
- 向上：对接飞书、Cloud Boot（卡若消息中枢）、浏览器等「前端入口」。
|
|||
|
|
- 中间：作为 **统一网关**，负责会话管理、通道路由、使用量统计。
|
|||
|
|
- 向下：调用本机 **Ollama** 或云端 API（如 v0，间接使用 Claude 等模型）。
|
|||
|
|
|
|||
|
|
在你当前的配置中：
|
|||
|
|
|
|||
|
|
- 主模型为 **`ollama/qwen2.5:3b`**（本机小模型），Provider 为 `ollama`。
|
|||
|
|
- 网关监听在本机 **18789 端口**。
|
|||
|
|
- 所有「通过 OpenClaw 的对话」最终都会落到本机 Ollama 或其他你配置的 Provider。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1.2 核心组件与数据流
|
|||
|
|
|
|||
|
|
整体数据流可以简化为三层：
|
|||
|
|
|
|||
|
|
1. **入口层（Client）**
|
|||
|
|
- 浏览器打开 `http://127.0.0.1:18789/config` 的控制面板进行对话。
|
|||
|
|
- 飞书/Cloud Boot 通过 `feishu_openclaw_bridge.py` 转发消息到网关。
|
|||
|
|
|
|||
|
|
2. **网关层（OpenClaw Gateway）**
|
|||
|
|
- 进程来源：Docker 容器或 `openclaw gateway start` 命令。
|
|||
|
|
- 端口：`18789`。
|
|||
|
|
- 职责：
|
|||
|
|
- 管理会话与对话历史；
|
|||
|
|
- 按配置选择 Provider（如 `ollama`、`v0`）和具体模型；
|
|||
|
|
- 记录使用情况（tokens、费用等，视 Provider 能力而定）。
|
|||
|
|
|
|||
|
|
3. **模型层（Providers）**
|
|||
|
|
- 本机 Provider：`ollama`（`http://localhost:11434`），模型如 `qwen2.5:3b`。
|
|||
|
|
- 备选 Provider：`v0` 等云端 API（如启用）。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1.3 配置文件与持久化位置
|
|||
|
|
|
|||
|
|
关键配置写在本机用户目录下：
|
|||
|
|
|
|||
|
|
| 项目 | 位置 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| OpenClaw 主配置 | `~/.openclaw/openclaw.json` | 包含网关端口、默认 Provider、默认模型等。 |
|
|||
|
|
| clawdbot 源码 | `开发/8、小工具/clawdbot` | 包含 UI 前端、飞书桥接脚本等。 |
|
|||
|
|
| 飞书桥接脚本 | `feishu_openclaw_bridge.py` | 将飞书消息转成 OpenClaw 可理解的请求。 |
|
|||
|
|
|
|||
|
|
网关重启不会丢失配置，因为主要设置保存在上述配置文件中。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1.4 与卡若AI/Cloud Boot 的关系
|
|||
|
|
|
|||
|
|
- 卡若AI 是「大脑与规则集合」；
|
|||
|
|
- OpenClaw 是「本地网关与路由器」；
|
|||
|
|
- Cloud Boot/飞书机器人是「对外入口」。
|
|||
|
|
|
|||
|
|
典型链路可以描述为：
|
|||
|
|
|
|||
|
|
> 飞书消息/Cloud Boot → `feishu_openclaw_bridge.py` → OpenClaw 网关（18789） → Provider（Ollama/qwen2.5:3b 或 v0）→ 返回结果 → 飞书/Cloud Boot 展示
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
上一篇：无 | 下一篇：[02 快速入门](02-快速入门.md)
|
|||
|
|
|
|||
|
|
返回 [章节目录](README.md)
|
|||
|
|
|