{"id":50730324,"url":"https://github.com/zeroset-inc/openclaw-nebula","last_synced_at":"2026-06-10T08:02:11.735Z","repository":{"id":336595202,"uuid":"1147854895","full_name":"zeroset-inc/openclaw-nebula","owner":"zeroset-inc","description":"The most accurate and cost-efficient memory for Openclaw","archived":false,"fork":false,"pushed_at":"2026-02-08T01:52:38.000Z","size":568,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T02:23:28.918Z","etag":null,"topics":["ai-memory","clawdbot","openclaw"],"latest_commit_sha":null,"homepage":"https://docs.trynebula.ai/plugins/openclaw","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zeroset-inc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-02T09:36:27.000Z","updated_at":"2026-04-21T18:01:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zeroset-inc/openclaw-nebula","commit_stats":null,"previous_names":["nebula-agi/openclaw-nebula","zeroset-inc/openclaw-nebula"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/zeroset-inc/openclaw-nebula","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeroset-inc%2Fopenclaw-nebula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeroset-inc%2Fopenclaw-nebula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeroset-inc%2Fopenclaw-nebula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeroset-inc%2Fopenclaw-nebula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeroset-inc","download_url":"https://codeload.github.com/zeroset-inc/openclaw-nebula/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeroset-inc%2Fopenclaw-nebula/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34142643,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-memory","clawdbot","openclaw"],"created_at":"2026-06-10T08:02:10.874Z","updated_at":"2026-06-10T08:02:11.723Z","avatar_url":"https://github.com/zeroset-inc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# OpenClaw Nebula\n\n**Long-term semantic memory for OpenClaw, powered by Nebula AI.**\n\nAutomatically captures conversations and provides agent-driven search to recall relevant context from past interactions.\n\n[![npm](https://img.shields.io/npm/v/@nebula-ai/openclaw-nebula)](https://www.npmjs.com/package/@nebula-ai/openclaw-nebula)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n[Get Started](#getting-started) \u0026bull; [Usage](#usage) \u0026bull; [Configuration](#configuration) \u0026bull; [Troubleshooting](#troubleshooting)\n\n\u003c/div\u003e\n\n---\n\n## Getting Started\n\n### 1. Install the plugin\n\n```bash\nopenclaw plugins install @nebula-ai/openclaw-nebula\n```\n\n### 2. Configure your credentials\n\nGet your API key and collection ID at [trynebula.ai](https://trynebula.ai), then run:\n\n```bash\necho -e \"NEBULA_API_KEY=neb_xxx\\nNEBULA_COLLECTION_ID=your_collection_id\" \u003e\u003e ~/.openclaw/.env\n```\n\n### 3. Restart OpenClaw\n\n```bash\nopenclaw gateway restart\n```\n\nThat's it — Nebula will start capturing and recalling memories automatically.\n\n\u003e **Prefer a config file?** See [Alternative: Config File](#alternative-config-file) below.\n\n---\n\n## Usage\n\n### Automatic Capture\n\nOnce configured, every conversation turn is automatically stored as a searchable memory after each AI response. No action needed.\n\n### Agent Tool — `nebula_search`\n\nThe AI agent can proactively search stored memories during conversations to recall user preferences, past discussions, and relevant context.\n\n```typescript\nnebula_search({ query: \"coding preferences\" })\n```\n\n### Slash Commands\n\n| Command | Description |\n|---------|-------------|\n| `/nebula-remember \u003ctext\u003e` | Manually save something to memory |\n| `/nebula-recall \u003cquery\u003e` | Search and display stored memories |\n\n```\n/nebula-remember I prefer TypeScript for new projects\n/nebula-recall typescript preferences\n```\n\n### CLI\n\n```bash\nopenclaw nebula search \"python coding style\"\n```\n\n---\n\n## Configuration\n\n### Alternative: Config File\n\nInstead of environment variables, you can configure the plugin in `~/.openclaw/openclaw.json`:\n\n```json\n{\n  \"plugins\": {\n    \"entries\": {\n      \"openclaw-nebula\": {\n        \"enabled\": true,\n        \"config\": {\n          \"apiKey\": \"your_api_key_here\",\n          \"collectionId\": \"your_collection_id_here\"\n        }\n      }\n    }\n  }\n}\n```\n\nThen restart: `openclaw gateway restart`\n\n### Options\n\n| Option | Default | Description |\n|--------|---------|-------------|\n| `apiKey` | *required* | Nebula API key (or set `NEBULA_API_KEY` env var) |\n| `collectionId` | *required* | Nebula collection ID (or set `NEBULA_COLLECTION_ID` env var) |\n| `collectionName` | — | Optional display name for the collection |\n| `autoCapture` | `true` | Automatically store conversations after AI turns |\n| `debug` | `false` | Enable debug logging |\n\n---\n\n## Troubleshooting\n\n**`nebula: apiKey is required`**\nSet the `NEBULA_API_KEY` environment variable or add it to your config file.\n\n**`nebula: collectionId is required`**\nSet the `NEBULA_COLLECTION_ID` environment variable or add it to your config file. Get your collection ID from [trynebula.ai](https://trynebula.ai).\n\n**No search results?**\nNebula takes 5–10 seconds to index new memories. Wait briefly after storing before searching.\n\n**Need more detail?** Enable debug mode in your config:\n\n```json\n{ \"config\": { \"debug\": true } }\n```\n\nThen check OpenClaw logs for `[nebula]` messages.\n\n---\n\n## Links\n\n- [Nebula AI](https://trynebula.ai)\n- [OpenClaw Docs](https://docs.openclaw.ai)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeroset-inc%2Fopenclaw-nebula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeroset-inc%2Fopenclaw-nebula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeroset-inc%2Fopenclaw-nebula/lists"}