You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 27, 2026. It is now read-only.
Adds a "Convos Group Chat" section to the AGENTS.md workspace template, establishing that agents are bound to exactly one Convos conversation with isolated context, and should use the /convos-cli skill proactively
Wires up the convos-cli skill from @convos/cli via the plugin manifest (openclaw.plugin.json)
Adds postinstall shim to make the convos binary available on PATH for agent shell commands
Details
AGENTS.md template — new section explains:
1:1 binding (one agent instance per Convos conversation)
Context isolation (no cross-conversation knowledge)
Encourages proactive use of Convos capabilities to serve the group
Plugin manifest — adds "skills": ["./skills", "./node_modules/@convos/cli/skills"] so both the local convos-channel skill and the convos-cli skill from the npm package are loaded into the workspace.
postinstall shim — creates a convos binary in the root .bin/ that proxies to the extension's nested @convos/cli binary, since the package is installed from GitHub (not npm) and nested deps don't get hoisted.
Test plan
Run openclaw setup on a fresh workspace and verify AGENTS.md contains the Convos section
Verify convos-cli appears in the agent's available skills list
Verify convos binary is accessible from the project root after pnpm install
Replace in-process XMTP SDK with ConvosInstance CLI integration and add agent identity context across the Convos channel, HTTP routes, and skills
Switch the Convos extension to a single-process ConvosInstance that shells out to the convos CLI, replace private key handling with identityId, and rewrite setup, onboarding, channel, actions, and HTTP routes to operate on one bound conversation with process-wide instance state and optional bearer auth. Key entry points include index.ts, sdk-client.ts, and channel.ts.
📍Where to Start
Start with the HTTP route and setup flow in index.ts, then review the CLI wrapper ConvosInstance in sdk-client.ts to understand process binding and streaming.
Add agent identity context for Convos group chat and declare Convos CLI skills in openclaw.plugin.json with a postinstall shim in package.json
Add a Convos group chat agent context to AGENTS.md, declare skills paths in openclaw.plugin.json, and add a postinstall script in package.json that writes a convos CLI shim.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Labels
None yet
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/convos-cliskill proactivelyconvos-cliskill from@convos/clivia the plugin manifest (openclaw.plugin.json)convosbinary available on PATH for agent shell commandsDetails
AGENTS.md template — new section explains:
Plugin manifest — adds
"skills": ["./skills", "./node_modules/@convos/cli/skills"]so both the localconvos-channelskill and theconvos-cliskill from the npm package are loaded into the workspace.postinstall shim — creates a
convosbinary in the root.bin/that proxies to the extension's nested@convos/clibinary, since the package is installed from GitHub (not npm) and nested deps don't get hoisted.Test plan
openclaw setupon a fresh workspace and verify AGENTS.md contains the Convos sectionconvos-cliappears in the agent's available skills listconvosbinary is accessible from the project root afterpnpm install🤖 Generated with Claude Code