--- 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://:9899` 请确保服务器防火墙和安全组已放行对应端口。 ## 功能介绍 ### 对话界面支持流式输出，可实时展示 Agent 的思考过程（Reasoning）和工具调用过程（Tool Calls），更直观地观察 Agent 的决策过程。深度思考功能可通过配置或控制台的「Agent 配置」开关控制。

#### 多会话管理对话界面支持多会话（Session）管理，所有会话记录持久化存储在数据库中： - **会话列表**：点击左侧历史会话图标可展开/收起会话列表面板，支持滚动加载全部历史会话 - **AI 生成标题**：新会话在首轮对话完成后，自动调用模型生成简短的会话摘要标题 - **新建会话**：点击会话列表顶部的「新对话」按钮或输入区的 `+` 按钮创建新会话 - **删除会话**：点击会话项的删除按钮，确认后永久删除该会话及其所有消息 - **清除上下文**：点击输入区的清除按钮，在当前会话中插入一条分隔线，分隔线以上的消息仍然展示但不再作为模型的上下文输入 ### 模型管理支持在线管理不同模型厂商的文本、图像、语音、向量模型配置，无需手动编辑配置文件：

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

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

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

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

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