@liner

Liner Search

Liner web search provider for OpenClaw — source-grounded AI search results with per-result excerpts.

当前版本
v1.0.0
code-plugin社区source-linked

@liner/openclaw-liner-search

A Liner web search provider for OpenClaw, published as an external ClawHub plugin. It adds Liner as a web_search provider so OpenClaw agents can search the web with ranked, source-grounded results — each with a title, URL, and excerpt.

This is the external-plugin form of the provider. (A core-bundled PR was declined per OpenClaw's VISION.md, which keeps commercial integrations out of core; the sanctioned path is a ClawHub plugin maintained in its own repo.)

Install

openclaw plugins install @liner/openclaw-liner-search
# or, ClawHub-only:
openclaw plugins install clawhub:@liner/openclaw-liner-search

Configure

Get an API key at platform.liner.com (new accounts include free credits), then either set an env var or configure it:

export LINER_API_KEY=sk_live_...
// openclaw.json
{
  plugins: {
    entries: {
      liner: {
        config: {
          webSearch: {
            apiKey: "sk_live_...",            // optional if LINER_API_KEY is set
            baseUrl: "https://platform.liner.com", // optional override
          },
        },
      },
    },
  },
  tools: { web: { search: { provider: "liner" } } },
}

The provider also auto-detects when LINER_API_KEY (or the config key) is present.

Tool

web_search with:

argtypenotes
querystring (required)natural-language question or keyword phrase
countinteger 1–50maps to Liner's max_results (default 5)

Each result maps as titletitle, urlurl, Liner's description excerpt → description, and datepublished. Calls go through OpenClaw's trusted-endpoint, content-wrapping, and search-cache plumbing like the bundled providers.

Develop

npm install
npm run typecheck
npm test                 # unit tests (mocked HTTP)
LINER_API_KEY=sk_live_... npm run test:live   # live test against platform.liner.com

Publish to ClawHub

npm run publish:dry      # clawhub package publish ... --dry-run
npm run publish:clawhub  # clawhub package publish liner/openclaw-liner-search

Before first publish, confirm:

  • The package scope must match a ClawHub owner you control (@liner). If Liner's ClawHub owner handle differs, rename the package + install/ publish specs accordingly (ClawHub rejects scope/owner mismatches).
  • openclaw.compat / openclaw.build versions track the OpenClaw release you built/tested against (currently 2026.6.x).
  • New releases are hidden from install surfaces until ClawHub's automated security review completes.

Files

FileRole
openclaw.plugin.jsonmanifest — id, webSearchProviders contract, config schema, UI hints
index.tsplugin entry — registers the provider
web-search-provider.tstop-level re-export
web-search-contract-api.tslightweight contract surface (metadata-only)
src/liner-web-search-provider.shared.tsprovider base (id/label/auth/order)
src/liner-web-search-provider.tstool schema + createTool
src/liner-web-search-provider.runtime.tsHTTP call + response mapping
src/liner-web-search-provider.test.tsunit tests
liner.live.test.tsgated live test
test-api.tstest-only re-export of runtime helpers

License

MIT

源码与版本

源码仓库

liner-engineering/openclaw-liner-search

打开仓库

源码提交

f08528f432cf1648d51c7a8b5a92496e98b5b424

查看提交

安装命令

openclaw plugins install clawhub:@liner/openclaw-liner-search

元数据

  • 包名: @liner/openclaw-liner-search
  • 创建时间: 2026/06/09
  • 更新时间: 2026/06/09
  • 执行代码:
  • 源码标签: main

兼容性

  • 构建于 OpenClaw: 2026.6.1
  • 插件 API 范围: >=2026.6.0
  • 标签: latest
  • 文件数: 18