Files

gavrielc 57a6491c7e v2: channel isolation model, manage-channels skill, refactored channel skills

- Add three-level isolation model (shared session, same agent, separate agent)
  with agent-shared session mode for cross-channel shared sessions
- Create /manage-channels skill for wiring channels to agent groups
- Refactor all 12 v2 channel skills: lean SKILL.md + VERIFY.md + REMOVE.md
  with structured Channel Info section for platform-specific metadata
- Create /add-discord-v2 skill (was missing)
- Add step 5a to setup SKILL.md invoking /manage-channels after channel install
- Update setup/verify.ts to check all 12 channel token types
- Add docs/v2-isolation-model.md explaining the isolation model
- Update v2-checklist.md and v2-setup-wiring.md to reflect completed work

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-09 13:19:19 +03:00

2.1 KiB

Raw Blame History

name, description

name	description
add-gchat-v2	Add Google Chat channel integration to NanoClaw v2 via Chat SDK.

Add Google Chat Channel

Adds Google Chat support to NanoClaw v2 using the Chat SDK bridge.

Pre-flight

Check if src/channels/gchat.ts exists and the import is uncommented in src/channels/index.ts. If both are in place, skip to Credentials.

Install

npm install @chat-adapter/gchat

Uncomment the Google Chat import in src/channels/index.ts:

import './gchat.js';

npm run build

Credentials

Go to Google Cloud Console

Create or select a project

Enable the Google Chat API

Go to Google Chat API > Configuration:

App name and description

Connection settings: select HTTP endpoint URL and set to https://your-domain/webhook/gchat

Create a Service Account:

Go to IAM & Admin > Service Accounts > Create Service Account

Grant the Chat Bot role

Create a JSON key and download it

Configure environment

Add the service account JSON as a single-line string to .env:

GCHAT_CREDENTIALS={"type":"service_account","project_id":"...","private_key":"...","client_email":"..."}

Sync to container: mkdir -p data/env && cp .env data/env/env

Next Steps

If you're in the middle of /setup, return to the setup flow now.

Otherwise, run /manage-channels to wire this channel to an agent group.

Channel Info

type: gchat
terminology: Google Chat has "spaces." A space can be a group conversation or a direct message with the bot.
how-to-find-id: Open the space in Google Chat, look at the URL — the space ID is the segment after /space/ (e.g. spaces/AAAA...). Or use the Google Chat API to list spaces.
supports-threads: yes
typical-use: Interactive chat — team spaces or direct messages
default-isolation: Same agent group for spaces where you're the primary user. Separate agent group for spaces with different teams or sensitive contexts.

2.1 KiB Raw Blame History