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 系列对比

名称	定位	语言	特点
OpenClaw	全功能标杆	TypeScript/Node.js	生态最成熟，功能完整，资源占用高
ZeroClaw	极致性能	Rust	冷启动快，内存占用极低，生态尚新
PicoClaw	嵌入式极简	Go	超轻量，适合树莓派等旧设备
Nanobot	教学与研究	Python	代码极简，易审计，适合学习
IronClaw	安全强化	Rust	沙箱隔离，适合金融政企等高安场景

*选型建议：追求全功能选 OpenClaw；资源受限选 ZeroClaw；教学科研选 Nanobot。

Docker 方式安装

这是最常见的部署方式，以 AlmaLinux/CentOS 为例。

# 1. 安装 Docker 环境
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum makecache fast
yum install -y docker-ce docker-ce-cli containerd.io
systemctl start docker && systemctl enable docker

# 2. 拉取并启动 OpenClaw
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
docker-compose up -d

常见问题处理： 很多用户在启动后发现容器一直重启，这是因为 OpenClaw Gateway 的安全策略限制了非环回访问。需要在配置文件 ~/.openclaw/openclaw.json 的 gateway 部分添加 controlUi.allowedOrigins。

{
  "gateway": {
    "controlUi": {
      "allowedOrigins": [
        "http://127.0.0.1:18789",
        "http://localhost:18789",
        "http://你的服务器IP:18789"
      ]
    }
  }
}

修改后重启容器即可正常访问 Web 界面（默认端口 18789）。

原生环境安装

如果不使用 Docker，也可以直接在 Linux 上安装 Node.js 环境。

# 1. 安装 Node.js 24 (推荐 nvm 管理)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm install 24

# 2. 安装 OpenClaw 依赖及本体
dnf update -y
dnf groupinstall -y "Development Tools"
dnf install -y git curl wget
npm config set registry https://registry.npmmirror.com

# 3. 一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

安装完成后，在浏览器访问 IP:18789 即可进入控制台。

TuriX-CUA 简介

除了终端智能体，还有一种基于桌面的自动化方案 TuriX-CUA。它属于 Computer-Use Agent，原理是让大模型像人一样'看屏幕、控鼠标键盘'，无需 API 即可跨应用完成订票、做 PPT 等任务。

核心能力：跨应用自动化、数据抓取、自然语言驱动。
系统支持：macOS 15.6+ (Apple Silicon)、Windows 10+。
局限：存在操作延迟，复杂多轮任务可能出错，需注意隐私安全。

这类工具适合需要模拟人工操作 GUI 的场景，与上述 CLI 工具形成互补。