## 02 快速入门

> [OpenClaw 控制台使用手册](README.md) > 快速入门

---

## 2.1 前置条件检查

在使用前，请确保：

| 项目 | 要求 | 检查方法 |
|------|------|----------|
| 操作系统 | macOS（当前本机环境） | 无需额外操作 |
| clawdbot 仓库 | 已存在 | 路径为 `开发/8、小工具/clawdbot` |
| 网关 | 已经在 18789 端口运行（推荐） | 访问 `http://127.0.0.1:18789/health` 应返回 200 |
| Ollama | 已安装并运行 | 终端执行 `curl -s http://localhost:11434/api/tags` 能返回模型列表 |

---

## 2.2 启动网关与控制面板

有两种常见方式：

### 方式一：使用已有网关（推荐）

1. 确认网关已启动（Docker 或其他方式）。
2. 在终端或 Spotlight 中打开控制面板：

   ```bash
   open http://127.0.0.1:18789/config
   ```

3. 浏览器中应出现 OpenClaw 控制台首页。

### 方式二：使用 openclaw 命令启动网关

当 18789 端口没有服务时，可以手动启动：

```bash
openclaw gateway start
# 或指定端口（如需）：
openclaw gateway --port 18789
```

然后浏览器访问：

```text
http://127.0.0.1:18789/config
```

---

## 2.3 验证 AI 模型是否可用

1. 在浏览器中打开控制面板。
2. 新建一个会话，发送一条简单消息，例如：
   - “你现在使用的是哪个模型？”
3. 若返回正常回答且使用量统计中可以看到 `provider: ollama`、`model: ollama/qwen2.5:3b`，说明当前本地模型工作正常。

如对模型有疑问，可在后续章节中查看「模型与 Provider 配置」。

---

## 2.4 常用地址速查

| 功能 | 地址 |
|------|------|
| 控制面板 | `http://127.0.0.1:18789/config` |
| 健康检查 | `http://127.0.0.1:18789/health` |
| 飞书桥接状态（若启用） | `http://127.0.0.1:8888/` |

---

上一篇：[01 系统概述](01-系统概述.md) | 下一篇：[03 界面与基础操作](03-界面与基础操作.md)

返回 [章节目录](README.md)