用安装脚本装的 — 在跑 Octop 的那台机器上打开终端。安装脚本会把包装命令放到 ~/.octop/bin 并写入 shell 配置；旧会话可能还看不见。先开一个新终端，或执行 source ~/.zshrc / source ~/.bashrc。
octop user list
octop user passwd <用户名> --password <密码>
octop 仍不在 PATH 时，按这个顺序找：
直接用完整路径即可，例如：
~/.octop/bin/octop user list
~/.octop/bin/octop user passwd <用户名> --password <密码>
包装不存在时改用 ~/.octop/venv/bin/octop。数据目录是当前用户下的 ~/.octop/。如果你用另一个系统账户启动过 octop run / octop service，请切换到那个账户再执行。
用桌面客户端装的 — 客户端不提供 octop 命令，也不会写 PATH，而是把便携运行时解压到 ~/.octop/portable。用它自带的 Python 调同一套 CLI：
~/.octop/portable/runtime/bin/python3 ~/.octop/portable/launch.py user list
~/.octop/portable/runtime/bin/python3 ~/.octop/portable/launch.py user passwd <用户名> --password <密码>
便携运行时在客户端首次启动时才解压，portable 目录不存在时请先启动一次客户端。
随后用新密码打开 http://127.0.0.1:8088（或你实际绑定的地址）登录。
命令行安装（install.ps1 / install.bat / pip）会把 octop 写进用户 PATH；桌面客户端不会。两种装法改的是同一份 %USERPROFILE%\.octop\octop.db。
用安装脚本装的 — 打开新的 PowerShell 或「命令提示符」，旧窗口可能还没加载新 PATH：
octop user list
octop user passwd <用户名> --password <密码>
仍提示找不到命令时，用包装命令（与登录页弹窗一致）：
PowerShell
& "$env:USERPROFILE\.octop\bin\octop.cmd" user passwd <用户名> --password <密码>
cmd
%USERPROFILE%\.octop\bin\octop.cmd user passwd <用户名> --password <密码>
包装不存在时再试 %USERPROFILE%\.octop\venv\Scripts\octop.exe。确认 Octop 是用当前 Windows 用户安装的。
用桌面客户端装的 — 客户端装在 Program Files\Octop，不提供 octop 命令，而是把便携运行时解压到 %USERPROFILE%\.octop\portable。用它自带的 Python 调同一套 CLI：
PowerShell
$octop = "$env:USERPROFILE\.octop\portable"
& "$octop\runtime\python.exe" "$octop\launch.py" user list
& "$octop\runtime\python.exe" "$octop\launch.py" user passwd <用户名> --password <密码>
cmd
set OCTOP_PORTABLE=%USERPROFILE%\.octop\portable
"%OCTOP_PORTABLE%\runtime\python.exe" "%OCTOP_PORTABLE%\launch.py" user list
"%OCTOP_PORTABLE%\runtime\python.exe" "%OCTOP_PORTABLE%\launch.py" user passwd <用户名> --password <密码>
改完密码退出客户端再打开，用新密码登录。客户端运行时首次启动才解压，所以请先至少启动过一次客户端；portable 目录不存在时按上面的脚本安装方式操作。
在宿主机执行。把容器名 octop 换成你 docker ps 里实际的名字。镜像把 CLI 放在 PATH 里的 /app/.venv/bin。
docker exec -it octop octop user list
docker exec -it octop octop user passwd <用户名> --password <密码>
容器里提示找不到 octop 时，用完整路径：
docker exec -it octop /app/.venv/bin/octop user list
docker exec -it octop /app/.venv/bin/octop user passwd <用户名> --password <密码>
首次部署的默认用户名是 admin，可用 OCTOP_ADMIN_USERNAME 覆盖。Compose 默认把宿主机 ~/.octop 挂到容器 /data/.octop，CLI 改的就是这份数据库。
更完整的首次密码说明见 Docker 部署。
Docker 版（页面一般是 http://<NAS的IP>:8088）在 NAS 终端或 SSH 中执行。容器名以 docker ps 为准：
docker exec -it octop octop user list
docker exec -it octop octop user passwd <用户名> --password <密码>
容器里找不到 octop 时用 /app/.venv/bin/octop：
docker exec -it octop /app/.venv/bin/octop user passwd <用户名> --password <密码>
本地版（页面一般是 http://<NAS的IP>:8089）安装时会把官方 CLI 链到 /usr/local/bin/octop（实际指向 octop-cli）。SSH 进 NAS 后：
octop user list
octop user passwd <用户名> --password <密码>
octop 不在 PATH 时用完整路径 /usr/local/bin/octop 或 /var/apps/octop-native/bin/octop-cli。不要用 /var/apps/octop-native/bin/octop——那是应用中心拉起 Web 服务的启动器，会和已在跑的实例抢 8089 端口。
用户名可在应用设置窗口里核对。数据目录里的 octop-login.txt 只反映安装时的引导密码，改密后不要再当现行密码用。请以 octop-native 或 root 执行，避免把数据文件写成别的用户所有。
安装与首次登录见 FnOS。
云服务器 CVM 用 SSH 登录后切到运行 Octop 的账户：
su - agentuser
octop user list
octop user passwd <用户名> --password <密码>
octop 不在 PATH 时用该账户下的包装命令：
su - agentuser
~/.octop/bin/octop user list
~/.octop/bin/octop user passwd <用户名> --password <密码>
绝对路径一般是 /home/agentuser/.octop/bin/octop，再不行试 /home/agentuser/.octop/venv/bin/octop。CVM 首次向导用的一次性密码在 ~/octop-login.txt（切换到 agentuser 之后）。设置完成后请使用你在向导里自设的账号。
轻量应用服务器 用 SSH 登录实例后，在跑 Octop 的那个账户下执行同样命令。找不到 octop 时先 echo $HOME，再调用 $HOME/.octop/bin/octop。访问地址仍以实例 应用管理 → Octop 控制台 为准。
开通步骤见 在腾讯云中使用。
