← Back to Skills Marketplace
agenticio

bot

by agenticio · GitHub ↗ · v2.1.0 · MIT-0
cross-platform ✓ Security Clean
565
Downloads
0
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install bot
Description
The Universal Autonomous Entity Standard. A local-first framework for observable, composable agents with policy-guarded execution on ClawHub.
README (SKILL.md)

BOT: Standardized Agent Framework

bot is a local-first agent framework for observable execution, composable tool use, and multi-agent orchestration.

Safety Model

  • Network: Core demos do not initiate outbound network requests by default.
  • Execution: This release provides policy-guarded local execution, not OS-level sandbox isolation.
  • File System: Local memory is stored in ./.bot_memory/ by default, configurable via BOT_MEMORY_DIR.
  • Viewer: Optional local monitor binds to 127.0.0.1 only when explicitly started.
  • Credentials: No external API keys required for core demos.

Included Capabilities

  • Single-agent reasoning core
  • Botfile static declaration
  • TUI thought visualization
  • Crypto identity and signing
  • Multi-agent coordination
  • Local Web thought-tree viewer
  • Unified local run entrypoint
  • Capability-aware tool registration
  • Policy-guarded execution layer

Quick Start

PYTHONPATH=. python3 examples/run_bot.py --mode multi --prompt "Design a safe local-first agent workflow"

Custom Roles

PYTHONPATH=. python3 examples/run_bot.py --mode multi --roles "planner_bot,critic_bot,executor_bot,auditor_bot"

Single-Agent Mode

PYTHONPATH=. python3 examples/run_bot.py --mode single --prompt "Summarize this task safely"

Then open:

  • http://127.0.0.1:8765
Usage Guidance
This skill is a local agent framework and appears coherent with its description, but it executes Python callables directly (PolicyExecutor.execute) and stores information under ./.bot_memory by default. Before running: (1) run inside a virtual environment (install.sh recommends this), (2) inspect any Botfile or third-party tools you register to ensure they don't perform unwanted filesystem or network actions, (3) be aware there is no OS-level sandboxing — policies are runtime checks only, not enforcement of OS restrictions, and (4) the web viewer binds to 127.0.0.1 by default (local only). If you plan to register or load untrusted code, treat it as potentially able to perform arbitrary local actions and isolate it accordingly.
Capability Analysis
Type: OpenClaw Skill Name: bot Version: 2.1.0 The 'bot' skill bundle is a well-structured framework for local agent orchestration, featuring multi-agent coordination, policy-guarded execution, and a local visualization tool. Analysis of the source code (e.g., src/core/reasoning.py, src/protocol/alignment.py) and the local web server (src/web/thought_tree.py) shows no evidence of data exfiltration, malicious execution, or prompt injection; all operations are consistent with the stated goal of providing a safe, local-first agent environment.
Capability Assessment
Purpose & Capability
Name/description (local-first agent framework) aligns with the delivered files: agent core, multi-agent coordinator, tool registry, policy layer, local web viewer, and examples. Declared requirements (none) are consistent with a pure-Python, local-first demo framework.
Instruction Scope
SKILL.md and example code are focused on local execution and explicitly state no outbound network by default. The runtime instructions and code read/write a local memory directory (./.bot_memory or BOT_MEMORY_DIR) and optionally load a Botfile. The code can execute arbitrary Python callables via PolicyExecutor.execute (no OS-level sandboxing) — this is expected for a framework but is a behavioral surface the user should understand and control (only register trusted tools).
Install Mechanism
No platform install spec is declared (instruction-only from registry), though an install.sh and requirements.txt are included for manual setup (pip install -r requirements.txt). No downloads from untrusted URLs or archive extraction are present.
Credentials
No required credentials or env vars are declared. The code optionally respects BOT_MEMORY_DIR to configure local memory storage. No secret-scoped environment variables are requested or used.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges or modify other skills. It persists local agent memory under a local directory it creates (./.bot_memory) which is proportional to its purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bot
  3. After installation, invoke the skill by name or use /bot
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
Version 2.1.0 - Introduced policy-guarded execution: agents now enforce policies during tool use and code execution. - Added a policy executor module and a policy demo example to illustrate new safety controls. - Improved documentation: clarified the safety model, updated quick start info, and detailed new capabilities in SKILL.md. - Expanded agent features with capability-aware tool registration and support for crypto identity/signing. - Removed legacy sandbox code in favor of the new policy-driven approach.
v2.0.1
Version 2.0.1 introduces a unified local run entrypoint for easier agent execution. - Added examples/run_bot.py as the primary entrypoint for running agents in both single and multi-agent modes. - Expanded documentation with unified quick start and usage examples for single and multi-agent workflows. - Updated internal web viewer integration and usage instructions.
v2.0.0
Version 2.0.0 of bot introduces multi-agent orchestration and web-based visualization. - Added support for multi-agent coordination and demo script (`examples/multi_agent_demo.py`). - Introduced local web-based "thought tree" viewer (`src/web/thought_tree.py`). - Expanded documentation to cover new features and quick start for multi-agent mode. - Updated security model details and included observability/visualization improvements. - Updated dependencies and instructions to reflect new capabilities.
v1.3.0
- Introduced cryptographic identity support by adding src/protocol/crypto_identity.py. - Updated core reasoning logic in src/core/reasoning.py, possibly to utilize or integrate new identity features.
v1.2.0
Version 1.2.0 - Added a new TUI (Text User Interface) tool at src/tools/tui.py to enhance user interaction options. - Updated core reasoning logic in src/core/reasoning.py.
v1.1.0
bot 1.1.0 - Added new file: src/tools/botfile.py - Introduces initial support for bot file tools.
v1.0.1
BOT 1.0.1 — Foundational release for secure, composable autonomous agents. - Added modular source files for perception, reasoning, alignment, identity, memory, tool registry, and sandboxing. - Security: Network access is default-deny; file system sandboxed by default; runs locally without external API keys. - Provided install script and requirements.txt for easy setup. - New quick start Python example demonstrates basic agent creation and reasoning cycle. - Updated documentation to reflect security features and usage on ClawHub.
v1.0.0
Initial sovereign entity release
Metadata
Slug bot
Version 2.1.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 8
Frequently Asked Questions

What is bot?

The Universal Autonomous Entity Standard. A local-first framework for observable, composable agents with policy-guarded execution on ClawHub. It is an AI Agent Skill for Claude Code / OpenClaw, with 565 downloads so far.

How do I install bot?

Run "/install bot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is bot free?

Yes, bot is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does bot support?

bot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created bot?

It is built and maintained by agenticio (@agenticio); the current version is v2.1.0.

💬 Comments