Skip to content

Shannon OpenClaw integration#165

Open
Admuad wants to merge 6 commits intoKeygraphHQ:mainfrom
Admuad:feature/openclaw-integration
Open

Shannon OpenClaw integration#165
Admuad wants to merge 6 commits intoKeygraphHQ:mainfrom
Admuad:feature/openclaw-integration

Conversation

@Admuad
Copy link

@Admuad Admuad commented Feb 26, 2026

Summary

This PR adds OpenClaw skill integration to Shannon, enabling chat-based control and automation of pentest workflows.

Features

  • OpenClaw Skill: Natural language commands to trigger, monitor, and schedule pentests

  • Helper Script: shannon-helper.sh for programmatic Shannon control

  • Documentation: Complete setup guide and usage examples

  • Z.AI Router Support: Add GLM models (glm-5, glm-4.7) as router provider

Files Added/Modified

  • openclaw/SKILL.md - Main skill documentation

  • openclaw/shannon-helper.sh - Helper CLI wrapper

  • openclaw/README.md - Setup and usage guide

  • configs/router-config.json - Added Z.AI provider

  • docker-compose.yml - Added ZAI_API_KEY support

  • README.md - Updated with OpenClaw and Z.AI sections

  • .env.example - Documented Z.AI usage

  • shannon - Updated API key checks for Z.AI

  • test-zai.sh - Integration validation script

  • test-zai-api.sh - API key validation script

Testing

  • ✅ All 7 Z.AI integration tests passed
  • ✅ Router configuration validated
  • ✅ Documentation complete
  • ⚠️ Z.AI router requires Docker Desktop (Podman has volume mount issues)

Notes

  • Router mode remains experimental and unsupported
  • OpenClaw integration provides a convenient chat interface but is optional
  • Z.AI API key validation confirms authentication works (needs funding for testing)

This integration allows users to control Shannon entirely through chat commands and schedule automated security scans.

Related: Add alternative model support via router mode

Adds OpenClaw skill integration for Shannon, enabling:
- Natural chat commands to trigger pentests
- Real-time progress monitoring
- Result summaries delivered to chat
- Cron-based automated scanning schedules
- Workspace management and resumption

The integration includes:
- SKILL.md: Documentation for OpenClaw agents
- shannon-helper.sh: Helper script wrapping Shannon CLI
- README.md: Setup and usage guide

This allows users to control Shannon entirely through chat
commands and schedule automated security scans.

Related: OpenClaw integration for AI-assisted pentesting
Documents the new OpenClaw integration feature that enables
chat-based control and automation of Shannon pentests.
Adds Z.AI as a new provider in router mode, enabling Shannon
to use GLM-5 and GLM-4.7 models via the Z.AI API.

Changes:
- router-config.json: Add Z.AI provider with glm-5 and glm-4.7
- docker-compose.yml: Add ZAI_API_KEY environment variable
- .env.example: Document Z.AI API key usage
- README.md: Add Z.AI to experimental models table
- shannon script: Update API key checks to include ZAI_API_KEY
- openclaw/SKILL.md: Update requirements to mention Z.AI

Usage:
  ZAI_API_KEY=your-key ROUTER_DEFAULT=zai,glm-5 ./shannon start URL=https://example.com REPO=repo-name ROUTER=true

Note: Router mode remains experimental and unsupported.
Validates that all Z.AI router integration components are
properly configured and documented.
Tests Z.AI API key functionality independently of Shannon.
Note: API key is valid but account needs balance.
Documents current integration status, testing results,
known issues, and next steps for Z.AI support.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant