配置与身份认证¶

运行资源命令前，先配置 Product API 服务地址和个人访问令牌，再通过只读命令发现并选择工作区。moi-cli 将这些值保存到 ~/.moi-cli.json；令牌在 config show 中会被遮蔽显示。

配置连接信息¶

以下步骤适用于下载页提供的 0.1.0 安装包。个人访问令牌是你创建的一串密钥，CLI 使用它确认身份。先在访问凭据中创建令牌，再将下面的占位符替换为令牌值。请像保护密码一样保管它。

moi-cli config set-endpoint "https://api.moi.matrixorigin.cn/v5"
moi-cli config set-api-key "<personal-access-token>"

服务地址使用 https://api.moi.matrixorigin.cn/v5。CLI 不会自动补充服务地址。个人访问令牌按原始值传入；不要添加 Bearer 前缀，也不要将令牌写入脚本、终端历史或代码仓库。

列出当前身份可见的工作区，再保存要操作的工作区 ID：

moi-cli -o workspace list
moi-cli config set-workspace "<workspace-id-from-list>"

运行以下命令检查已保存的配置：

moi-cli config show

输出中应显示服务地址和工作区 ID，api_key 显示为掩码。仅列出工作区时不需要预先配置工作区 ID；其他工作区范围命令缺少任一必要值时，先补齐配置再运行。

为单次命令提供配置¶

可以在当前命令中传入服务地址、令牌或工作区，不修改已保存配置：

moi-cli \
  -endpoint "https://api.moi.matrixorigin.cn/v5" \
  -api-key "<personal-access-token>" \
  -workspace-id "<workspace-id>" \
  workspace-member current-principal

仅在安全的运行环境中传入令牌。共享终端、CI 日志和进程列表可能暴露命令行参数；优先使用受保护的配置文件或部署提供的密钥注入方式。

配置工作区角色¶

需要为某个工作区选择当前角色时，保存该工作区和角色的对应关系：

moi-cli config set-role "<workspace-id>" "<role-id>"

使用 moi-cli config unset-role <workspace-id> 删除该工作区的已保存角色。角色配置只影响对应工作区；切换工作区时，重新确认角色和权限。

最后更新于 2026 年 9 月 28 日