← 返回 Skills 市场
OpenCode Remote
作者
Entropy-xcy
· GitHub ↗
· v1.0.0
268
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install opencode-remote
功能描述
通过 HTTP API 远程操作 OpenCode 服务器。用于管理远程 OpenCode 实例的会话、监控状态和执行任务。 核心功能: 1. 管理多个"主session"(每个有独立的四词短名、endpoint、任务) 2. 向 session 发送消息(默认不指定agent,延续之前使用) 3. 自动监控:发...
安全使用建议
This skill appears to implement what it claims (remote OpenCode session management) but has surprising behaviors you should consider before using it:
- File path mismatch: SKILL.md says to record sessions to 'opencode-sessions.md' but the provided main_session_manager.py writes JSON to /root/.openclaw/workspace/opencode-sessions.json. That will fail unless run as root or the directory exists; change the path to a safe, user-writable location if you plan to run it.
- Persistent monitoring: The skill instructs creating cron jobs and includes a long-running monitor script. If you enable this, the agent (or your machine) will poll the remote server every 5 minutes and store/report session data. Confirm you want that continuous network activity and what data will be reported.
- Default proxy: monitor_session.py uses a default SOCKS5 proxy (socks5://127.0.0.1:1080) that is not documented in SKILL.md. If you don't intend to route traffic through a local proxy, remove or override this default; otherwise traffic will attempt to use that proxy which may silently fail or leak to unintended routes if you have one configured.
- Remote shell and file APIs: The referenced API exposes endpoints for executing shell commands, reading files, PTY creation, etc. Those are powerful and can read or modify remote host files — ensure you trust the OpenCode server and that you intend to use those capabilities.
Recommendations before installing or running:
1. Inspect and (preferably) modify the code: change the session storage path to a non-root location, remove or make explicit the default SOCKS proxy, and verify cron commands are appropriate for your environment.
2. Run scripts in an isolated environment (container or non-privileged account) to avoid accidental writes to /root or persistent daemons running under your account.
3. Decide explicitly whether you want periodic monitoring; if not, do not add the cron job and run monitoring only when asked.
4. Review the server endpoints you will query (esp. shell/file endpoints) to avoid unintended remote commands or data exposure.
5. If anything is unclear, ask the skill author to justify the /root path and the proxy default and to provide an option to store state in the current working directory.
Because of the mismatches and persistence instructions, treat this skill as 'suspicious' until you confirm or remediate the noted issues.
功能分析
Type: OpenClaw Skill
Name: opencode-remote
Version: 1.0.0
The skill bundle is designed for remote management of OpenCode servers via an HTTP API. It includes Python scripts (opencode_client.py, monitor_session.py) for interacting with the API and managing session states locally. The instructions in SKILL.md emphasize transparency by requiring the agent to repeat all sent prompts to the user and use automated monitoring (via a cron-like mechanism) to track task progress. While the API supports powerful features like remote shell execution and PTY access, these are consistent with the stated purpose of managing a remote development environment, and there is no evidence of local data exfiltration, unauthorized persistence, or malicious intent.
能力评估
Purpose & Capability
Functionality (listing sessions, sending messages, monitoring, creating sessions, executing shell via API) aligns with the described OpenCode remote management purpose. However, the SKILL.md says session records should be stored in an 'opencode-sessions.md' (project-relative) while main_session_manager.py writes to /root/.openclaw/workspace/opencode-sessions.json — an unexplained mismatch that implies the code expects to write into root's home rather than a local workspace.
Instruction Scope
SKILL.md instructs automatic, recurring monitoring (every 5 minutes) after any message send and suggests creating cron jobs; monitor_session.py implements long-running polling. The instructions also require echoing full prompts/assistant outputs back to the user (which could reveal sensitive session content). The docs encourage running commands like POST /session/{id}/shell and adding cron entries — these expand scope into persistent background network activity and remote command execution, which are legitimate for this tool but significant and not explicitly surfaced as persistent behavior to end users.
Install Mechanism
No install spec is provided (instruction-only), and included scripts are plain Python — nothing is downloaded or extracted at install time. This is lower install-mechanism risk.
Credentials
The skill declares no required environment variables or credentials, which is consistent with the code that takes explicit base_url and optional proxy parameters. However, monitor_session.py uses a hard-coded default proxy 'socks5://127.0.0.1:1080' (not documented in SKILL.md), and main_session_manager.py writes to a privileged-looking path (/root/.openclaw/workspace/opencode-sessions.json) despite SKILL.md suggesting recording to a repo-relative markdown file. These are disproportionate surprises: they imply network routing via a local SOCKS proxy and writing to /root without declaring that requirement.
Persistence & Privilege
The skill strongly encourages (and documents) creating scheduled monitoring tasks (cron every 5 minutes) and provides a long-running monitor script. While 'always' is false, the instructions explicitly direct the user to establish persistent monitoring behavior and file storage — this gives the skill ongoing network activity and disk writes if the user follows them. Also, the code writes session state to /root, which requires elevated filesystem privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install opencode-remote - 安装完成后,直接呼叫该 Skill 的名称或使用
/opencode-remote触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: Remote OpenCode session management with monitoring and agent selection
元数据
常见问题
OpenCode Remote 是什么?
通过 HTTP API 远程操作 OpenCode 服务器。用于管理远程 OpenCode 实例的会话、监控状态和执行任务。 核心功能: 1. 管理多个"主session"(每个有独立的四词短名、endpoint、任务) 2. 向 session 发送消息(默认不指定agent,延续之前使用) 3. 自动监控:发... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 268 次。
如何安装 OpenCode Remote?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install opencode-remote」即可一键安装,无需额外配置。
OpenCode Remote 是免费的吗?
是的,OpenCode Remote 完全免费(开源免费),可自由下载、安装和使用。
OpenCode Remote 支持哪些平台?
OpenCode Remote 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenCode Remote?
由 Entropy-xcy(@entropy-xcy)开发并维护,当前版本 v1.0.0。
推荐 Skills