本人超级大总结：mac 环境下本地部署的指令合集！

由于之前安装 openclaw 的过程，各种文件和插件不断的更新，然后官方的 openclaw 在本地文件中的配置非常难搞，很多国内的指令都过时了，如果文件配置加载错误，小白几乎是不可能搞定的，比如要编辑几个配置 json 文件才能更换大模型和 channel 这种场景。

OpenClaw 指令全攻略

一、安装方式

1. Homebrew 安装（推荐）

步骤 1：安装 Homebrew

/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

备选方式（如需更换镜像源）：

git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

步骤 2：添加 Homebrew 到 PATH

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

步骤 3：安装 OpenClaw

brew install openclaw

注意：如果已安装 OpenClaw，可以先卸载

brew uninstall openclaw

---

2. 文件管理器安装（curl 安装）

前提：确保已安装 Homebrew

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

---

二、网关配置

1. 检查网关状态

openclaw gateway status

2. 处理访问权限（重要！）

chmod 600 ~/.openclaw
chmod 700 ~/.openclaw

---

三、重要配置指令

1. 重新初始化配置（推荐）

openclaw init

重要提示：别设置默认模型（provider），直接跳过，之后重新配置都行，不然所有的文件都只认第一次配置的，非常难更改。

---

2. 百炼大模型配置（有坑，推荐使用 bash 写入方式）

步骤 1：配置百炼 API

openclaw config set 'models.providers.bailian' --json '{
  "baseUrl": "https://dashscope.aliyun.com/compatible-mode/v1",
  "apiKey": "sk-efec8fd4b2f348088da313ddc61fa26d",
  "api": "openai-completions",
  "models": [
    {
      "id": "qwen-max",
      "name": "Qwen Max",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0.02,
        "output": 0.02,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 128000,
      "maxTokens": 8192
    },
    {
      "id": "qwen-plus",
      "name": "Qwen Plus", 
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0.005,
        "output": 0.01,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 128000,
      "maxTokens": 8192
    }
  ]
}'

步骤 2：设置默认模型

openclaw models set bailian/qwen-max
openclaw models list

步骤 3：删除模型配置

openclaw config unset 'agents.defaults.models.bailian/qwen-max-'
# 或
openclaw config unset agents.defaults.model.primary

重要提示：通过 OpenClaw 引导进行配置的方式可能有问题，推荐使用 bash 写入方式。

---

3. 本地大模型调用（终极大法）

# 安装 Ollama
brew install ollama

# 拉取模型
ollama pull qwen2.5:7b

# 在 OpenClaw 中配置 provider 的 baseUrl 为 http://localhost:11434/v1
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    {
      "id": "qwen2.5:7b",
      "name": "Qwen2.5 7B",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 8192,
      "maxTokens": 8192
    }
  ]
}'

# 设置默认模型
openclaw models set ollama/qwen2.5:7b

---

4. 飞书配置

openclaw config set channels.feishu.appId "你的飞书App ID"
openclaw config set channels.feishu.appSecret "你的飞书App Secret"

---

四、重装指令

1. 清理旧配置

# 删除用户配置文件和数据目录（请先确认是否需要备份！）
rm -rf ~/.openclaw

# 删除 Homebrew 可能遗留的关联文件
brew cleanup

# 检查并删除 npm 安装的残留
npm uninstall -g @openclaw/claw

# 检查并删除可能的手动安装
sudo rm -f /usr/local/bin/openclaw
sudo rm -f /usr/local/bin/claw

# 验证命令已不存在
which openclaw
which claw

# 验证配置目录已删除
ls -la ~/.openclaw 2>/dev/null || echo "✅ 配置目录已清理"

2. 重新安装

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

---

五、常用指令速查表

指令	说明
openclaw init	重新初始化 OpenClaw 配置
openclaw models list	查看所有可用模型
openclaw models set <provider>/<model>	设置默认模型
openclaw config get	获取所有配置
openclaw config get models.providers.bailian/qwen-max.apiKey	检查百炼 API 密钥
openclaw config set channels.feishu.appId "ID"	设置飞书 App ID
openclaw gateway status	检查网关状态
openclaw --version	查看 OpenClaw 版本
openclaw config unset 'agents.defaults.model.primary'	清除默认模型设置
openclaw config unset 'agents.defaults.models.bailian/qwen-max-'	删除特定模型配置

---

六、重要提示

1. 配置优先级：别设置默认模型（provider），直接跳过，之后重新配置都行，不然所有的文件都只认第一次配置的，非常难更改。

2. 百炼 API 配置：通过 bash 写入配置是可靠的方式，其他方式可能有问题。

3. 本地模型：使用 Ollama 拉取模型后，配置 baseUrl 为 http://localhost:11434/v1 是最稳定的方式。

4. 权限问题：确保 ~/.openclaw 目录权限为 600，否则可能导致网关无法启动。

5. 重装流程：重装前务必清理旧配置，避免配置冲突。

---

七、常见问题解决

1. openclaw 命令未找到

# 检查 PATH 是否包含 npm 的全局 bin 目录
echo $PATH

# 如果没有，添加到 shell 配置文件
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. 百炼 API 配置失败

• 确保 API 密钥正确
• 检查网络是否能访问 https://dashscope.aliyun.com
• 重新使用 bash 写入方式配置

3. 网关无法启动

• 检查 ~/.openclaw 目录权限
• 确保 chmod 600 ~/.openclaw 和 chmod 700 ~/.openclaw 已执行

---

本攻略已整合所有可用指令，确保完整性和实用性。如需最新信息，请参考 OpenClaw 官方文档。