OpenClaw Connector

設定 UI は /settings/developer の「Connectors (OpenClaw)」セクション。

概要

OpenClaw は self-hosted Gateway を持つ LLM ランタイム。 TAS-CHA から OpenClaw を呼ぶ方向と、 OpenClaw が TAS-CHA を tool/data source として扱う方向の双方を支援する。

方向	推奨 surface
TAS-CHA → OpenClaw	OpenClaw Connector
OpenClaw → TAS-CHA	Remote MCP (remote-mcp.md) または /v1 REST

設定

UI: /settings/developer → "Connectors (OpenClaw)"

フィールド	説明
gatewayBaseUrl	OpenClaw Gateway URL。 public URL は警告
gatewayToken	Gateway token。 encrypted vault 保存、 表示不可
agentId / model	OpenClaw agent ID または openclaw/default 等
sessionStrategy	room / thread / record / user のいずれか
allowedRoomIds	この connector で使える room の allowlist。 必須
toolProfile	read_only / task_writer / message_writer
networkMode	private / tailnet / public_with_proxy

セキュリティ要件

OpenClaw の Gateway token は強い operator credential。 通常の API token より厳格に扱う:

1. Gateway URL は localhost / private / tailnet を推奨。 public_with_proxy は明示的警告
2. token は encrypted vault に保存。 UI からは表示不可、 rotation のみ
3. allowedRoomIds を 必須。 全 room 解放は禁止
4. agent 実行は job 化 (timeout / cancellation / audit log)
5. agent の tool call が TAS-CHA に書き込む場合は idempotency key 必須
6. shared room (multi-org) で broad tool access を禁止
7. agent の tool 権限は TAS-CHA 側 connector scope より広げない

実行モデル

[ TAS-CHA UI / Action ]
        │
        ▼
[ Connector Runtime ] (request 認可 + units 予約 + audit log)
        │
        ▼
[ OpenClaw Gateway ] POST /v1/responses / /v1/chat/completions
        │
        ▼
[ TAS-CHA に tool call で write ] (idempotent)

• user / x-openclaw-session-key に TAS-CHA の room/thread/record id を入れて OpenClaw の session を安定化
• prompt には TAS-CHA 側で取得した context のみ載せる
• OpenClaw 側 tool 権限は TAS-CHA connector scope の subset に絞る

提供アクション

TAS-CHA の設定画面から実行する。 すべて Connector Runtime (agent.run 等の manifest action) を通るため、 room allowlist / toolProfile / scope / rate limit / API units / 監査が適用される。

アクション	内容	必要 toolProfile
test-connection	GET /v1/models で疎通確認	(どれでも)
summarize-record	議事録を要約 (agent.run, 20 units)	(どれでも)
generate-tasks	議事録からタスク案を抽出し作成 (dryRun で提案のみ)	task_writer 以上
reply-to-room	直近の会話 + 指示からルームへ返信を投稿	message_writer

session key は sessionStrategy に応じて tascha:room:{id} / tascha:record:{id} / tascha:user:{id} を user フィールドと x-openclaw-session-key ヘッダーに入れる。

API units cost

操作	units
Connector action run	10
OpenClaw agent run	20
(内部) read fetch	1
(内部) write	3

短期 burst:

• openclawRunsPerMinute: 10
• openclawConcurrentRuns: 3

quota は billing entity 単位。 連続実行は内部 queue で順番処理。

想定ユースケース

• ルームの「議事録から TODO 案を作る」自動化
• 承認依頼の要約・リスク抽出
• 未読メッセージやタスクの自然言語整理
• ルーム内 bot として返答

いずれも実行は job 化 され、 結果はメッセージまたは記録として TAS-CHA 側に残る。

やってはいけないこと

• Gateway token を Git / Slack / .env (commit 済み) に書く
• public Gateway URL を allowlist なしで登録する
• shared room (社外参加者あり) で full write profile を使う
• TAS-CHA 認証情報を OpenClaw 側 tool に渡す (両者は OAuth で別 audience)