Opencode 控制器：掌控 AI 编程会话 - Openclaw Skills

作者：袖梨 2026-08-18

什么是 Opencode 控制器？

Opencode 控制器是您 AI 辅助开发环境的核心编排层。它旨在通过提供管理会话和智能体状态的结构化框架，弥合人类指令与自主执行之间的鸿沟。通过利用 Openclaw 技能，此工具可确保您的编码环境保持有序、安全且高效。

该技能基于关注点分离的哲学构建。它区分了规划阶段和构建阶段，确保在没有经过验证的架构计划之前绝不编写代码。它简化了提供商身份验证和会话持久化的复杂性，使其成为开发人员在日常操作中利用 Openclaw 技能时不可或缺的组件。

下载入口:https://github.com/openclaw/skills/tree/main/skills/karatla/opencode-controller

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install opencode-controller

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 opencode-controller。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Opencode 控制器 应用场景

  • 通过会话选择器管理多个并发编码项目。
  • 强制执行“先规划后构建”工作流，以减少架构错误。
  • 针对特定任务，在 Anthropic 或 OpenAI 等不同 LLM 提供商之间快速切换。
  • 集中管理各种 AI 模型提供商的身份验证工作流。
Opencode 控制器 工作原理
  1. 用户启动控制器并选择首选的 AI 提供商和身份验证方法。
  2. 该技能使用 /sessions 命令打开会话管理界面，以恢复或创建工作区。
  3. 用户通过 /agents 命令激活 Plan（规划）智能体，以分析任务并生成逐步路线图。
  4. 计划验证后，用户切换到 Build（构建）智能体进行实施。
  5. 控制器管理规划与构建之间的持续循环，直到任务完成。

Opencode 控制器 配置指南

要将此技能集成到本地环境中，请按以下步骤操作：

  1. 确保您的环境已配置为支持 Openclaw 技能。
  2. 将 opencode-controller 添加到您的技能清单中。
  3. 运行初始化命令以启动会话管理器：
/sessions
  1. 配置您的 AI 模型提供商并处理身份验证：
/models

Opencode 控制器 数据架构与分类体系

数据元素 类型 用途
会话注册表 元数据 跟踪现有项目 ID 和会话历史记录
智能体状态 枚举 定义当前模式：规划 (Plan) 或 构建 (Build)
提供商配置 对象 存储特定于提供商的设置和身份验证状态
登录逐字链接 字符串 捕获并转发安全的身份验证链接
name: opencode-controller
description: Control and operate Opencode via slash commands. Use this skill to manage sessions, select models, switch agents (plan/build), and coordinate coding through Opencode.

Opencode Controller

Core rule

Clawdbot does not write code. All planning and coding happens inside Opencode.

Pre-flight

  • Ask the user which AI provider to use.
  • Ask how the provider should be authenticated.
  • Do not proceed without confirmation.

Session management

  • Start Opencode.
  • Open session selector using: /sessions
  • If the current project already exists:
    • Select the existing session.
  • Never create a new session without user approval.

Agent (mode) control

  • Open agent selector using: /agents
  • Available agents:
    • Plan
    • Build
  • Always select Plan first.
  • Switch agents whenever required using /agents.

Model selection

  • Open model selector using: /models
  • Select the user-requested provider.
  • If authentication is required:
    • Copy the login link provided by Opencode.
    • Send it to the user.
    • Wait for confirmation before continuing.

Plan agent behavior

  • Ask Opencode to analyze the task.
  • Request a clear step-by-step plan.
  • Allow Opencode to ask clarification questions.
  • Review the plan carefully.
  • If the plan is incorrect or incomplete:
    • Ask Opencode to revise it.
  • Do not allow code generation in Plan.

Build agent behavior

  • Switch to Build using /agents.
  • Ask Opencode to implement the approved plan.
  • If Opencode asks any question:
    • Immediately switch back to Plan.
    • Answer and confirm the plan.
    • Switch back to Build.

Completion

  • Repeat the Plan → Build loop until all user requirements are satisfied.
  • Never skip Plan.
  • Never answer questions in Build.

Output format

  • Show all slash commands explicitly.
  • State which option is selected.
  • Provide login links verbatim.

相关文章

精彩推荐