OpenClaw

opencode-remote

通过 HTTP API 远程操作 OpenCode 服务器。用于管理远程 OpenCode 实例的会话、监控状态和执行任务。核心功能： 1. 管理多个"主session"（每个有独立的四词短名、endpoint、任务） 2. 向 session 发送消息（默认不指定agent，延续之前使用） 3. 自动监控：发送消息后自动开始每5分钟进度汇报 4. 创建 session 时询问用户选择 agent 用户需要提供： - OpenCode 服务器基础 URL（如 http://host:port） - 主session的四词短名（如 "csbx", "kumo", "hetc"）

entropy-xcy0 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install entropy-xcy/opencode-remote

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

OpenCode 远程操作

通过 HTTP API 与远程 OpenCode 服务器交互，实现多 session 管理、状态监控和任务执行。

核心概念：主 Session

每个主 session 有：

四词短名：唯一标识（如 csbx, kumo, hetc）
Endpoint：服务器地址和端口
Session ID：完整的 session 标识符
当前任务：正在执行的工作内容

主 Session 示例

短名	Endpoint	Session ID	任务
csbx	acf3108.ece.ust.hk:4096	ses_36c5b7b5effe3AHLnYQJGbgDr7	OpenCode Web 集成
kumo	acf3108.ece.ust.hk:9004	ses_34857e78affew0nYs8DQWml3q8	k8s macOS 部署
hetc	acf3108.ece.ust.hk:35457	ses_33c2542cbffe2GO3tL5tHTaiRT	HETC 项目开发

快速开始

1. 确认服务器连接

curl -s http://<host>:<port>/global/health | jq

2. 列出所有 Sessions

curl -s http://<host>:<port>/session | jq

3. 查看 Session 详情

# 基本信息
curl -s http://<host>:<port>/session/<sessionID> | jq

# 消息记录
curl -s http://<host>:<port>/session/<sessionID>/message | jq

# 待办事项（最准确的状态检查）
curl -s http://<host>:<port>/session/<sessionID>/todo | jq

向 Session 发送消息

⚠️ 重要原则

默认不指定 agent：除非用户明确要求，否则不设置 agent 字段，让系统使用默认 agent 或延续之前使用的 agent。

发送后必须重复给用户

每次发送消息后，必须完整重复发送的内容给用户确认：

以下是我发送给 <session_name> 的完整 prompt：

[完整的 prompt 内容，保持原样]

示例：

以下是我发送给 csbx 的完整 prompt：

做一下 git pull，然后看一下 commit message，看看最近 git 里的人都在干啥。

为什么重要：

让用户确认发送的内容正确
避免误发送错误信息
保持透明度，用户知道具体指令

发送方式

同步发送（等待 AI 响应）：

POST /session/{id}/message

异步发送（立即返回 204）：

POST /session/{id}/prompt_async

正确示例

# ✅ 不指定 agent（推荐）
curl -s -X POST http://<host>:<port>/session/<sessionID>/message \
  -H "Content-Type: application/json"...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/entropy-xcy/opencode-remote
Version: —
Commit: 84e17f98d51a4c3395fc15674fcbed770f468d6f
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# OpenCode 远程操作

通过 HTTP API 与远程 OpenCode 服务器交互，实现多 session 管理、状态监控和任务执行。

## 核心概念：主 Session

每个主 session 有：
- **四词短名**：唯一标识（如 `csbx`, `kumo`, `hetc`）
- **Endpoint**：服务器地址和端口
- **Session ID**：完整的 session 标识符
- **当前任务**：正在执行的工作内容

### 主 Session 示例

| 短名 | Endpoint | Session ID | 任务 |
|------|----------|------------|------|
| csbx | acf3108.ece.ust.hk:4096 | ses_36c5b7b5effe3AHLnYQJGbgDr7 | OpenCode Web 集成 |
| kumo | acf3108.ece.ust.hk:9004 | ses_34857e78affew0nYs8DQWml3q8 | k8s macOS 部署 |
| hetc | acf3108.ece.ust.hk:35457 | ses_33c2542cbffe2GO3tL5tHTaiRT | HETC 项目开发 |

---

## 快速开始

### 1. 确认服务器连接

```bash
curl -s http://<host>:<port>/global/health | jq
```

### 2. 列出所有 Sessions

```bash
curl -s http://<host>:<port>/session | jq
```

### 3. 查看 Session 详情

```bash
# 基本信息
curl -s http://<host>:<port>/session/<sessionID> | jq

# 消息记录
curl -s http://<host>:<port>/session/<sessionID>/message | jq

# 待办事项（最准确的状态检查）
curl -s http://<host>:<port>/session/<sessionID>/todo | jq
```

---

## 向 Session 发送消息

### ⚠️ 重要原则

**默认不指定 agent**：除非用户明确要求，否则**不设置 `agent` 字段**，让系统使用默认 agent 或延续之前使用的 agent。

### 发送后必须重复给用户

**每次发送消息后，必须完整重复发送的内容给用户确认**：

> **以下是我发送给 <session_name> 的完整 prompt：**
> 
> [完整的 prompt 内容，保持原样]

**示例**：
```
以下是我发送给 csbx 的完整 prompt：

做一下 git pull，然后看一下 commit message，看看最近 git 里的人都在干啥。
```

**为什么重要**：
- 让用户确认发送的内容正确
- 避免误发送错误信息
- 保持透明度，用户知道具体指令

### 发送方式

**同步发送**（等待 AI 响应）：
```bash
POST /session/{id}/message
```

**异步发送**（立即返回 204）：
```bash
POST /session/{id}/prompt_async
```

### 正确示例

```bash
# ✅ 不指定 agent（推荐）
curl -s -X POST http://<host>:<port>/session/<sessionID>/message \
  -H "Content-Type: application/json"...

搜索