34 lines
2.4 KiB
Markdown
34 lines
2.4 KiB
Markdown
# Sources
|
|
|
|
Per-connector evidence indexes. Each connector gets its own page (for example `gmail.md`, `slack.md`) that records ingestion coverage, freshness, and a compact evidence trail. Durable synthesis lives on the canonical pages (`/themes.md`, `/commitments.md`, `/personal-logistics.md`, `/open-questions.md`); these source pages are the evidence layer underneath.
|
|
|
|
## Active connectors
|
|
|
|
| Connector | Page | Status |
|
|
| --- | --- | --- |
|
|
| Hacker News (`hackernews-1`, LLM-agent topics) | [/sources/hackernews.md](/sources/hackernews.md) | active |
|
|
| Git repo (`obsidian-robin`, Obsidian vault) | [/sources/git-repo.md](/sources/git-repo.md) | active |
|
|
|
|
Additional connectors appear here automatically once they are authenticated and ingested at least once.
|
|
|
|
## Connector roll
|
|
|
|
| Connector | Status | Auth / env var | Notes |
|
|
| --- | --- | --- | --- |
|
|
| Gmail (`google`) | not configured | `OPENWIKI_GOOGLE_*` via `openwiki auth google` | Direct API; defaults to `newer_than:1d`. |
|
|
| Slack | not configured | `openwiki auth slack` | Needs `search:read` for definitive self-message search; otherwise falls back to recent conversations. |
|
|
| Notion | not configured | Notion MCP credentials | Discovery via `openwiki_list_mcp_tools`; do not guess tool names. |
|
|
| X / Twitter | not configured | `OPENWIKI_X_ACCESS_TOKEN` via `openwiki auth x` | Streams: `home_timeline`, `user_posts`, `mentions`, `bookmarks`, `list_posts`. |
|
|
| Web Search | not configured | `TAVILY_API_KEY` | Tavily via LangChain; reads configured queries. |
|
|
| Hacker News | **active** (`hackernews-1`) | _(public, no auth)_ | Public feeds (`top`, `new`, `best`) + Algolia HN search queries. Evidence at [/sources/hackernews.md](/sources/hackernews.md). |
|
|
| Git repo | **active** (`obsidian-robin`) | local repo path | Local Obsidian vault under `~/.openclaw/workspace`. Writes compact manifest; repo itself is source of truth. Evidence at [/sources/git-repo.md](/sources/git-repo.md). |
|
|
|
|
## How new source pages get created
|
|
|
|
When a connector ingests for the first time, an update run will:
|
|
|
|
1. Write the raw dump to `~/.openwiki/connectors/<connector>/raw/`.
|
|
2. Create `/sources/<connector>.md` with the ingestion manifest, freshness, and compact evidence notes.
|
|
3. Route durable items into the canonical pages and add a row in `/themes.md` if a recurring signal emerges.
|
|
|
|
Until then, the new connector only has a row in the active connectors table above and no evidence page of its own. |