personalclaw-client
An async Python client for the PersonalClaw Gateway.
personalclaw-client is the small, dependency-light library that apps and
external tools use to talk to a running PersonalClaw gateway — send messages,
read status, resolve an app's data directory — without vendoring the core
package. It is versioned and published independently of the core gateway so a
tool can pin a stable client contract.
Install
pip install personalclaw-client
# or
uv pip install personalclaw-client
Usage
from personalclaw_client import PersonalClawClient
async with PersonalClawClient(app_name="my-app") as pc:
ok = await pc.ping()
status = await pc.get_status()
await pc.send_message("session-1", "hello")
Errors
Client calls raise PersonalClawError (with a machine-readable ErrorCode) on
gateway/transport failures — catch it to distinguish "gateway unreachable" from
"bad request".
Links
- Homepage: https://personalclaw.dev
- Source & issues: https://github.com/PersonalClaw/PersonalClaw
- License: MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file personalclaw_client-0.1.0.tar.gz.
File metadata
- Download URL: personalclaw_client-0.1.0.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5f5462a3af25263038084b75362a9e91973f42f4c6f9006d965b77aea62e0661
|
|
| MD5 |
3fce75349a0f77a3c0e6c5d0cf794673
|
|
| BLAKE2b-256 |
6a2f8944ce42ff51f34c7ca74211afa6d10f30f7c331f1828a4fc2c9e185328b
|
Provenance
The following attestation bundles were made for personalclaw_client-0.1.0.tar.gz:
Publisher:
release.yml on PersonalClaw/PersonalClaw
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
personalclaw_client-0.1.0.tar.gz -
Subject digest:
5f5462a3af25263038084b75362a9e91973f42f4c6f9006d965b77aea62e0661 - Sigstore transparency entry: 2216099411
- Sigstore integration time:
-
Permalink:
PersonalClaw/PersonalClaw@d8b0e2e1e4b7d21a0158fff537594eef5ca1460c -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/PersonalClaw
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d8b0e2e1e4b7d21a0158fff537594eef5ca1460c -
Trigger Event:
push
-
Statement type:
File details
Details for the file personalclaw_client-0.1.0-py3-none-any.whl.
File metadata
- Download URL: personalclaw_client-0.1.0-py3-none-any.whl
- Upload date:
- Size: 8.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e363d49788c09490eadf40cb6b9dd706553f8ce4bfbb33730931c7782a1388bb
|
|
| MD5 |
7cb110c41b26d3927fad4803d3bfcca6
|
|
| BLAKE2b-256 |
535bfe4bc8018c6bddecbc49a55753c878fbdb1b45b1770959a64844deb2c1cf
|
Provenance
The following attestation bundles were made for personalclaw_client-0.1.0-py3-none-any.whl:
Publisher:
release.yml on PersonalClaw/PersonalClaw
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
personalclaw_client-0.1.0-py3-none-any.whl -
Subject digest:
e363d49788c09490eadf40cb6b9dd706553f8ce4bfbb33730931c7782a1388bb - Sigstore transparency entry: 2216099440
- Sigstore integration time:
-
Permalink:
PersonalClaw/PersonalClaw@d8b0e2e1e4b7d21a0158fff537594eef5ca1460c -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/PersonalClaw
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d8b0e2e1e4b7d21a0158fff537594eef5ca1460c -
Trigger Event:
push
-
Statement type:
