karuo-ai/开发文档/10、使用手册/OpenClaw控制台/01-系统概述.md

01 系统概述

OpenClaw 控制台使用手册 > 系统概述

---

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 快速入门

返回 章节目录