---
type: "Reference"
title: "Sources"
openwiki_generated: true
---

# 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.