OpenCode 插件参考

为 OpenClaw 添加 OpenCode 模型提供商支持。

分发¶

• 包：@openclaw/opencode-provider
• 安装方式：npm 或 ClawHub：clawhub:@openclaw/opencode-provider

接口¶

• 提供商：opencode
• 契约：mediaUnderstandingProviders

原生会话¶

OpenClaw 会在 Gateway 和已配对节点上自动检测 opencode CLI。已存储的会话随后会出现在 OpenCode 会话侧边栏分组中，并可通过官方 CLI 浏览转录。OpenCode v1 使用 --pure db 和 --pure export；v2 使用 api session.list 和 session export，并配合私有独立服务器。本地条目还提供 Continue，它会创建一个 OpenClaw 会话，该会话的第一轮通过 ACP 恢复原生 OpenCode 会话。OpenCode 会保留完整的服务器端模型上下文，目录查看器也会继续显示该历史。OpenClaw 还会将最近的原生历史导入到已采用会话的转录中。对于非常长的转录，仅导入最近 200 条，并使用 512 KiB 的序列化条目预算。已配对节点条目仍为只读。

受限环境可防止目录浏览继承无关的 Gateway 凭据。OpenCode v1 使用 --pure；v2 使用空的临时配置目录，并禁用项目配置，以避免加载用户插件。失败的 CLI 调用会在 Gateway 日志中生成 opencode/session-catalog 警告。

在 配置 > 插件 > OpenCode 下关闭 OpenCode Session Catalog 可禁用发现。默认启用。

相关文档¶

• opencode