安装 WopalSpace

WopalSpace 的分发是分层的：installer 只安装 wopal 命令；真正的空间、引擎与本体由 wopal setup 在首次运行时准备。本页讲安装与首次 setup。

系统要求

CLI 与 ellamaka 引擎都是自包含二进制（内置运行时），普通用户不需要安装 Node.js。

支持的平台

安装 wopal 命令

macOS / Linux

curl -fsSL https://wopal.cn/install.sh | bash

担心管道执行？先下载查看再执行：

curl -fsSL https://wopal.cn/install.sh -o install.sh
cat install.sh        # 确认内容
bash install.sh        # 无误后执行

Windows（PowerShell）

irm https://wopal.cn/install.ps1 | iex

installer 会：检测平台 → 读取 CLI release manifest → 下载对应平台的 wopal 归档 → 校验 SHA-256 → 安装到 bin 目录（macOS / Linux 为 ~/.wopal/bin/，Windows 为 %LOCALAPPDATA%\Programs\Wopal\bin\）→ 把该目录加入 PATH → 用 wopal --version 验证。

验证安装

wopal --version
# 输出示例：wopal x.y.z

若提示 command not found，说明 PATH 未生效：

# macOS / Linux：重新加载 shell 配置
source ~/.zshrc   # 或 ~/.bashrc
# 确认 bin 已在 PATH
echo $PATH | grep wopal

首次 setup（准备空间、引擎与本体）

wopal 命令装好后，还需要一次 wopal setup 来编排你的第一个可用空间：

wopal setup

wopal setup 是一个三段式向导（Inspect → Configure → Execute），会依次：

1. 准备 WOPAL_HOME（默认 ~/.wopal）
2. 拉取本体 source（wopal-space-ontology）
3. 安装 ellamaka 引擎
4. 物化基础能力层（agents / skills / commands / rules / plugins）
5. 初始化你的第一个空间并注册
6. 在 Configure 阶段收集 AI provider 的 API Key（也可稍后用 wopal ellamaka auth login 配置）

wopal setup 是幂等的：重复运行会保留已有文件，只补齐缺失项。

配置 AI 提供商

AI 凭证不写在环境变量或 settings.jsonc 里，而是由引擎保管：

# 在 setup 的 Configure 阶段填写，或之后随时：
wopal ellamaka auth login

按提示选择提供商（如 OpenAI / Anthropic）并粘贴 API Key 即可。

升级

# 升级 wopal 命令本身
wopal update

# 升级 ellamaka 引擎
wopal ellamaka install

# 同步本体能力
wopal ontology update

卸载

wopal setup --remove

--remove 只清理 WOPAL_HOME，保留你所有的空间与项目文件。

常见问题

Q：installer 报 Permission denied？

通常是目标目录或 PATH 写入权限问题。确认你对自己的 home 目录有写权限；必要时手动把 bin 目录加入 PATH 后重跑 installer。

Q：wopal 提示 command not found？

PATH 未生效——source 你的 shell 配置，或确认 bin 目录已在 PATH 中（见上文「验证安装」）。

Q：没有 Git 能装吗？

不能。wopal setup 需要用 Git 克隆本体并以 worktree 形式管理空间；installer 的 doctor 步骤会检测并提示，但不会自动安装 Git。