A sophisticated remote management skill for OpenCode servers that enables multi-session orchestration and automated progress monitoring via HTTP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install opencode-remote
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install opencode-remote using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenCode Remote Control?
The OpenCode Remote skill is a specialized tool within the Openclaw Skills ecosystem designed for developers to interact with remote OpenCode instances. It allows for the management of multiple main sessions, each identified by unique shortnames, providing a streamlined interface for task execution, state monitoring, and session lifecycle management. This skill ensures high transparency by requiring prompt confirmation and provides automated reporting for long-running background tasks.
By integrating this skill, users can seamlessly transition between local development and remote server execution. It supports advanced agent selection and provides deep visibility into the AI's internal todo lists, ensuring that complex coding tasks are tracked from initiation to completion with minimal manual overhead.
OpenCode Remote Control Use Cases
- Orchestrating concurrent AI coding projects across multiple remote server endpoints.
- Automating the monitoring of long-running development tasks with periodic status reports.
- Delegating specific architectural or debugging tasks to specialized agents like Sisyphus or Hephaestus.
- Maintaining a persistent log of remote session IDs and task progress for team-wide visibility.
How OpenCode Remote Control Works
- Establishes a connection to a remote OpenCode server by validating health endpoints and retrieving active session lists.
- Maps remote sessions to user-friendly four-character shortnames for efficient command routing.
- Dispatches prompts to the server using either synchronous or asynchronous HTTP POST requests, depending on the required workflow.
- Initializes a background monitoring routine that polls the session's todo status every five minutes to provide progress updates.
- Captures the final output and generates a comprehensive completion report once the remote agent finishes the task.
OpenCode Remote Control Setup
To begin using this skill with Openclaw Skills, ensure your remote server is accessible and follow these steps:
# Verify connection to the OpenCode server
curl -s http://<host>:<port>/global/health | jq
# List all current sessions on the server
curl -s http://<host>:<port>/session | jq
# Check the detailed status of a specific session
curl -s http://<host>:<port>/session/<sessionID>/todo | jq
OpenCode Remote Control Data Schema & Taxonomy
The skill organizes session information and metadata through the following structures:
- Session Registry: Maintained in
opencode-sessions.mdcontaining a table with Shortname, Endpoint, Session ID, and Task context. - Message Objects: Standardized JSON payloads for interactions, including message parts and model provider specifications.
- Status Schema: Task tracking via a todo list with three primary states: completed, in_progress, and pending.
- Monitoring Logs: Aggregated time-series data for multi-session status reporting.
OpenCode Remote Control Advanced Features
- Multi-session aggregation for simultaneous monitoring of distributed workloads.
- Asynchronous prompt execution with non-blocking 204 response handling.
- Intelligent agent variant selection (Ultraworker, Deep Agent, Plan Executor) for specialized tasks.
- Automated cron-based monitoring with smart completion detection and final output extraction.
SKILL.md
Loading
Related Openclaw Skills
LiveAvatar
LiveAvatar provides a real-time video and voice interface for your agents, enabling face-to-face AI communication.
Kenya Tax Rates Skill
A specialized utility for calculating accurate Kenya payroll deductions, including PAYE, SHIF, and Housing Levy using 2024/2025 rates.
Agent Money Tracker
A comprehensive TypeScript library for AI agents to manage finances, budgets, and savings through natural language parsing and structured data.
Daily Devotion Skill
A comprehensive spiritual AI agent skill that generates personalized daily devotions including scripture, pastoral reflections, and structured first-person prayers.
Adaptive Reasoning
Dynamically adjust AI reasoning depth based on task complexity to balance response speed and analytical depth.
Pattern Analyst
An AI agent skill designed to observe interactions, identify behavioral patterns, and surface insights that align daily actions with long-term goals.
Featured*
