elizaos--eliza
wehub-resource-sync
426e9eeabd
Voice Workbench / headless workbench (mocked backends) (push) Has been cancelled
Voice Workbench / real acoustic lane (nightly, provisioned only) (push) Has been cancelled
ci / test (push) Has been cancelled
ci / lint-and-format (push) Has been cancelled
ci / build (push) Has been cancelled
ci / dev-startup (push) Has been cancelled
gitleaks / gitleaks (push) Has been cancelled
Markdown Links / Relative Markdown Links (push) Has been cancelled
Quality (Extended) / Homepage Build (PR smoke) (push) Has been cancelled
Quality (Extended) / Comment-only diff guard (push) Has been cancelled
Quality (Extended) / Format + Type Safety Ratchet (push) Has been cancelled
Quality (Extended) / Develop Gate (secret scan + UI determinism) (push) Has been cancelled
Quality (Extended) / Develop Gate (lint) (push) Has been cancelled
Chat shell gestures / Chat shell gesture + parity e2e (push) Has been cancelled
Cloud Gateway Discord / Test (push) Has been cancelled
Benchmark Bridge Tests / benchmark (bunx @biomejs/biome check packages/lifeops-bench/src, benchmark-lint) (push) Has been cancelled
Benchmark Bridge Tests / benchmark (bunx vitest run --config packages/lifeops-bench/vitest.config.ts --root packages/lifeops-bench --passWithNoTests, benchmark-tests) (push) Has been cancelled
Build Agent Image / build-and-push (push) Has been cancelled
Dev Smoke / bun run dev onboarding chat (push) Has been cancelled
Dev Smoke / Vite HMR dependency-level smoke (push) Has been cancelled
Electrobun Submodule Guard / electrobun gitlink is fetchable (push) Has been cancelled
Publish @elizaos/example-code / check_npm (push) Has been cancelled
Publish @elizaos/example-code / publish_npm (push) Has been cancelled
Publish @elizaos/plugin-elizacloud / verify_version (push) Has been cancelled
Publish @elizaos/plugin-elizacloud / publish_npm (push) Has been cancelled
Sandbox Live Smoke / Sandbox live smoke (push) Has been cancelled
Snap Build & Test / Build Snap (amd64) (push) Has been cancelled
Snap Build & Test / Build Snap (arm64) (push) Has been cancelled
Test Packaging / elizaos CLI global-install smoke (node + bun) (push) Has been cancelled
Cloud Gateway Webhook / Test (push) Has been cancelled
Cloud Tests / lint-and-types (push) Has been cancelled
Cloud Tests / unit-tests (push) Has been cancelled
Cloud Tests / integration-tests (push) Has been cancelled
Cloud Tests / e2e-tests (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
Deploy Apps Worker (Product 2) / Determine environment (push) Has been cancelled
Deploy Apps Worker (Product 2) / Deploy apps worker to apps-control host (${{ needs.determine-env.outputs.environment }}) (push) Has been cancelled
Deploy Eliza Provisioning Worker / Determine environment (push) Has been cancelled
Deploy Eliza Provisioning Worker / Deploy worker to Hetzner host (${{ needs.determine-env.outputs.environment }} @ ${{ needs.determine-env.outputs.deployment_sha }}) (push) Has been cancelled
Dev Smoke / Classify changed paths (push) Has been cancelled
supply-chain / sbom (push) Has been cancelled
supply-chain / vulnerability-scan (push) Has been cancelled
Build, Push & Deploy to Phala Cloud / build-and-push (push) Has been cancelled
Test Packaging / Validate Packaging Configs (push) Has been cancelled
Test Packaging / Build & Test PyPI Package (push) Has been cancelled
Test Packaging / PyPI on Python ${{ matrix.python }} (push) Has been cancelled
Test Packaging / Pack & Test JS Tarballs (push) Has been cancelled
UI Fixture E2E / ui-fixture-e2e (push) Has been cancelled
UI Fixture E2E / fixture-e2e (push) Has been cancelled
UI Story Gate / story-gate (push) Has been cancelled
vault-ci / test (macos-latest) (push) Has been cancelled
vault-ci / test (ubuntu-latest) (push) Has been cancelled
vault-ci / test (windows-latest) (push) Has been cancelled
vault-ci / app-core wiring tests (push) Has been cancelled
verify-patches / verify patches/CHECKSUMS.sha256 (push) Has been cancelled
Voice Benchmark Smoke / voice-emotion fixture smoke (push) Has been cancelled
Voice Benchmark Smoke / voiceagentbench fixture smoke (push) Has been cancelled
Voice Benchmark Smoke / voicebench-quality unit smoke (push) Has been cancelled
Voice Benchmark Smoke / voicebench TypeScript unit (no audio) (push) Has been cancelled
Voice Benchmark Smoke / voice bench smoke summary (push) Has been cancelled
Windows CI / windows ([bun run --cwd packages/app-core test bun run --cwd packages/elizaos test bun run --cwd packages/cloud/shared test], app-and-cli) (push) Has been cancelled
Windows CI / windows ([bun run --cwd packages/scenario-runner test bun run --cwd packages/vault test bun run --cwd packages/security test bun run --cwd plugins/plugin-coding-tools test], framework-packages) (push) Has been cancelled
Windows CI / windows ([bun run --cwd plugins/plugin-elizacloud test bun run --cwd plugins/plugin-discord test bun run --cwd plugins/plugin-anthropic test bun run --cwd plugins/plugin-openai test bun run --cwd plugins/plugin-app-control test bun run --cwd plugins/pl… (push) Has been cancelled
Windows CI / windows ([node packages/scripts/run-turbo.mjs run build --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/agent --concurrency=4 node packages/scripts/run-bash-linux-only.mjs scripts/verify-riscv64-buildpaths.sh node packages/scripts/run… (push) Has been cancelled
Windows CI / windows ([node packages/scripts/run-turbo.mjs run typecheck --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/cloud-shared --concurrency=4 bun run --cwd packages/core test bun run --cwd packages/shared test], core-runtime, 75) (push) Has been cancelled
50 行
2.1 KiB
Markdown
50 行
2.1 KiB
Markdown
# @elizaos/plugin-birdclaw
|
|
|
|
[Birdclaw](https://birdclaw.sh) local-first Twitter/X memory for elizaOS.
|
|
|
|
Birdclaw keeps a private archive of your Twitter/X life — timeline, mentions,
|
|
DMs, likes, bookmarks — in a single SQLite database on your machine, imported
|
|
from your Twitter archive and optionally kept fresh with live syncs. This
|
|
plugin connects that archive to your Eliza agent:
|
|
|
|
- **Birdclaw app** in the launcher — browse Timeline / Mentions / Posted /
|
|
Likes / Bookmarks / Inbox, trigger live syncs, see who still needs a reply.
|
|
One spatial component renders the shipped GUI view.
|
|
- **`BIRDCLAW` agent action** — ask your agent things like *"search my tweets
|
|
for that thread about sync engines"*, *"which mentions still need a reply?"*,
|
|
*"pull my latest bookmarks"*, or *"what happened on Twitter today?"*
|
|
(digest). Owner-only: this is your private archive.
|
|
- **`/api/birdclaw/*` routes** — status, tweets, inbox, sync, digest; the view
|
|
and any other client drive these.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
brew install steipete/tap/birdclaw # or build from source (Node 26)
|
|
birdclaw init # create ~/.birdclaw + seed the demo data
|
|
birdclaw import archive <path> # import your Twitter archive
|
|
```
|
|
|
|
That's it — the agent auto-loads the plugin when it finds the `birdclaw`
|
|
binary (or an existing `~/.birdclaw`). No config required. Without birdclaw
|
|
installed the app shows a setup screen and the agent action stays dormant.
|
|
|
|
Optional knobs: `BIRDCLAW_BIN` (explicit binary path), `BIRDCLAW_HOME`
|
|
(alternate data root), `BIRDCLAW_OPENAI_API_KEY` (enables birdclaw's AI
|
|
digest/scoring), `ELIZA_BIRDCLAW=1/0` (force on/off).
|
|
|
|
Live sync needs one of birdclaw's transports (`xurl` OAuth2 or `bird` browser
|
|
cookies) — see the [birdclaw docs](https://github.com/steipete/birdclaw).
|
|
Everything else (browse, search, inbox, digest) works on the local archive
|
|
alone.
|
|
|
|
## Development
|
|
|
|
```bash
|
|
bun run --cwd plugins/plugin-birdclaw test # offline unit suite
|
|
bun run --cwd plugins/plugin-birdclaw test:real # against the real CLI
|
|
bun run --cwd plugins/plugin-birdclaw build
|
|
```
|
|
|
|
See [CLAUDE.md](./CLAUDE.md) for the full surface, layout, and gotchas.
|