Skip to content

Personal agents

The @telemai/openclaw-plugin package adds web search and page reading to OpenClaw. While it is enabled, it blocks OpenClaw’s built-in web_search and web_fetch and sends the agent to the Telem tools.

OpenClaw 2026.7.1 or newer. The installer checks the version. For the installer, Node.js 20 or later; it checks for it and offers to install it.

Create a Telem API key

  1. Open your project
  2. API keys
  3. Issue API key

tlm_••••••••••••••••Keys start with tlm_.

Open the console

Never paste a key into a chat with OpenClaw. Every path below sets it for you.

Connect OpenClaw to Telem

  1. Run the installer in your terminal. If it shows a menu, pick OpenClaw. Paste your key when the installer asks. The field is masked, and the key never appears on screen. The installer also allows telem_search and telem_fetch in OpenClaw’s tool policy.

    Terminal window
    curl -fsSL https://docs.telem.ai/install.sh | sh
  2. Restart the Gateway. OpenClaw loads the plugin and reads the key when the Gateway starts.

    Terminal window
    openclaw gateway restart
  3. Check the install. The output lists telem_search and telem_fetch.

    Terminal window
    openclaw plugins inspect telem --runtime --json
Install with no prompts, for example in CI
Terminal window
curl -fsSL https://docs.telem.ai/install.sh | sh -s -- --yes --client openclaw --key-env TELEM_API_KEY

Search and read

2 tools
  • telem_search Searches the web on several providers in one call.
  • telem_fetch Reads the full text of up to 5 pages.
  • Options go in the plugin config, not in .telem/telem.json. The plugin reads plugins.entries.telem.config, then the TELEM_* variables. TELEM_AUTO_ROUTING wins over both. It does not read .telem/telem.json.
  • Your key can go in the plugin config too, as apiKey. There it wins over TELEM_API_KEY and ~/.telem/credentials.json.
  • Only the built-in web_search and web_fetch are blocked, by those exact names, while the plugin is enabled. Other search tools stay. Disable or remove the plugin, and the built-in tools come back, with nothing to undo.

To update, run the installer again, or:

Terminal window
openclaw plugins update telem

To remove the plugin:

Terminal window
openclaw plugins uninstall telem

Restart the Gateway after you update or remove.

What the installer changed outside the plugin
Where What it holds To undo
~/.telem/credentials.json Your key Delete it if no other Telem integration uses it.
~/.telem/telem.json Your Telem options Delete it if no other Telem integration uses it.
tools.alsoAllow in OpenClaw’s config telem_search and telem_fetch Remove only those two entries, and keep the others.
Configuration

Set the tier, the providers and auto-routing in OpenClaw's plugin config.

Parameters

Every option, the values it takes, and which setting wins.

Search parameters

What each search option does, from tiers to date windows.

Fetch parameters

Choose the fetch provider and tier, or read pages live.

Was this page helpful?