Clawdbot WebChat Lite — 軽量Webチャットクライアント

Web
Clawdbot WebChat Lite — 軽量Webチャットクライアント

Clawdbot WebChat Lite — 軽量Webチャットクライアント

Clawdbot WebChat Liteは、ClawdbotのGateway WebSocketに直接接続することに特化した軽量なチャットクライアントです。新しいチャンネルを作らず「対話」機能にフォーカスすることでメンテナンス性を最小化し、国内での自己ホストやリバースプロキシ経由の運用にも配慮されています。TypeScriptで実装され、会話リスト、履歴取得、メッセージ送信、リアルタイム通知、認証プリセットなど、チャットに必要な基本機能をシンプルに提供します。

https://github.com/study8677/clawdbot-webchat-lite

概要

Clawdbot WebChat Liteは「対話」に特化した軽量チャットクライアントです。Clawdbot本体の機能を変更せず、GatewayのWebSocketに直接接続するアーキテクチャを採用することで、中間サーバーや新たなチャンネルを作らずに動作します。国内での利用を優先し、自己ホストやリバースプロキシでの運用が容易です。基本機能として会話リストの取得（sessions.list）、メッセージ履歴（chat.history）、送信（chat.send）、リアルタイムWS通知、認証情報のローカル保存などを提供し、シンプルで保守コストの低いクライアントを目指しています。

GitHub

リポジトリの統計情報

  • スター数: 5
  • フォーク数: 0
  • ウォッチャー数: 5
  • コミット数: 8
  • ファイル数: 13
  • メインの言語: TypeScript

主な特徴

  • Gateway WebSocketへ直接接続し、余計な中間層を持たないシンプルな設計
  • 会話一覧、履歴取得、メッセージ送信、リアルタイム通知をサポート
  • 自己ホスト／国内デプロイを想定した構成（リバースプロキシ対応）
  • TypeScriptベースで軽量かつメンテナンス性に優れる

技術的なポイント

本プロジェクトの核は「最小限の責務」で安定した対話を提供する点にあります。READMEにある第一性原理の通り、機能を積み重ねるのではなく“対話”を中心に設計しており、Clawdbotの内部を改変せずにGatewayのWS API（URL＋token/password）へ直接接続します。これにより、依存や運用コストを抑えつつ低遅延な双方向通信を実現できます。

実装はTypeScriptで、クライアント側でsessions.listによる会話一覧取得、chat.historyによる過去メッセージ取得、chat.sendによる送信を扱います。WS通知の受信とレンダリングはクライアントで完結するため、メッセージ受信からUI更新までのパスが短くレスポンスが良好です。認証プリセットをローカルに保持する仕組みがあり、複数端末での同期や再接続時の利便性を高めています。

また「国内可用性」を重視しているため、自己ホストやリバースプロキシ経由での運用が前提に組み込まれています。これにより国内のネットワーク環境やポリシーに合わせた導入がしやすく、プライバシーや接続の安定性を確保できます。規模は小さく、ファイル数・コミット数ともにコンパクトなので、カスタマイズや組み込みも容易です。拡張はクライアント側のUIや認証周り、ローカルストレージの扱いなどに絞ることで、コアの安定性を維持しつつ機能追加が可能です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • README.md: file
  • README_en.md: file
  • assets: dir
  • eslint.config.js: file

…他 8 ファイル

まとめ

対話を最優先にした軽量で自己ホストしやすいClawdbotクライアントです。

リポジトリ情報：

  • 名前: clawdbot-webchat-lite
  • 説明: 一个轻量、可国内部署、多端同步的 Clawdbot 聊天客户端。不做新 channel，仅对接 Gateway WebSocket，保证维护成本最低。A lightweight, locally deployable, and multi-device synchronized Clawdbot chat client. It focuses solely on connecting via Gateway WebSocket rather than creating new channels, ensuring minimal maintenance overhead.
  • スター数: 5
  • 言語: TypeScript
  • URL: https://github.com/study8677/clawdbot-webchat-lite
  • オーナー: study8677
  • アバター: https://avatars.githubusercontent.com/u/106414602?v=4

READMEの抜粋：

Clawdbot WebChat Lite

English

Clawdbot WebChat Lite

一个轻量、可自部署、国内可用的 Clawdbot 聊天客户端。
不造新频道，只做“对话这件事”。

第一性原理

  • 对话是核心：一切功能围绕“稳定对话”而不是功能堆叠。
  • 连接即价值：直连 Gateway WS，避免中间层与复杂依赖。
  • 最小维护成本：不造新 channel、不改 Clawdbot 内核。
  • 国内可用优先：可自部署、可反向代理、可控网络链路。

功能亮点

  • 连接 Gateway（URL + token/password）
  • 会话列表（sessions.list）
  • 消息历史与发送（chat.history / chat.send）
  • 实时 WS 通知
  • 认证预设（本地…）