CSGClaw：界面操作指南（内置 WebUI / IM）

← 返回 CSGClaw 概览

打开与加载

• 执行 csgclaw serve 后，在浏览器中打开终端里打印的访问地址（常见为 http://127.0.0.1:18080/）。
• 页面为内置 IM 工作区：首次进入会加载当前用户、用户列表与房间（会话）等数据。

会话与成员

• 在界面中创建、切换或管理会话（房间），并按需邀请成员；具体操作以当前版本界面为准。
• 需要与系统集成或自动化时，可使用 API 与配置 中「内置 IM」所列接口创建房间、拉取列表、邀请成员、删除会话等。

消息与 @ 提及

• 在会话中发送消息；正文中使用 @handle 可形成提及，便于定向通知。
• 历史消息与实时更新由服务推送；界面会随事件刷新内容。

将 Agent 纳入会话

• 在业务流程中需要把某个 Agent 拉进指定会话时，可调用 POST /api/v1/im/agents/join（请求体含 agent_id、room_id 等，见 API 与配置）。

飞书（可选）

• 在 config.toml 中配置 channels.feishu：设置真人管理员的 admin_open_id，并为每个机器人身份配置子表（如 [channels.feishu.u-manager]），填写对应飞书应用的 app_id 与 app_secret。机器人 ID 需符合约定（u-manager 为保留；自定义建议 u-{name}）。勿在公开场合泄露 app_secret。
• 飞书 Bot 事件流：GET /api/v1/channels/feishu/bots/{id}/events（SSE），请求头需带 Authorization: Bearer，与 [server].access_token 一致。

更多 HTTP 与配置细节见 API 与配置。