安装软件

PhysiClaw 的软件部分是一个命令行工具（CLI）：physiclaw。安装后确认版本，再运行健康检查。

1. 运行安装脚本

macOS / Linux

bash

curl -fsSL https://physiclaw.ai/install.sh | bash

Windows

powershell

iwr -useb https://physiclaw.ai/install.ps1 | iex

脚本会安装 uv、Python 3.12 和 physiclaw CLI，然后下载本地视觉模型。如果模型下载失败，运行 physiclaw setup local-vision-model 重新下载。

2. 确认安装成功

bash

physiclaw --version

如果提示找不到命令，打开新的终端窗口让更新后的 PATH 生效，然后重试。

3. 运行健康检查

bash

physiclaw doctor

doctor 报告当前版本、配置路径、本地视觉模型、检测到的硬件、配置的大模型和已安装的技能。

更新

PhysiClaw 以 uv 工具的形式安装。停止服务器，再用 uv 更新：

bash

uv tool upgrade physiclaw
# 如果依赖版本冲突，重新安装：
# uv tool install --force --upgrade physiclaw

卸载

清除用户数据（~/.physiclaw），再卸载 CLI：

bash

physiclaw uninstall
uv tool uninstall physiclaw