OpenClaw自定义模型MAC安装教程

一、安装前准备

在开始之前，请确认你的操作系统

支持的操作系统

• macOS（Intel / Apple Silicon）
• Windows 10 / Windows 11（64 位）👉 请参考Windows 安装

请根据你的系统，阅读对应的安装部分即可

后续配置与使用步骤完全一致。

完成本文后你将得到什么？

完成本文所有步骤后，你将可以：

• 在本地成功运行 OpenClaw
• 在浏览器中打开 OpenClaw 的 Web UI
• 直接通过网页与 OpenClaw 对话和使用它

二、安装 OpenClaw（原Clawdbot）

第1步 在线安装 OpenClaw

在 Terminal 中执行：

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

执行后的结果如下：

第2步 确认提示 （✅ Yes）

安装完成后，会自动启动新手引导，如下图：

这些信息是安装与首次启动说明
当你第一次运行 openclaw，终端里会看到这一大段“很吓人”的 ASCII 画和安全提示。
别慌，它主要在做 三件事：告诉你：这是个很强但也很危险的工具提醒你：不要不懂就直接上线给你一套最低限度的安全建议强制风险确认（你必须明确表示：“我知道它很强，也知道有风险”）

这一步必须选择 “Yes”（使用键盘左右键切换选项）。

第3步 引导模式选择（✅ QuickStart）

第4步 选择模型来源（推荐自定义）

选择 OpenClaw 使用哪家模型服务，以及如何完成认证。

选项如何理解？

• 第一次用 / 想省事 → 选你已经有 Key 的厂商
• 需要多模型切换 → OpenRouter / Gateway 类
• 列表没有，但想用自己购买的apikey： → Custom Provider
• 只想先装好 → Skip for now（之后再配）

这里新手推荐Qwen，完全免费（有配合限制），快速搭建尝试可以。

开发者或者深度使用的用户，推荐选择Custom Provider，选择后需要进行以下几步。

1. 需要手动输入 API Base URL ，厂商的示例代码里面可以拿到
2. 需要手动输入 API Key ，需要自己去对应的厂商平台创建
3. 选择兼容的端点，我以Qwen为例，兼容OpenAI，所以选择 OpenAI 端点
4. 自动生成 Endpoint ID ，是给当前自定义配置起的一个标识名称，方便你在以后有多个自定义端点时区分它们。默认生成的 custom-dashscope-aliyuncs-com 是基于你填写的 Base URL 自动转换的（去掉了特殊符号），已经能反映用途，所以一般不用修改
5. 什么情况下建议修改？
   • 如果你未来可能配置多个自定义端点（例如同时接入 Qwen、智谱、DeepSeek 等），建议改成更容易识别的名称，比如 Qwen-DashScope 或 阿里云通义。
   • 如果只有一个自定义端点，保持默认完全没问题，不影响使用。
6. Model alias 是一个可选字段，用于给当前模型起一个容易识别的名字 ，我这里使用的是Qwen-Plus``。
   • 如果不填写，后续列表中可能会直接显示模型 ID（如 qwen-plus）。
   • 如果填写，例如 Qwen-Plus 或 我的通义模型，那么在切换模型时，这个名字会出现在列表中，更方便区分。

需要手动输入 Model ID ，也是在对应厂商平台可以拿到

⚠️2026-03-06更新：注意，大家使用的时候，一定要用有免费额度的名称，快照名称是没有免费额度的，我已经踩坑了，给大家提个醒

第5步 选择对话渠道（✅ Skip for now）

这一步是在告诉我们：OpenClaw 现在“接到哪里说话”，以及这些聊天渠道是怎么工作的。不是必须立刻配。

此次我们使用WebUI对话，因此我们跳过这一步，后面再配置即可。

第6步 配置工具集（✅ No）

这一步是在讲 OpenClaw“现在能干多少活”，以及问要不要现在就把能力补齐。

Skills = OpenClaw 可以使用的能力 / 工具集合
比如：读文件、跑命令、调用 API、搜索、写代码等。

Skills status:

Eligible: 4
当前环境下，只有 4 个技能满足条件，可以直接用Missing requirements: 47
有 47 个技能因为缺依赖 / 没配置 / 权限不足，暂时不可用
（比如没装工具、没授权、没开启）Blocked by allowlist: 0
没有技能被你主动“禁止”

Configure skills now? (recommended)

这是在问你：
要不要现在就帮你把可用技能配置好？

• Yes
  • 安装必要依赖
  • 引导你启用常用能力
  • 新手更省事
• No
  • 以后再配
  • OpenClaw 仍然能用，但“能干的事很少”

第7步 添加自动化小助手(✅ session-memory ✅ boot-md)

这一步是在问你要不要给 OpenClaw 加“自动化小助手”，以及加哪些。

如何选？

🟢 新手推荐（安全、实用）

• ☑ session-memory
• ☑ boot-md（可选）
• ☑ bootstrap-extra-files（可选）

🟡 不确定 / 想保持最简

• ☑ Skip for now

🔴 不建议一开始就选

• command-logger
• 除非你在调试或排查问题（可能涉及隐私 / 日志量）

按空格键先中需要的选项

第8步 Gateway 服务重启（✅ Restart）

这一步其实是两个独立但连续的确认：
① Hooks 已配置完成，② Gateway 服务怎么处理。

怎么选？

• 选 Restart
• 只有：
  • Gateway 起不来
  • 行为异常
  • 配置严重乱了
    才需要 Reinstall

第9步 选择启动方式（✅ Hatch in TUI ）

这是“最后一步：你准备用什么方式正式启动（孵化）你的 OpenClaw 代理”。

怎么选？

三、打开web页面

执行命令：

openclaw dashboard 

结果如下：

到这里已经成功安装完成，如果安装过程有遇到问题，可以参考下面的踩坑教程，或者想要修改模型，也可以参考

四、卸载OpenClaw

步骤一：使用官方命令卸载（首选方法）

这是最干净、最省心的方式，前提是 OpenClaw 的命令行工具还能正常运行。

1. 打开"终端"（在"启动台"的"其他"文件夹里）。

2. 输入以下命令并回车。这个命令会移除 OpenClaw 的服务、配置和状态文件。

openclaw uninstall --all--yes --non-interactive 

• --all：移除所有组件。
• --yes：跳过所有确认提示。
• --non-interactive：以非交互模式运行，确保静默卸载。

执行结果如下：

步骤二：如果官方命令不可用，进行手动清理

如果你已经不小心删除了 openclaw 命令，或者上面的命令没能完全清理干净，就需要手动操作了。别担心，跟着下面的代码一步步来。

1. 停止并移除后台服务（LaunchAgent）

OpenClaw 会在后台运行一个守护进程，即使你关了终端它也可能在运行。我们必须先把它停掉并移除。

# 卸载并禁用 LaunchAgent 服务（阻止开机自启） launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist 2>/dev/null launchctl disable gui/$(id-u)/com.openclaw.gateway # 删除服务的配置文件rm-f ~/Library/LaunchAgents/com.openclaw.gateway.plist rm-f ~/Library/LaunchAgents/bot.molt.gateway.plist 2>/dev/null 

2. 删除所有相关文件和配置目录

这会删除 OpenClaw 的核心程序、配置文件、聊天记录以及它下载的各种技能。

# 删除应用（如果安装在 Applications 文件夹）rm-rf /Applications/OpenClaw.app # 删除所有配置和数据目录rm-rf ~/.openclaw ~/.clawdbot ~/.moltbot rm-rf ~/.molthub ~/molthub-cache ~/.local/share/openclaw/ 

3. 卸载命令行工具（CLI）

最后，移除 openclaw 命令本身。

# 如果你是通过 npm 安装的npm uninstall -g openclaw npm uninstall -g moltbot npm uninstall -g clawdbot # （可选）如果上面的命令没找到，可以强制删除可执行文件sudorm-f /usr/local/bin/openclaw sudorm-f /opt/homebrew/bin/openclaw 

4. 清理 shell 配置中的残留

之前你遇到过 .zshrc 中残留 source 行导致报错。再次检查并清理：

# 编辑 ~/.zshrcnano ~/.zshrc 

查找并删除或注释掉任何包含 openclaw、moltbot、clawdbot 的行，尤其是类似：

source /Users/5i5j/.openclaw/completions/openclaw.zsh 

保存文件后，重新加载配置：

source ~/.zshrc 

5. 检查 npm 全局安装目录是否还有残留

ls-la /opt/homebrew/lib/node_modules |grep-E'openclaw|molt|claw'

如果有输出，可以手动删除：

rm-rf /opt/homebrew/lib/node_modules/openclaw rm-rf /opt/homebrew/lib/node_modules/moltbot rm-rf /opt/homebrew/lib/node_modules/clawdbot 

6. 验证卸载结果

运行以下命令，确保没有任何 openclaw 相关文件残留：

which openclaw ls-la ~/.openclaw 2>/dev/null ls-la /opt/homebrew/bin/openclaw 2>/dev/null 

如果全部返回“没有这个文件或目录”，说明本地卸载完成。

额外提醒：撤销云端授权

五、安装过程报错：

一、配置网关后重启报错

报错如下图：

可以先执行openclaw gateway status 查看输出结果，会展示出来需要查看哪些错误日志

📂 请查看以下日志文件

根据之前 openclaw gateway status 的输出，有两个关键日志文件可能包含错误信息：

1.标准错误日志（最可能直接显示崩溃原因）：

cat ~/.openclaw/logs/gateway.err.log 

2.本次启动的详细文件日志：

cat /tmp/openclaw/openclaw-2026-02-25.log 

3.日志信息如下：

错误日志：网关启动被阻止，因为 gateway.mode 配置项未设置。默认情况下，OpenClaw 要求明确指定运行模式（通常是 local）以确保安全。

🔧 立即修复

运行以下命令设置 gateway.mode 为 local：

openclaw config set gateway.mode local

然后重启网关服务：

openclaw gateway restart 

二、启动后模型上下文窗口太小错误

这个错误是因为 OpenClaw 没有正确识别出 Qwen 模型的真实上下文窗口大小。

你选择的 qwen3.5-plus-02-15 模型实际支持 100万（1M）tokens 的上下文，但 OpenClaw 在自动检测时把它当成了一个“不认识”的模型，出于安全保守的考虑，默认给它加上了 4096 tokens 的严格限制。而 OpenClaw 的 Agent 功能至少需要 16000 tokens 才能正常运行，所以就报错了。

解决方法：手动覆写模型参数

你需要通过修改 OpenClaw 的配置文件，手动告诉它这个模型的真实能力。核心是修改 ~/.openclaw/openclaw.json 文件。

操作步骤：

1. 找到并打开配置文件

在终端中运行以下命令来编辑配置文件（如果 nano 不好用，可以用 vim 或直接用文本编辑器打开）：

nano ~/.openclaw/openclaw.json 

2. 修改 models 配置段

找到文件中的 "models" 这一部分（如果不存在，就手动添加）。你需要做两件事：

• 将 "mode" 设置为 "merge"，这会让你的手动配置覆盖掉系统的自动检测。
• 在你配置的 Qwen 模型条目下，明确指定 "contextWindow" 和 "maxTokens" 参数。

请参考下面的结构进行修改（注意替换 your-api-key 和确认 baseUrl）：

{"models":{"mode":"merge",// <--- 关键：告诉系统以我的配置为准"providers":{"custom-dashscope-aliyuncs-com":{// 这串名字是你之前配置 Endpoint ID 时生成的，请确认一致"baseUrl":"https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey":"sk-你的真实API密钥","api":"openai-completions","models":[{"id":"qwen3.5-plus-02-15",// 你选择的模型ID"name":"Qwen 3.5 Plus",// 一个友好的名字"contextWindow":1000000,// <--- 手动设置为 1,000,000"maxTokens":8192,// <--- 或设为 64000，根据模型实际支持情况调整"input":["text"],"reasoning":true}]}}},// ... 文件中的其他配置（如 agents 等）保持原样不动 ...}

如果你的文件里没有 "models" 这一整段，就把从 { "models": { ... } } 的内容完整复制进去。

3. 重启 OpenClaw 网关并开启新会话

保存文件并退出编辑器后，在终端执行以下命令使配置生效：

# 1. 重启网关 openclaw gateway restart # 2. 在TUI界面中，发送 /new 命令开始一个全新的会话# 这一步非常重要，旧的会话仍然会保留旧的（4096）限制

在 TUI 中：输入 /new 然后回车，这将创建一个全新的会话，并重新加载模型配置。

完成以上步骤后，再尝试你的任务，应该就不会再报错了。你配置的 contextWindow 值会覆盖掉原来的 4096 限制，让 Agent 拥有完整的记忆能力。

重新配置密钥&模型命令

启动时报错提示没有密钥，推荐使用 CLI 命令配置（自动处理文件格式和权限），执行下面命令，可重新配置模型，同首次配置交互一致

openclaw agents add main 

从头开始配置命令

如果你想从头开始，完整地再次配置模型、网关、通道和 Skills，可以运行：

openclaw onboard 

修改模型配置文件

1. 找到配置文件：通常位于 ~/.openclaw/openclaw.json。
2. 修改配置：找到 models.providers 下面的 anthropic 部分，同时修改以下两项：修改后的示例（以 EvoLink 为例）：
   • baseUrl：改为你的代理服务地址（例如 EvoLink 是 https://code.evolink.ai）
   • apiKey：改为你的代理服务 API Key

{"models":{"providers":{"anthropic":{"api":"anthropic-messages","baseUrl":"https://code.evolink.ai",// ✅ 必须改为代理地址"apiKey":"sk-your-evolink-key",// ✅ 必须用代理给你的 Key"models":[{"id":"claude-3-5-sonnet-20241022","name":"Claude Sonnet via EvoLink"}]}}},"agents":{"default":{"model":{"primary":"anthropic/claude-3-5-sonnet-20241022"}}}}

修改配置文件如果不好找，可以使用sublime来修改，执行如下命令就可以在sublime中打开配置文件了：

open-a"Sublime Text" ~/.openclaw/openclaw.json 

文档参考：https://blog.ZEEKLOG.net/tzchao111/article/details/157588555
文档参考：https://blog.ZEEKLOG.net/weixin_45110225/article/details/157724298