AI 智能体工具:OpenCode、OpenClaw 安装与配置指南
在本地部署 AI 编码助手和自动化代理时,环境配置往往是第一步。这里整理了 OpenCode 和 OpenClaw 的实战部署经验,涵盖 Linux、Mac 及 Windows 环境,重点解决常见的容器重启和权限问题。
OpenCode 概览与部署
OpenCode 是一款开源的 AI 编码代理工具,定位是独立于 IDE 的智能体(Agent)。它不直接替代编辑器,而是作为调度层连接多种大语言模型(如 Claude、GPT、本地 Llama 等),支持终端(TUI)、桌面应用和 IDE 扩展三种模式。
核心特点:
- 多模型兼容:内置精选模型,也支持接入任意 LLM 提供商。
- 上下文感知:通过 @ 引用文件,能分析整个项目代码库进行精准修改。
- 隐私优先:不存储代码与上下文,适合对数据安全敏感的环境。
- LSP 支持:提供智能补全、诊断与跳转。
Linux / Mac 安装
在终端中执行以下命令即可快速安装。如果看到 Successfully 提示,说明安装成功。
# 1. 下载安装脚本
curl -fsSL https://opencode.ai/install | bash
# 2. 将环境变量添加到全局配置
source ~/.bashrc
# 3. 启动终端界面
opencode
# 4. 启动 Web 端界面(需指定 IP 和端口)
opencode web --hostname 0.0.0.0 --port 5000
安装完成后,可以通过 SSH 客户端连接服务器进行操作。
Windows 安装
Windows 环境下推荐使用 Scoop 包管理器。如果遇到权限或路径错误,请尝试以管理员身份运行 PowerShell。
# 1. 允许运行脚本(若报错则执行此步)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 2. 安装 Scoop
iex "& {$(irm get.scoop.sh)} -RunAsAdmin"
# 3. 安装 Git(Scoop 依赖项)
scoop install git
# 4. 安装 OpenCode
scoop install opencode
# 5. 启动服务
opencode
# 启动 Web 端
opencode web --hostname 127.0.0.1 --port 5000
实际使用场景
在实际开发中,OpenCode 的 plan 模式非常实用。例如,当 Docker 容器异常重启导致服务不可用时,可以直接在终端输入需求,切换到 Plan 模式(按 Tab 键切换),让 AI 分析日志并给出修复建议,而不是盲目执行修改。
OpenClaw 概览与部署
OpenClaw 是一个全功能的自托管 AI 执行中枢,生态成熟度较高,支持 Telegram、钉钉、飞书等多种通讯渠道。相比其他版本,它的功能最完整,但资源占用也相对较高。
主流 Claw 系列对比
| 名称 | 定位 | 语言 | 特点 |
|---|---|---|---|


