OpenCode 使用指南
ClawPanel 将 OpenCode 的安装配置和实际操作分为两个页面；模型渠道可与其他引擎共用，运行时独立于 OpenClaw Gateway。
开始使用
- 左侧引擎切换器选择 OpenCode，进入「运行与配置」。
- 完成受管安装。当前仓库的初始安装基线为
opencode-ai@1.18.21，以配置页显示的目标版本为准，不代表上游最新版本。
- 在「通用 → 模型渠道」保存地址、Key、模型，点击「同步到 OpenCode」，按需设置默认模型。
- 启动服务，通过左侧「工作台」进入内嵌 OpenCode Web 界面，添加项目、创建会话并选择模型。
当前同步转换支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，以及 Ollama 的 OpenAI 兼容 /v1。Google Generative AI、OAuth 和结构化 SecretRef 不在此同步路径中。配置回读后仍需实际对话验证。
网络和目录
- 默认回环端口 4096，可在配置页修改；端口被其他进程占用时先换端口，不自动终止外部服务。
- Web 模式通过面板认证后的代理内嵌，不必额外向外网开放 4096。工作台使用 OpenCode 自身界面，不是 OpenClaw 的实时聊天页。
- 受管运行时、配置和凭据位于当前 OpenClaw 配置根目录的
clawpanel/opencode/；密钥写入独立文件，不直接写在 Provider 配置中。
- Web 的项目路径属于面板服务器；Docker 中项目须单独挂载。共享登录与工作目录不构成多用户代码执行隔离。
在线更新与卸载
- 检查更新 / 在线更新仅针对 ClawPanel 受管安装；读取 npm 发布版本，安装到 staging，核验后切换，切换失败恢复原运行时。
- 更新运行中的受管服务会停机并尝试重新启动；若重启失败，配置页会报告错误，需检查日志。上游有新版本不等于所有新功能都经过面板验收。
- 卸载停止受管进程并删除受管运行时，保留
home/ 下的配置、凭据、项目及运行数据。卸载不等于彻底清除敏感数据，清理前先备份并确认目录。
- 外部启动的实例不按受管进程处理；面板会限制相应停止、更新或卸载操作。
排查
模型没出现先检查目标同步和默认模型，再刷新/重新加载工作台。启动失败查看配置页错误、受管日志及端口占用；更新后的网络调用失败查看 Base URL、Key、模型 ID 和实际 Provider 协议。
另见 多引擎与模型渠道、Docker 部署。