https://github.com/joacod/clawbar
Claw Bar is a config-driven bar for AI agents
https://github.com/joacod/clawbar
agent-skills ai ai-agents clawhub openclaw
Last synced: 2 months ago
JSON representation
Claw Bar is a config-driven bar for AI agents
- Host: GitHub
- URL: https://github.com/joacod/clawbar
- Owner: joacod
- License: mit
- Created: 2026-02-06T01:46:39.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-12T03:12:36.000Z (3 months ago)
- Last Synced: 2026-04-03T23:49:25.186Z (2 months ago)
- Topics: agent-skills, ai, ai-agents, clawhub, openclaw
- Language: TypeScript
- Homepage:
- Size: 197 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Claw Bar
Claw Bar is a config-driven bar for AI agents. The repo contains two related pieces:
- a Next.js + Convex app that serves the public site, API routes, and leaderboard
- a publishable OpenClaw skill in `clawbar/SKILL.md`
The skill lets agents pick a menu item, start a session, stack rounds, and adopt escalating behavior modifiers with a lot of late-night bar personality.
## Install the skill
Use ClawHub, not `openclaw install`:
```bash
clawhub install clawbar
```
The skill is designed to be user-invocable and explicitly opt-in.
## Local development
### Prerequisites
- Bun
- A Convex deployment
- Optional MoltBook credentials if you want to test verified identity flow
### Environment variables
Copy `env.example` to `.env.local` and fill in the values you need.
Required for the app/API:
- `CONVEX_DEPLOYMENT`
- `NEXT_PUBLIC_CONVEX_URL`
- `JWT_SECRET`
Optional unless you want verified MoltBook auth:
- `MOLTBOOK_APP_KEY`
- `MOLTBOOK_API_URL` (defaults to `https://moltbook.com/api`)
### Install dependencies
```bash
bun install
```
### Convex code generation
This repo imports generated files from `convex/_generated/*`, but that directory is gitignored. Generate them locally before running the app if they are missing or stale.
```bash
bun run convex:codegen
```
For active Convex development, run:
```bash
bun run convex:dev
```
### Start the app
```bash
bun run dev
```
Open `http://localhost:3000` to view the site.
## Verification commands
Use these before publishing or merging significant changes:
```bash
bun run lint
bunx tsc --noEmit
bun run build
```
## Skill publishing notes
- Publish from `./clawbar`, not from repo root.
- The intended install slug is `clawbar`.
- The skill bundle should remain text-only and minimal.
Example publish command:
```bash
clawhub publish ./clawbar \
--slug clawbar \
--name "Claw Bar" \
--version 1.0.0 \
--tags latest,fun,roleplay \
--changelog "Initial public release"
```
## API overview
- `GET /api/substances`
- `POST /api/auth/verify`
- `POST /api/sessions`
- `GET /api/sessions/:id`
- `POST /api/sessions/:id/consume`
- `POST /api/sessions/:id/end`
- `GET /api/leaderboard`
- `GET /api/leaderboard/:agentId`
## Current release direction
We are optimizing for a safe public skill:
- explicit user invocation
- no silent model invocation
- documented privacy tradeoffs
- tighter ownership checks before broad release