Web UI 服务器
openclacky server 启动一个内嵌的 HTTP + WebSocket 服务器，提供完整的浏览器操作界面，支持同时运行多个持久 Agent 会话。
启动服务器
openclacky server
默认监听 http://127.0.0.1:7070，在浏览器中打开即可使用。
参数
| 参数 | 默认值 | 说明 |
|---|---|---|
--host |
127.0.0.1 |
绑定地址 |
--port |
7070 |
监听端口 |
# 自定义地址和端口
openclacky server --host 0.0.0.0 --port 8080
主要功能
多会话管理
创建多个命名会话——每个会话运行独立的 Agent，有自己的工作目录。通过左侧边栏自由切换。
服务器重启后会自动恢复：每个工作目录最近的 5 个会话在启动时自动还原。
会话状态
每个会话显示当前状态：
- 空闲（Idle） — 等待输入
- 运行中（Running） — Agent 正在工作
- 错误（Error） — 上次任务失败
定时任务
服务器内置调度器。通过 cron-task-creator Skill 定义的任务会按计划自动执行，不需要保持终端会话。
在 Web UI 中直接管理定时任务：
- 查看所有任务和 cron 表达式
- 启用/禁用单个任务
- 立即手动触发任务
- 查看执行历史和输出
IM 渠道集成
通过 channel-setup 配置后，服务器在后台管理 IM 渠道适配器（飞书、企业微信），每个平台运行在独立线程中。Agent 通过服务器接收并回复这些渠道的消息。
Skill 管理
Web UI 展示所有已安装的 Skill（内置 + 用户安装），支持直接启用/禁用，无需编辑文件。
权限模式
服务器始终以 confirm_all 模式运行：文件操作和 shell 命令自动批准，但需要明确人工操作的任务会暂停等待。这适合无人值守运行的服务器场景。
初始配置引导
首次启动时如果未配置 API 密钥，浏览器会显示引导流程：
- 密钥配置 — 输入 API 密钥并测试连接
- 个性设置 — 自定义 Agent 人设（可选，可跳过）
完成后，配置保存到 ~/.clacky/config.yml，后续启动直接进入正常模式。
PID 文件
服务器在 $TMPDIR/clacky-server-<port>.pid 写入 PID 文件。启动时如果同端口已有旧进程，会自动终止它，再启动新实例。