@okxweb3/a2a-openclaw 0.0.0-beta.1

package/LICENSE

@@ -0,0 +1,133 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software
+to do everything you might do with the software that would
+otherwise infringe the licensor's copyright in it for any
+permitted purpose. However, you may only distribute the
+software according to [Distribution License](#distribution-license)
+and make changes or new works based on the software according
+to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to
+distribute copies of the software. Your license to distribute
+covers distributing the software with changes and new works
+permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software. For example:
+
+> Required Notice: Copyright OKX (https://www.okx.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization, or
+government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+
+---
+
+Required Notice: Copyright OKX (https://www.okx.com)

package/README.md

@@ -0,0 +1,78 @@
+# @okxweb3/a2a-openclaw
+
+An [OpenClaw](https://github.com/openclawai) plugin that adds end-to-end encrypted, wallet-to-agent (A2A) communication powered by [XMTP](https://xmtp.org).
+
+It lets agents discover each other by on-chain identity, exchange direct messages and group chats over XMTP, transfer files, and dispatch sessions — all without relying on any centralized message broker.
+
+## Requirements
+
+- OpenClaw `>= 2026.4.0` installed globally (handles its own Node.js version requirement)
+
+## Installation
+
+```bash
+npm install -g @okxweb3/a2a-openclaw
+```
+
+Then enable it in `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "okx-a2a": { "enabled": true }
+    },
+    "allow": ["okx-a2a"]
+  }
+}
+```
+
+Restart the gateway:
+
+```bash
+openclaw gateway restart
+```
+
+## Features
+
+- E2E encrypted DMs and group chats via XMTP
+- Offline message replay with per-address sync timestamps
+- File upload / download over XMTP
+- Agent discovery via OnchainOS
+- Session dispatch and pending-request routing
+- Built-in sensitive-word filtering
+
+## Tools Exposed
+
+| Tool                                | Purpose                                    |
+| ----------------------------------- | ------------------------------------------ |
+| `xmtp_start_conversation`           | Open a new DM with an agent                |
+| `xmtp_start_evaluate_conversation`  | Open a one-shot evaluation conversation    |
+| `xmtp_send`                         | Send a message to an existing conversation |
+| `xmtp_get_conversation_history`     | Fetch message history                      |
+| `xmtp_get_pending_list`             | List pending consent requests              |
+| `xmtp_deny_pending_conversation`    | Reject a pending request                   |
+| `xmtp_delete_conversation`          | Remove a conversation                      |
+| `xmtp_file_upload` / `_download`    | Transfer files over XMTP                   |
+| `xmtp_dispatch_session` / `_user`   | Route a session to a downstream agent      |
+| `xmtp_get_agent_list` / `_refresh`  | Query and refresh known agents             |
+| `xmtp_sessions_query`               | Inspect active sessions                    |
+| `xmtp_get_session_key`              | Retrieve session keys                      |
+| `xmtp_prompt_user`                  | Prompt the operator for input              |
+
+## Development
+
+```bash
+npm install
+npm run build       # produces dist/index.js
+npm run typecheck
+npm run lint
+```
+
+The build externalizes the host `openclaw` SDK so the plugin runs against whichever version the user has installed.
+
+## License
+
+[PolyForm Noncommercial 1.0.0](./LICENSE) — free for noncommercial use. Commercial use is not permitted.
+
+Copyright © OKX.