🪢 moldClaw — Desktop AI Assistant

Fork of MoldClaw for moldClaw Desktop App

This is a fork of MoldClaw, customized for the moldClaw desktop application.

📦 Installation

npm / pnpm / yarn

# npm
npm install @moldclaw/core

# pnpm
pnpm add @moldclaw/core

# yarn
yarn add @moldclaw/core

Global CLI

npm install -g @moldclaw/core
moldclaw --help

🚀 Quick Start

As a Library

import { loadConfig, createDefaultDeps } from "@moldclaw/core";

// Load configuration
const config = await loadConfig("./moldclaw.yaml");

// Create default dependencies
const deps = await createDefaultDeps();

Plugin SDK

import { definePlugin } from "@moldclaw/core/plugin-sdk";

export default definePlugin({
  name: "my-plugin",
  version: "1.0.0",

  async setup(ctx) {
    // Plugin initialization
  },

  async onMessage(ctx, message) {
    // Handle incoming messages
  },
});

CLI Usage

# Start the gateway
moldclaw gateway

# Run in TUI mode
moldclaw tui

# Check status
moldclaw status

📖 API Reference

• Full Documentation: docs.moldclaw.ai
• Plugin SDK Reference: docs.moldclaw.ai/plugin-sdk
• Configuration Guide: docs.moldclaw.ai/configuration

🔐 SEC-1: Secure Token Management

moldClaw supports SEC-1 (Secure Token Placeholder Protocol) for safe credential management.

Quick Start

Instead of storing secrets directly in config files, use __SECURE__ placeholders:

# moldclaw.yaml
discord:
  token: "__SECURE__" # or "__SECURE__DISCORD_TOKEN"

providers:
  openai:
    apiKey: "__SECURE__OPENAI_API_KEY"

Actual values are provided via environment variables:

export DISCORD_BOT_TOKEN="your-token"
export OPENAI_API_KEY="sk-xxx"

Benefits

• ✅ Git-safe - Config files contain no secrets
• ✅ OS Credential Store - Tauri app integration with Keychain/Credential Manager
• ✅ Runtime resolution - Secrets injected at startup

📖 Full SEC-1 Guide | Security Docs

About moldClaw

moldClaw is a personal AI assistant desktop application built on top of the MoldClaw core. This repository contains the core runtime and gateway components.

Upstream

• Original Project: moldclaw/moldclaw
• Documentation: docs.moldclaw.ai

Development

# Clone this fork
git clone https://github.com/msh0678/moldclaw-core.git
cd moldclaw-core

# Install dependencies
pnpm install

# Build
pnpm build

# Run gateway
pnpm moldclaw gateway

See CONTRIBUTING.md for development guidelines.

License

MIT License - See LICENSE for details.

This is a fork maintained for the moldClaw desktop application. For the original MoldClaw project, visit github.com/moldclaw/moldclaw.