---
title: Web 控制台
description: 通过 Web 控制台使用 CowAgent
---

Web 控制台是 CowAgent 的默认通道，启动后会自动运行，通过浏览器即可与 Agent 对话，并支持在线管理模型、技能、记忆、通道等配置。

## 配置

```json
{
  "channel_type": "web",
  "web_host": "0.0.0.0",
  "web_port": 9899,
  "web_password": "",
  "enable_thinking": false
}
```

| 参数 | 说明 | 默认值 |
| --- | --- | --- |
| `channel_type` | 设为 `web` | `web` |
| `web_host` | Web 服务监听地址，默认监听 `127.0.0.1`（仅本机），如需公网访问请改为 `0.0.0.0` 并设置密码 | `""` |
| `web_port` | Web 服务监听端口 | `9899` |
| `web_password` | 访问密码，留空表示不启用密码保护；监听 `0.0.0.0` 时建议设置 | `""` |
| `web_session_expire_days` | 登录会话有效天数 | `30` |
| `web_file_serve_root` | web 端可直接读取/发送的文件根目录，默认仅限用户主目录及 agent 工作空间；设为 `/` 可放开整个文件系统 | `"~"` |
| `enable_thinking` | 是否启用深度思考模式 | `false` |

配置密码后，访问控制台时需先输入密码完成登录。登录状态默认保持 30 天，期间重启服务也无需重新登录。密码也支持在控制台的「配置」页面中在线修改。

## 访问地址

启动项目后访问：

- 本地运行：`http://localhost:9899`
- 服务器运行：`http://<server-ip>:9899`

<Note>
  请确保服务器防火墙和安全组已放行对应端口。
</Note>

## 功能介绍

### 对话界面

支持流式输出，可实时展示 Agent 的思考过程（Reasoning）和工具调用过程（Tool Calls），更直观地观察 Agent 的决策过程。深度思考功能可通过配置或控制台的「Agent 配置」开关控制。

<img width="850" src="https://cdn.link-ai.tech/doc/20260227180120.png" />

#### 多会话管理

对话界面支持多会话（Session）管理，所有会话记录持久化存储在数据库中：

- **会话列表**：点击左侧历史会话图标可展开/收起会话列表面板，支持滚动加载全部历史会话
- **AI 生成标题**：新会话在首轮对话完成后，自动调用模型生成简短的会话摘要标题
- **新建会话**：点击会话列表顶部的「新对话」按钮或输入区的 `+` 按钮创建新会话
- **删除会话**：点击会话项的删除按钮，确认后永久删除该会话及其所有消息
- **清除上下文**：点击输入区的清除按钮，在当前会话中插入一条分隔线，分隔线以上的消息仍然展示但不再作为模型的上下文输入

### 模型管理

支持在线管理不同模型厂商的文本、图像、语音、向量模型配置，无需手动编辑配置文件：

<img width="850" src="https://cdn.link-ai.tech/doc/20260521212949.png" />

### 技能管理

支持在线查看和管理 Agent 技能（Skills）：

<img width="850" src="https://cdn.link-ai.tech/doc/20260227173403.png" />

### 记忆管理

支持在线查看和管理 Agent 记忆：

<img width="850" src="https://cdn.link-ai.tech/doc/20260227173349.png" />

### 通道管理

支持在线管理接入通道，支持实时连接/断开操作：

<img width="850" src="https://cdn.link-ai.tech/doc/20260227173331.png" />

### 定时任务

支持在线查看和管理定时任务，包括一次性任务、固定间隔、Cron 表达式等多种调度方式的可视化管理：

<img width="850" src="https://cdn.link-ai.tech/doc/20260227173704.png" />

### 日志

支持在线实时查看 Agent 运行日志，便于监控运行状态和排查问题：

<img width="850" src="https://cdn.link-ai.tech/doc/20260227173514.png" />
