Segment

Segment — manage sources, destinations, events, and tracking plans via Config & Tracking APIs

Security Scan

The skill's code and runtime instructions match its stated purpose (managing Segment resources and sending events); requirements and behavior are proportionate with a few small, explainable inconsistencies to be aware of.

Purpose & Capability

Name/description match the included CLI script which calls Segment Config & Tracking APIs. Requested credentials (SEGMENT_ACCESS_TOKEN and SEGMENT_WRITE_KEY) are plausible for Segment usage.

Instruction Scope

SKILL.md tells the agent to run the included Python CLI. The CLI only performs HTTP calls to api.segmentapis.com and prints JSON (or human-readable output). It also attempts to read environment variables and falls back to a .env file in WORKSPACE or ~/.openclaw/workspace which is within expected scope but worth noting because it reads a file on disk to locate credentials.

Install Mechanism

No install spec; this is instruction-only with an included Python script that uses only the stdlib. Nothing is downloaded or written to disk by an installer.

Credentials

The skill requires SEGMENT_ACCESS_TOKEN (used as the Bearer auth header) and SEGMENT_WRITE_KEY (declared but not actually referenced by the script). The script also reads the WORKSPACE env var (undocumented in SKILL.md) to locate a fallback .env file. Reading .env to obtain only the declared variables is expected, but you should be aware it will inspect that file to find credentials.

Persistence & Privilege

always is false and the skill does not modify other skills or agent-wide settings. It does not request permanent elevated privileges.

Assessment

This skill appears to do what it claims: it runs a local Python CLI that calls Segment's APIs at https://api.segmentapis.com. Before installing, note: (1) you must provide SEGMENT_ACCESS_TOKEN (used by the script) and SEGMENT_WRITE_KEY (declared but not referenced by the script) — only give tokens with the minimal necessary permissions; (2) the script will look for credentials in a .env file under WORKSPACE or ~/.openclaw/workspace if the env vars are missing, so avoid storing broad secrets in that file if it's shared; (3) there are no remote installers or hidden endpoints. If you need the declared write key to actually be used, ask the author to clarify or update the script; otherwise the requests will be authenticated with the access token only.

Segment — manage sources, destinations, events, and tracking plans via Config & Tracking APIs

Requirements

Variable	Required	Description
SEGMENT_ACCESS_TOKEN	✅	Config API token
SEGMENT_WRITE_KEY	✅	Source write key

Quick Start

# List sources
python3 {{baseDir}}/scripts/segment.py sources

# Get source
python3 {{baseDir}}/scripts/segment.py source-get id <value>

# Create source
python3 {{baseDir}}/scripts/segment.py source-create --name <value> --catalog_name <value>

# Delete source
python3 {{baseDir}}/scripts/segment.py source-delete id <value>

# List destinations
python3 {{baseDir}}/scripts/segment.py destinations

# Get destination
python3 {{baseDir}}/scripts/segment.py destination-get id <value>

# List warehouses
python3 {{baseDir}}/scripts/segment.py warehouses

# List source catalog
python3 {{baseDir}}/scripts/segment.py catalog-sources

All Commands

Command	Description
sources	List sources
source-get	Get source
source-create	Create source
source-delete	Delete source
destinations	List destinations
destination-get	Get destination
warehouses	List warehouses
catalog-sources	List source catalog
catalog-destinations	List destination catalog
tracking-plans	List tracking plans
tracking-plan-get	Get tracking plan
spaces	List spaces
functions	List functions
track	Send track event
identify	Send identify

Output Format

All commands output JSON by default. Add --human for readable formatted output.

python3 {{baseDir}}/scripts/segment.py <command> --human

Script Reference

Script	Description
{{baseDir}}/scripts/segment.py	Main CLI — all commands in one tool

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation