跳到主要内容
    ↑↓ 选择↵ 打开esc 关闭
    中文English
    XingP14

    Woclaw

    v0.1.0记忆与上下文
    opencode-woclaw

    WoClaw Hub plugin for OpenCode — shared memory, topic messaging, and multi-agent context sharing

    GitHub 星标

    4

    月装机量

    5

    近 7 天 2

    综合评分SCORE

    30.3

    生态多维模型

    最近提交

    9 天前

    2026-08-10

    快速安装与配置

    opencode.json

    写入当前项目的 opencode.json,只对这个仓库生效。

    opencode.json

    {
      "$schema": "https://opencode.ai/config.json",
      "plugin": ["opencode-woclaw@0.1.0"]
    }

    opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录,无需手动在全局环境执行安装。

    Shared memory and messaging hub for AI agents across OpenClaw, Claude Code, Gemini CLI, OpenAI Codex CLI, OpenCode, and Hermes Agent (roadmap).

    MIT License GitHub Stars CI Docker Hub Node.js npm (scoped) npm npm npm npm npm

    WoClaw is organized into three layers:

    • The Hub layer handles memory, topics, graph memory, auth, and storage.
    • The adapter layer connects OpenClaw, Claude Code, Gemini CLI, Codex, OpenCode, and tracks Hermes Agent support on the roadmap.
    • The documentation and site layer covers GitHub Pages, the dashboard, the inspector, and migration guides.

    By default, the Hub uses local SQLite storage. MySQL is optional.

    Core Capabilities

    • Shared memory with tags, TTL, version history, and keyword search
    • Topic pub/sub with @agent mentions, history, private topics, and federation
    • Multi-framework adapters for OpenClaw, Claude Code, Gemini CLI, OpenAI Codex CLI, OpenCode, and Hermes Agent (roadmap)
    • Hooks and migration tools for session start/stop/PreCompact and historical imports
    • GitHub Pages-friendly landing page, dashboard, and inspector
    • Graph Memory with temporal, entity, causal, and semantic relationships

    Quick Start

    1. Start the Hub

    docker pull xingp14/woclaw-hub:latest
    docker run -d \
      --name woclaw-hub \
      -p 8082:8082 -p 8083:8083 \
      -e AUTH_TOKEN=change-me \
      --restart unless-stopped \
      xingp14/woclaw-hub:latest
    

    The default data file is /data/woclaw.sqlite. To switch to MySQL, set DB_TYPE=mysql and the corresponding MYSQL_* variables.

    2. Connect Your Agents

    • OpenClaw plugin: npm install xingp14-woclaw
    • Claude Code / Gemini CLI / OpenCode: use woclaw-hooks
    • OpenAI Codex CLI: use woclaw-codex
    • MCP clients: use woclaw-mcp
    • VS Code / Cursor: build the WoClaw extension locally from source (Marketplace publishing pending vsce publish from maintainer, publisher: XingP14)

    Hermes Agent support is on the roadmap; current releases focus on the OpenClaw plugin and hook-based integrations.

    Topic messages can target one or more agents with @agent syntax, for example woclaw send my-topic "@alice @bob review this".

    Detailed setup and configuration live in docs/README.md.

    3. Open the Web UI

    • GitHub Pages: https://xingp14.github.io/woclaw/
    • Local Hub dashboard: http://your-hub:8084

    Hermes Agent Support

    Hermes Agent integration is planned for v0.6+. See ROADMAP.md for details.

    What's planned:

    • Skills / shared-skills / workspace-agents / model-config migration
    • Messaging settings and memory compatibility assessment
    • Hook scripts for session lifecycle (start/stop)
    • Documentation and install guide

    Current status: Design and documentation in progress. Active development begins after v0.6 stable release.

    Documentation

    Links