nanoclaw-gws-ea: Skill for Claude Code

Add Microsoft Teams Channel

Connect NanoClaw to Microsoft Teams for interactive chat in team channels, group chats, and direct messages.

Install

NanoClaw doesn't ship channels in trunk. This skill copies the Teams adapter in from the channels branch.

Pre-flight (idempotent)

Skip to Credentials if all of these are already in place:

• src/channels/teams.ts exists
• src/channels/index.ts contains import './teams.js';
• @chat-adapter/teams is listed in package.json dependencies

Otherwise continue. Every step below is safe to re-run.

1. Fetch the channels branch

git fetch origin channels

2. Copy the adapter

git show origin/channels:src/channels/teams.ts > src/channels/teams.ts

3. Append the self-registration import

Append to src/channels/index.ts (skip if the line is already present):

import './teams.js';

4. Install the adapter package (pinned)

pnpm install @chat-adapter/[email protected]

5. Build

pnpm run build

Credentials

Two paths — manual (Azure Portal) or auto (Teams CLI).

Auto: Teams CLI

Requires Node.js 18+, a Microsoft 365 account with sideloading permissions, and a public HTTPS endpoint (ngrok, Cloudflare Tunnel, or similar).

1. Install the CLI:

   npm install -g @microsoft/teams.cli@preview
   

2. Sign in and verify:

   teams login
   teams status
   

3. Create the Entra app, client secret, and bot registration:

   teams app create \
     --name "NanoClaw" \
     --endpoint "https://your-domain/api/webhooks/teams"
   

   The CLI prints the credentials as CLIENT_ID, CLIENT_SECRET, and TENANT_ID. Map them to NanoClaw's env keys:

   • CLIENT_ID → TEAMS_APP_ID
   • CLIENT_SECRET → TEAMS_APP_PASSWORD
   • TENANT_ID → TEAMS_APP_TENANT_ID

4. Pick Install in Teams from the post-create menu and confirm in the Teams dialog.

Continue to Configure environment.