什么是 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

4. 配置您的 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.