OpenClaw自定义模型MAC安装教程

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

支持的操作系统

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

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

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

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

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

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

在 Terminal 中执行：

1. 告诉你：这是个很强但也很危险的工具
2. 提醒你：不要不懂就直接上线
3. 给你一套最低限度的安全建议
4. 强制风险确认（你必须明确表示：“我知道它很强，也知道有风险”）

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

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

选项如何理解？

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

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

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

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

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

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

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

Skills status:

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

Configure skills now? (recommended)

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

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

如何选？

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

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

🟡 不确定 / 想保持最简

• ☑ Skip for now

🔴 不建议一开始就选

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

按空格键先中需要的选项

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

怎么选？

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

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

怎么选？

执行命令：

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

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

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

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

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

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

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

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

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

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

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

最后，移除  命令本身。

4. 清理 shell 配置中的残留

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

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

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

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

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

6. 验证卸载结果

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

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

报错如下图：

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

📂 请查看以下日志文件

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

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

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

3.日志信息如下：

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

🔧 立即修复

运行以下命令设置  为 ：

然后重启网关服务：

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

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

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

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

操作步骤：

1. 找到并打开配置文件

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

2. 修改  配置段

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

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

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

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

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

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

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

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

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

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

1. 找到配置文件：通常位于 。
2. 修改配置：找到  下面的  部分，同时修改以下两项：
   • ：改为你的代理服务地址（例如 EvoLink 是 ）
   • ：改为你的代理服务 API Key

   修改后的示例（以 EvoLink 为例）：

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