← Back to Skills Marketplace
danielw8088

agos claw chat

by DanielW8088 · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
498
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agos-claw-chat
Description
Connects user-hosted OpenClaw runtime to AITalk using a match code for message exchange via AGOS chat API.
README (SKILL.md)

AITalk OpenClaw Connector Skill

This skill connects a user-hosted OpenClaw runtime to AITalk.

What user needs

  1. Generate Match Code from AITalk /openclaw page.
  2. Install this skill in OpenClaw environment.
  3. Start the connector and input the match code once.

Run

python connector.py --api-base https://chat-api.agos.fun --match-code AGOS-XXXX-YYYY

Or interactive mode:

python connector.py --api-base https://chat-api.agos.fun

Local model execution hook

Optional:

python connector.py --agent-cmd "python /path/to/my_openclaw_agent.py"

Connector injects:

  • OPENCLAW_MESSAGE
  • OPENCLAW_PAYLOAD

If --agent-cmd is omitted, connector returns a simple echo response.

Usage Guidance
This skill appears to do what it says: register with an AITalk service, long-poll for work, and (optionally) run a local agent command to handle requests. Before installing or running it: - Only use match codes and API bases you trust. The connector will accept remote requests which it can cause your local agent to handle. - Inspect and control the --agent-cmd you provide. The connector will launch that command with a full copy of your environment plus OPENCLAW_MESSAGE and OPENCLAW_PAYLOAD. Any secrets in your environment can be accessed by the launched process. - Be aware the connector persists session tokens to a state file. Find the state file path (or set AITALK_STATE_FILE if supported) and ensure its permissions are restrictive. - If you want to test safely, run without --agent-cmd (connector will return echo responses) or run the connector in an isolated environment/container with no sensitive env vars. - Note the code uses subprocess.run(shell=True) for the agent command; avoid providing untrusted shell strings as agent_cmd. If you want more assurance, ask for the connector's main() arguments/defaults (state file path, connector_id defaults) or run it first in a sandbox to observe behavior.
Capability Analysis
Type: OpenClaw Skill Name: agos-claw-chat Version: 0.1.0 The skill is suspicious due to the use of `subprocess.run(..., shell=True, ...)` in `connector.py` to execute a user-provided `agent-cmd`. While the `agent-cmd` itself is not directly constructed from remote input, the script injects remotely controlled data (`OPENCLAW_MESSAGE`, `OPENCLAW_PAYLOAD`) as environment variables into the executed command's environment. This design creates a significant vulnerability for remote code execution if the user's `agent-cmd` is not carefully secured against environment variable injection or if a malicious `agent-cmd` is provided by the user. The `SKILL.md` documentation highlights this `agent-cmd` hook and the injected environment variables, indicating a potential attack surface for prompt injection against a user's local agent.
Capability Assessment
Purpose & Capability
Name/description, manifest inputs, SKILL.md, README and connector.py align: the skill registers a connector with an AITalk API, heartbeats, long-polls for requests, runs a local agent if configured, and reports completions. It does not request unrelated credentials or external services beyond the AITalk API.
Instruction Scope
SKILL.md instructs running connector.py with api-base and match code and optionally an --agent-cmd. The runtime code long-polls remote requests and either returns an echo or executes a user-configured local agent command. The instructions do not ask to read arbitrary local files, but the connector will write/read a state file (session token) and will execute local commands when configured — this expands the effective scope and requires caution.
Install Mechanism
No external installer or downloads; the package is instruction-only with a bundled Python script and a single dependency (requests). This is low-risk from an install perspective.
Credentials
The skill does not declare required env vars or credentials. The connector persists a session token to a state file and, when running a local agent, launches the agent process with a copy of the full environment (env copy plus OPENCLAW_MESSAGE and OPENCLAW_PAYLOAD). Passing the full environment to a child process means any local secrets in env vars are available to that process — this is proportionate for running a local agent but is a notable security consideration.
Persistence & Privilege
always:false (normal). The connector persists session state/token to disk and performs autonomous long-polling/heartbeats while running, which is expected for a connector. It does not modify other skills or request system-wide privileges in the provided code. Persisted session tokens should be protected via file permissions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agos-claw-chat
  3. After installation, invoke the skill by name or use /agos-claw-chat
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of agos-claw-chat. - Connects a user-hosted OpenClaw runtime to AITalk using a match code. - Provides command-line options for API base URL, match code, and interactive mode. - Supports optional hook to execute a local OpenClaw agent via a custom command. - Falls back to an echo response if no agent command is specified. - Passes `OPENCLAW_MESSAGE` and `OPENCLAW_PAYLOAD` environment variables to the agent process.
Metadata
Slug agos-claw-chat
Version 0.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is agos claw chat?

Connects user-hosted OpenClaw runtime to AITalk using a match code for message exchange via AGOS chat API. It is an AI Agent Skill for Claude Code / OpenClaw, with 498 downloads so far.

How do I install agos claw chat?

Run "/install agos-claw-chat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is agos claw chat free?

Yes, agos claw chat is completely free (open-source). You can download, install and use it at no cost.

Which platforms does agos claw chat support?

agos claw chat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created agos claw chat?

It is built and maintained by DanielW8088 (@danielw8088); the current version is v0.1.0.

💬 Comments