OpenClaw 学习录

OpenCode 是一款开源 AI 编程助手，拥有 150K GitHub 星标，支持终端、桌面和 IDE 三种使用方式。本文介绍如何通过 curl、npm、brew 等方式安装 OpenCode，配置 LLM Provider，使用 /init 初始化项目，以及完成第一次 AI 辅助编程交互。

如何用好 AI 编程助手？关键在于 Plan-Build 工作流。先用 Plan 模式让 AI 分析需求并制定方案，迭代确认后再切换 Build 模式执行修改。配合 /undo 回退、@ 文件引用、! 命令执行等操作，形成完整的开发循环。本文详解这一工作流的核心操作与最佳实践。

OpenCode 支持 75+ LLM Provider，包括 OpenCode Zen 精选模型、GitHub Copilot、ChatGPT Plus/Pro、Anthropic Claude、Amazon Bedrock、Google Vertex AI、Azure OpenAI 等。本地模型可通过 Ollama、LM Studio 接入。本文详细说明各 Provider 的配置方法与 API Key 管理。

OpenCode TUI 由 Neovim 用户和 terminal.shop 团队打造，将终端界面推向极致。本文介绍 TUI 的核心命令体系（/compact、/models、/share 等）、快捷键设计（ctrl+x leader key）、主题配置、滚动加速、编辑器集成，以及如何在 WSL 环境中获得最佳体验。

MCP（Model Context Protocol）是为 AI Agent 添加外部工具的标准协议。OpenCode 支持 Local 和 Remote 两种 MCP Server 类型，自动处理 OAuth 认证流程。本文通过 Sentry、Context7、Grep 等实际案例，演示如何配置 MCP Server，管理工具权限，以及调试连接问题。

OpenCode 内置 30+ LSP Server，覆盖 TypeScript、Python、Rust、Go、Java、C++ 等主流语言，自动检测文件类型并启动对应的 LSP 服务，将诊断信息实时反馈给 LLM。本文介绍 LSP 的启用/禁用、自定义 LSP 配置，以及实验性的 LSP Tool（goToDefinition、findReferences 等）。

OpenCode 提供两种扩展机制：Agent Skills 通过 SKILL.md 文件定义可复用的指令模板；Custom Tools 用 TypeScript/JavaScript 编写自定义工具函数，支持 Zod Schema 参数验证。本文详解两种扩展的创建方法、权限配置、以及在项目中集成 Python 等外部脚本的实际案例。

/share 命令可将当前对话生成公开链接（opncd.ai/s/...），方便团队协作与问题排查。支持手动、自动、禁用三种分享模式，/unshare 可随时取消分享。本文介绍 Share 的使用方式、隐私考量、以及企业场景下如何通过配置禁用分享功能以满足合规要求。

OpenCode 不存储任何代码或上下文数据，所有处理在本地完成。其权限系统支持细粒度的 allow/ask/deny 控制，覆盖文件读取、命令执行、编辑操作等。本文解析 OpenCode 的隐私架构、权限模式匹配（如 .env 文件默认拒绝访问）、doom_loop 检测机制，以及代理和自定义 CA 证书配置。

OpenCode 企业版支持 SSO 集成、内部 AI Gateway、中央配置（.well-known/opencode）和 MDM 管理设置（macOS/Linux/Windows）。本文梳理企业部署的完整路径：从内部试用到正式上线，涵盖禁用 Share、配置 SSO、部署 Managed Settings、验证配置优先级，以及 Zen 团队管理功能。