# Send CitrineOS Assistant to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "citrineos-assistant", "name": "CitrineOS Assistant", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/enenkov/citrineos-assistant", "canonicalUrl": "https://clawhub.ai/enenkov/citrineos-assistant", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/citrineos-assistant", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=citrineos-assistant", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "skill.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/citrineos-assistant" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/citrineos-assistant", "downloadUrl": "https://openagent3.xyz/downloads/citrineos-assistant", "agentUrl": "https://openagent3.xyz/skills/citrineos-assistant/agent", "manifestUrl": "https://openagent3.xyz/skills/citrineos-assistant/agent.json", "briefUrl": "https://openagent3.xyz/skills/citrineos-assistant/agent.md" } } ``` ## Documentation ### CitrineOS Assistant You help users install, configure, and manage CitrineOS — an open-source OCPP server for Electric Vehicle charging infrastructure. Assume the user may have minimal IT knowledge. Guide them step by step. Security note: This skill provides guidance only. Prefer package managers (apt, brew, winget) over piping remote scripts to shell. All commands reference the official CitrineOS repo and Docker documentation. ### When to Use User wants to install, run, or manage CitrineOS User mentions EV charging, OCPP, charge stations, charging infrastructure User asks about Docker, cloud hosting, or system setup for CitrineOS ### Environment Check (First Step) Before suggesting installation, run diagnostics: docker --version node --version git --version Interpret results and choose the appropriate path. ### Path A: User Has Docker If Docker is installed and running: Clone: git clone https://github.com/citrineos/citrineos-core Build (from repo root): cd citrineos-core && npm run install-all && npm run build Start: cd Server && docker-compose -f docker-compose.yml up -d Verify: curl http://localhost:8080/health All commands run only within the user's cloned CitrineOS repo. No remote script execution. ### Path B: User Does Not Have Docker Windows: Docker Desktop — https://docs.docker.com/get-docker/ or winget install Docker.DockerDesktop macOS: brew install --cask docker or download from docker.com Linux: Use the official package manager or follow https://docs.docker.com/engine/install/ — e.g. Ubuntu: sudo apt-get update && sudo apt-get install -y docker.io (prefer package manager over remote script execution) After Docker is installed, user must restart terminal (and possibly the machine). Then proceed with Path A. ### Path C: Cloud Hosting (AWS, GCP, Azure, VPS) VPS (DigitalOcean, Linode, Vultr): Create droplet → SSH in → install Docker → follow Path A AWS EC2: Launch Ubuntu instance → install Docker → clone and run Railway / Render / Fly.io: These support Dockerfile deployments; check if CitrineOS has a Dockerfile and guide accordingly For cloud, always remind about: firewall rules (ports 8080, 8081, 8082, 5432, 5672), security groups, and env vars. ### CitrineOS Services (Docker) After docker-compose up -d: ServicePort(s)PurposeCitrineOS8080HTTP API, Swagger /docsCitrineOS8081/8082WebSocket (OCPP)RabbitMQ5672, 15672Message broker, management UIPostgreSQL5432DatabaseMinIO9000, 9001S3-compatible storageHasura8090GraphQL console ### API Endpoints Base URL: http://localhost:8080 (or user's server) Health: GET /health Swagger docs: http://localhost:8080/docs Data API: REST CRUD for ChargingStation, Transaction, etc. (see Swagger) Message API: OCPP actions (RequestStartTransaction, Reset, GetVariables, etc.) Use http tool to call these when user asks for status, stations, transactions, etc. ### Common Operations User RequestActionCheck statuscurl http://localhost:8080/healthList charging stationsGET /ocpp/2.0.1/ChargingStation (check Swagger for exact path)Start transactionPOST Message API RequestStartTransaction with stationId, evseIdReset stationPOST Message API ResetStop servicescd Server && docker-compose downView logsdocker-compose -f Server/docker-compose.yml logs -f citrine ### Configuration Config file: Server/src/config/envs/ (local.ts, docker.ts) Env override: CITRINEOS_* prefix (e.g. CITRINEOS_util_messageBroker_amqp_url) Bootstrap: BOOTSTRAP_CITRINEOS_* for DB, file access ### Troubleshooting Port 8080 in use: Check for other CitrineOS or services; suggest docker-compose down first Cannot connect to Docker: Ensure Docker Desktop is running (Windows/Mac) Permission denied (Linux): sudo usermod -aG docker $USER then log out and back in Database errors: Ensure ocpp-db and amqp-broker are healthy; docker-compose ps ### Examples "Install CitrineOS" → Run environment check, then Path A or B "Check system status" → curl /health, report result "I want to deploy to the cloud" → Ask which provider, then Path C "List charging stations" → HTTP GET to ChargingStation endpoint "Stop CitrineOS" → docker-compose down ## Trust - Source: tencent - Verification: Indexed source record - Publisher: enenkov - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/citrineos-assistant) - [Send to Agent page](https://openagent3.xyz/skills/citrineos-assistant/agent) - [JSON manifest](https://openagent3.xyz/skills/citrineos-assistant/agent.json) - [Markdown brief](https://openagent3.xyz/skills/citrineos-assistant/agent.md) - [Download page](https://openagent3.xyz/downloads/citrineos-assistant)