@adaptiqai/openclaw 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,92 @@
1
- # Temporary Holding Version
1
+ # AdaptiqAI for OpenClaw
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Your AdaptiqAI workspace in [OpenClaw](https://openclaw.ai): its models,
4
+ conversations that AdaptiqAI remembers, and your saved knowledge, in one
5
+ OpenClaw plugin.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ openclaw plugins install @adaptiqai/openclaw
11
+ openclaw gateway restart
12
+ ```
13
+
14
+ Then sign in, in a terminal:
15
+
16
+ ```bash
17
+ openclaw models auth login --provider adaptiq
18
+ ```
19
+
20
+ OpenClaw shows a link and a code; you sign in (or create an account) in your
21
+ browser and approve, and OpenClaw picks it up by itself. Without a browser,
22
+ give a key from the AdaptiqAI console instead:
23
+ `openclaw models auth paste-api-key --provider adaptiq`, or `ADAPTIQAI_API_KEY`.
24
+ A setup made by the console's Connect to app keeps working as it is.
25
+
26
+ Choose a model of the **AdaptiqAI** provider (`openclaw models set adaptiq/<id>`).
27
+ The list is the models in your workspace, each with its own context
28
+ window, output limit and thinking levels.
29
+
30
+ ## What it does
31
+
32
+ - **A conversation is one AdaptiqAI session.** Every turn carries OpenClaw's
33
+ session id as `x-adaptiq-session-id`, so AdaptiqAI keeps the conversation's
34
+ memory, and the collections and conversations you attach to it in the
35
+ console reach the model. `/new` starts a new one.
36
+ - **No compaction.** AdaptiqAI keeps the whole conversation in native memory,
37
+ so OpenClaw's compaction is declined for AdaptiqAI models: nothing is sent,
38
+ nothing is removed, and OpenClaw keeps the conversation as it is. Other
39
+ models compact as before.
40
+ - **Helper calls leave nothing.** Titles and other one-off completions run
41
+ once, marked ephemeral, and never become a conversation. A heartbeat run
42
+ reads its conversation back, the memory and the knowledge attached to it,
43
+ and saves nothing; in a conversation AdaptiqAI doesn't store yet it runs
44
+ once. Cron and memory-flush runs look like turns to a provider; to keep
45
+ them out as well, let the plugin see each run's trigger:
46
+
47
+ ```bash
48
+ openclaw config set plugins.entries.adaptiq.hooks.allowConversationAccess true
49
+ ```
50
+
51
+ The plugin reads only the trigger.
52
+ - **A subagent names the session that started it**, so the console folds it
53
+ under that conversation: as a helper for a one-off task (`mode: "run"`), as
54
+ its own line of work for a persistent one (`mode: "session"`).
55
+ - **Tools for the agent:** `adaptiq_knowledge` (what this conversation uses;
56
+ search, use or stop a collection), `adaptiq_memory` (how full the memory is;
57
+ the saved collections; keep a conversation private) and
58
+ `adaptiq_create_knowledge` (save material as a collection, only when you ask).
59
+ Where `commands.ownerAllowFrom` names the owners, only their messages save
60
+ knowledge (in a group, other members' do not), and an agent kept to its
61
+ workspace (a sandbox, or `tools.fs.workspaceOnly`) saves only files inside
62
+ it.
63
+ - **`/adaptiq`** shows the workspace, its models and this conversation.
64
+ `/adaptiq private` stops saving new messages of this conversation,
65
+ `/adaptiq remember` starts again, `/adaptiq console` gives the console's link
66
+ for it, and `/adaptiq logout` signs this computer out.
67
+
68
+ ## Configuration
69
+
70
+ | Variable | Default |
71
+ |---|---|
72
+ | `ADAPTIQAI_API_KEY` | none: the browser sign-in |
73
+ | `ADAPTIQAI_API_BASE` | `https://api.adaptiqai.com` |
74
+ | `ADAPTIQAI_CONSOLE_URL` | `https://memory.adaptiqai.com/memory` |
75
+
76
+ The sign-in, the plugin's state, the last model list and the subagents
77
+ spawned as sessions of their own are kept in `~/.openclaw/adaptiqai/`
78
+ (OpenClaw's state folder), readable by you alone.
79
+ OpenClaw's auth profile `adaptiq:device` holds only a stand-in: the plugin
80
+ swaps it for the current access token on every run that goes to
81
+ `ADAPTIQAI_API_BASE`. A provider pointed at another address gets no token.
82
+
83
+ ## Development
84
+
85
+ ```bash
86
+ pnpm install
87
+ pnpm --filter @adaptiqai/openclaw run build
88
+ pnpm --filter @adaptiqai/openclaw run test
89
+ openclaw plugins install --link ./packages/openclaw --force # try it in your own OpenClaw
90
+ ```
91
+
92
+ Tested against OpenClaw 2026.9.2.