ClawCloud-Run:ClawCloud 自動ログインと Cookie 管理ツール

DevOps

概要

ClawCloud-Run は、ClawCloud へのログイン処理を GitHub Actions と Python スクリプトで自動化するプロジェクトです。主な目的はログインセッション(Cookie)を定期的に更新・保存し、初回や追加のデバイス確認が必要な場合は Telegram ボットを通じた通知で素早く承認することにあります。Secrets に GitHub のユーザー名・パスワード、Telegram のボット情報、そして REPO_TOKEN(ワークフローが Secrets を更新するためのトークン)を設定することで、ワークフローが実行されるたびに最新の Cookie が取得され、必要に応じて自動的に Secret の更新まで行える設計です。

GitHub

リポジトリの統計情報

  • スター数: 10
  • フォーク数: 7
  • ウォッチャー数: 10
  • コミット数: 30
  • ファイル数: 5
  • メインの言語: Python

主な特徴

  • GitHub Actions で ClawCloud へのログイン処理を自動実行
  • Telegram ボットでデバイス確認通知を受け取り、承認フローを補助
  • 実行ごとに Cookie を更新して最新セッションを保持
  • REPO_TOKEN を使った Secret の自動更新機能(要適切な権限)

技術的なポイント

本プロジェクトは Python を用いた自動ログイン処理と、GitHub Actions ワークフローの組み合わせが中心です。ワークフローはシークレットから GH_USERNAME / GH_PASSWORD を読み取り、Requests 等の HTTP クライアントで ClawCloud のログインエンドポイントにアクセスします。既存のセッション Cookie(GH_SESSION)が保存されていれば読み込んで再利用し、無効なら新規ログインを試行します。初回や追加デバイス確認が要求されるケースでは、Telegram ボット(TG_BOT_TOKEN, TG_CHAT_ID)を使って通知を送信し、ユーザーが 30 秒以内に承認する必要があるという運用上の条件が README に明記されています。Cookie は実行ごとに更新され、更新された Cookie を Secrets に書き戻すために REPO_TOKEN を利用する仕組みがあり、これはワークフローに Secrets 書き込み権限が必要となる点で権限設計とセキュリティの配慮が求められます。構成ファイル群は .github ディレクトリにワークフローが格納され、scripts ディレクトリにログインや通知に関するスクリプトが置かれている想定です。運用上の注意点として、REPO_TOKEN のスコープ管理、Secrets へのアクセスログ監査、Telegram のチャット ID と Bot トークンの安全管理、処理失敗時の再試行やレートリミット対策などを検討すると良いでしょう。(約700字)

プロジェクトの構成

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

  • .github: dir
  • 1.png: file
  • 3.png: file
  • README.md: file
  • scripts: dir

まとめ

GitHub Actions と Telegram を使い、ClawCloud セッション管理を自動化する実用的なツール。

リポジトリ情報:

READMEの抜粋:

⭐ Star 星星走起 动动发财手点点⭐Star

设备验证

⚠️ 注意

  • 首次运行:可能需要设备验证,收到 TG 通知后 30 秒内批准
  • REPO_TOKEN:需要有 Secrets 写入权限才能自动更新
  • Cookie 有效期:每次运行都会更新,保持最新 设备验证

Secrets 配置

Secret 名称说明
GH_USERNAMEGitHub 用户名
GH_PASSWORDGitHub 密码
GH_SESSIONCookie(首次可为空)不用添加
TG_BOT_TOKENTelegram Bot Token
TG_CHAT_IDTelegram Chat ID
REPO_TOKENGitHub Token(用于自动更新 Secret)

流程图

开始

加载已保存的 Cookie(如果有)

访问 ClawCloud

已...