a69b9d9160
Permission-first AI agent runtime for Google Workspace. Ports the LARC/OpenClaw governance model (disclosure chain, execution gates, queue/ingress) to Gmail, Calendar, Drive, Sheets, Tasks, and People APIs with Claude Code as the execution engine. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
102 lines
4.3 KiB
Markdown
102 lines
4.3 KiB
Markdown
# GARC — Google Workspace エージェントランタイム CLI
|
||
|
||
Google Workspace ネイティブなオフィスワークエージェントのためのパーミッションファーストランタイム。
|
||
|
||
GARC は [LARC](../larc-openclaw-coding-agent/) の Google Workspace 版です。同じガバナンスアーキテクチャ（開示チェーン・実行ゲート・エージェントレジストリ・スコープ推定）を、Google Drive・Sheets・Gmail・Calendar・Tasks を使う組織向けに実装します。
|
||
|
||
## GARCとは
|
||
|
||
```
|
||
上位エージェント（Claude Code / OpenClaw）
|
||
-> GARC CLI/ランタイム
|
||
-> Google Workspace APIs（Drive, Sheets, Gmail, Calendar, Tasks, Chat）
|
||
```
|
||
|
||
GARCが追加するもの:
|
||
|
||
1. **パーミッションインテリジェンス** — `garc auth suggest "<タスク>"` で自然言語タスクに必要な最小OAuthスコープを推定
|
||
2. **実行ゲート** — エージェントアクション実行前に `none / preview / approval` の3段階ゲート
|
||
3. **エージェントレジストリ** — エージェント定義をGoogle Sheetsに保存（id, model, scopes, folder）
|
||
4. **開示チェーン** — `SOUL.md / USER.md / MEMORY.md / HEARTBEAT.md` をGoogle Driveにバックアップ
|
||
5. **メモリ同期** — Google Sheetsとの日次メモリ双方向同期
|
||
6. **キュー/イングレス** — Gmail起動のタスクライフサイクル管理
|
||
7. **ナレッジグラフ** — Google Docsをリンクされた概念ノードとして活用
|
||
|
||
## GWS ↔ LARC バックエンド対応表
|
||
|
||
| 機能 | LARC（Lark） | GARC（Google Workspace） |
|
||
|------|-------------|------------------------|
|
||
| ファイルストレージ | Lark Drive | Google Drive |
|
||
| 構造化データ | Lark Base | Google Sheets |
|
||
| メッセージング | Lark IM | Gmail / Google Chat |
|
||
| ナレッジ | Lark Wiki | Google Docs |
|
||
| 承認フロー | Lark Approval | Sheets連携承認フロー |
|
||
| カレンダー | Lark Calendar | Google Calendar |
|
||
| タスク | Lark Project | Google Tasks |
|
||
| 認証CLI | `lark-cli` | `gcloud` + googleapis |
|
||
| MCPツール | `openclaw-lark` | Gmail/Drive/Calendar MCP |
|
||
|
||
## クイックスタート
|
||
|
||
```bash
|
||
# インストール
|
||
git clone <this-repo>
|
||
cd garc-gws-agent-runtime
|
||
./scripts/setup-workspace.sh
|
||
|
||
# 設定
|
||
cp config/config.env.example ~/.garc/config.env
|
||
# ~/.garc/config.env をGWS認証情報で編集
|
||
|
||
# 初期化
|
||
garc init
|
||
garc bootstrap --agent main
|
||
|
||
# 日常使用
|
||
garc memory pull
|
||
garc auth suggest "経費サマリーをマネージャーに送信"
|
||
garc task list
|
||
```
|
||
|
||
## 設定（`~/.garc/config.env`）
|
||
|
||
```bash
|
||
GARC_DRIVE_FOLDER_ID=1xxxxx # エージェントワークスペース用Driveフォルダ
|
||
GARC_SHEETS_ID=1xxxxx # メモリ/レジストリ/キュー用Sheets
|
||
GARC_GMAIL_DEFAULT_TO=you@gmail.com # デフォルト通知先メール
|
||
GARC_CALENDAR_ID=primary # Google Calendar ID
|
||
GARC_CREDENTIALS_FILE=~/.garc/credentials.json
|
||
GARC_TOKEN_FILE=~/.garc/token.json
|
||
```
|
||
|
||
## コマンド一覧
|
||
|
||
```bash
|
||
garc init # ワークスペース初期化
|
||
garc bootstrap [--agent <id>] # Driveから開示チェーン読み込み
|
||
garc memory pull/push/search # Sheetsとメモリ同期
|
||
garc send "<msg>" [--to <email>] # Gmail/Google Chat経由で送信
|
||
garc task list/create/done # Google Tasks操作
|
||
garc approve gate <task_type> # 実行ゲートポリシー確認
|
||
garc approve list/create # 承認管理
|
||
garc agent list/register # エージェントレジストリ操作
|
||
garc auth suggest "<タスク>" # OAuthスコープ推定
|
||
garc auth check [--profile <p>] # 現在のトークンスコープ確認
|
||
garc auth login [--profile <p>] # OAuthフロー起動
|
||
garc heartbeat # システム状態をSheetsに記録
|
||
garc status # 設定とヘルスチェック表示
|
||
garc kg build/query/show # ナレッジグラフ操作
|
||
garc ingress enqueue/list/next # キュー管理
|
||
```
|
||
|
||
## LARCとの関係
|
||
|
||
GARCとLARCは同じランタイムガバナンスモデルを共有します。バックエンドに応じて選択してください：
|
||
|
||
- Feishu / Lark → **LARC**
|
||
- Google Workspace → **GARC**
|
||
- 両方のプラットフォーム → 両方デプロイ（エージェントYAML形式は互換性あり）
|
||
|
||
## ライセンス
|
||
|
||
MIT
|