goclaw  by smallnest

AI agent framework for building intelligent assistants

Created 1 month ago
373 stars

Top 76.4% on SourcePulse

GitHubView on GitHub
Project Summary

An open-source AI assistant framework, goclaw provides a robust and extensible platform for building sophisticated AI agents. It targets developers and power users seeking a flexible alternative to existing frameworks like OpenClaw, offering comprehensive tool integration, multi-channel communication, and advanced skill management for complex task automation.

How It Works

goclaw employs a modular architecture centered around an Agent Loop that orchestrates message processing, tool execution, and LLM interactions. Key components include a Message Bus for inter-component communication, a Channel Manager supporting numerous messaging platforms (Telegram, Slack, Discord, etc.), and a Tool Registry offering built-in capabilities like FileSystem, Shell, Web, and Browser automation. A novel Skills System allows agents to dynamically acquire capabilities via Prompt-Driven Markdown files (SKILL.md), featuring automatic environment-aware "Gating" that ensures skills only load when their prerequisites are met. LLM providers (OpenAI, Anthropic, OpenRouter) are pluggable with failover support.

Quick Start & Requirements

Installation involves cloning the repository (git clone), initializing Go modules (go mod tidy), and building the binary (go build -o goclaw .) or running directly (go run main.go). Configuration is managed via config.json (user global, current directory, or specified path) or environment variables (GOSKILLS_*). A Go development environment is required. The Browser automation tool necessitates a local installation of Chrome or Chromium.

Highlighted Details

  • Extensive multi-channel support including Telegram, WhatsApp, Slack, Discord, Microsoft Teams, and more.
  • Advanced Prompt-Driven Skills system with automatic environment gating for dynamic capability acquisition.
  • Flexible LLM provider integration supporting OpenAI, Anthropic, and OpenRouter, with configurable failover strategies.
  • Built-in Browser automation leveraging the Chrome DevTools Protocol for web interaction.
  • Comprehensive Command Line Interface (CLI) for agent management, configuration, and operational monitoring.

Maintenance & Community

The provided README does not detail specific maintainers, community channels (like Discord/Slack), or project roadmap information.

Licensing & Compatibility

goclaw is released under the MIT License, which is permissive and generally compatible with commercial use and closed-source integration.

Limitations & Caveats

Setup requires a Go development environment. The browser automation feature is dependent on a correctly installed and accessible Chrome/Chromium browser. Configuration can be extensive, requiring careful tuning for specific use cases and security policies, particularly for the Shell tool.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
25
Star History
265 stars in the last 30 days

Explore Similar Projects

Starred by Eric Zhu Eric Zhu(Coauthor of AutoGen; Research Scientist at Microsoft Research), Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), and
1 more.

OpenSandbox by alibaba

17.0%
8k
Sandbox platform for AI and LLM applications
Created 2 months ago
Updated 20 hours ago
Feedback? Help us improve.