一、安装前准备
在开始之前，请确认你的操作系统
支持的操作系统
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
运行项目并下载源码
bash
1
执行后的结果如下：
第2步 确认提示 （✅ Yes）
安装完成后，会自动启动新手引导，如下图：
这些信息是安装与首次启动说明
当你第一次运行 openclaw，终端里会看到这一大段“很吓人”的 ASCII 画和安全提示。
别慌，它主要在做 三件事：
告诉你：这是个很强但也很危险的工具
提醒你：不要不懂就直接上线
给你一套最低限度的安全建议
强制风险确认（你必须明确表示：“我知道它很强，也知道有风险”）
这一步必须选择 “Yes”（使用键盘左右键切换选项）。
第3步 引导模式选择（✅ QuickStart）
选项 含义 适合谁
QuickStart 使用推荐的默认配置先跑起来，细节之后再用 openclaw configure调整 第一次使用 / 想快速体验
Manual 手动逐项配置所有选项 对配置和安全有经验的用户
第4步 选择模型来源（推荐自定义）
选择 OpenClaw 使用哪家模型服务，以及如何完成认证。
选项如何理解？
选项类型 含义
OpenAI / Anthropic / Google 等 使用国外官方模型服务
MiniMax / Qwen / Moonshot / GLM 国内模型厂商
OpenRouter / Vercel AI Gateway 多模型聚合 / 代理网关
Copilot 使用已有 Copilot 授权
Synthetic 本地或测试用的模拟模型
Custom Provider 这个选项专门用于接入任何兼容 OpenAI 或 Anthropic 格式的第三方 API 端点。你可以自由设置 Base URL（例如 Qwen 的地址）、API Key 和模型名称
Skip for now 暂时跳过
怎么选比较合适？
第一次用 / 想省事 → 选你已经有 Key 的厂商
需要多模型切换 → OpenRouter / Gateway 类
列表没有，但想用自己购买的apikey： → Custom Provider
只想先装好 → Skip for now（之后再配）
这里新手推荐 Qwen ，完全免费（有配合限制），快速搭建尝试可以。
开发者或者深度使用的用户，推荐选择Custom Provider，选择后需要进行以下几步。
需要手动输入 API Base URL ，厂商的示例代码里面可以拿到
需要手动输入 API Key ，需要自己去对应的厂商平台创建
选择兼容的端点，我以Qwen为例，兼容OpenAI，所以选择 OpenAI 端点
需要手动输入 Model ID ，也是在对应厂商平台可以拿到
⚠️2026-03-06更新：注意，大家使用的时候，一定要用有免费额度的名称，快照名称是没有免费额度的，我已经踩坑了，给大家提个醒
自动生成 Endpoint ID ，是给当前自定义配置起的一个标识名称，方便你在以后有多个自定义端点时区分它们。默认生成的 custom-dashscope-aliyuncs-com 是基于你填写的 Base URL 自动转换的（去掉了特殊符号），已经能反映用途，所以一般不用修改
什么情况下建议修改？
如果你未来可能配置多个自定义端点（例如同时接入 Qwen、智谱、DeepSeek 等），建议改成更容易识别的名称，比如 Qwen-DashScope 或 阿里云通义。
如果只有一个自定义端点，保持默认完全没问题，不影响使用。
Model alias 是一个可选字段，用于给当前模型起一个容易识别的名字 ，我这里使用的是 Qwen-Plus“。
如果不填写，后续列表中可能会直接显示模型 ID（如 qwen-plus）。
如果填写，例如 Qwen-Plus 或 我的通义模型，那么在切换模型时，这个名字会出现在列表中，更方便区分。
第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 加“自动化小助手”，以及加哪些。
Hook 用途 是否推荐
🚀 boot-md 启动时加载一段初始化说明（如使用说明、约定） ✅ 新手可选
📎 bootstrap-extra-files 初始化时添加自定义的 prompt 模板或系统消息文件 ✅ 新手可选
📝 command-logger 记录你执行过的命令 ⚠️ 调试用
💾 session-memory 在特定命令时保存会话上下文 ✅ 很实用
如何选？
🟢 新手推荐（安全、实用）
☑ session-memory
☑ boot-md（可选）
☑ bootstrap-extra-files（可选）
🟡 不确定 / 想保持最简
☑ Skip for now
🔴 不建议一开始就选
command-logger
除非你在调试或排查问题（可能涉及隐私 / 日志量）
按空格键先中需要的选项
第8步 Gateway 服务重启（✅ Restart）
这一步其实是两个独立但连续的确认：
① Hooks 已配置完成，② Gateway 服务怎么处理。
选项 含义 什么时候选
Restart（推荐） 重启现有 Gateway 升级后 / 正常情况
Reinstall 删除后重新安装 Gateway Gateway 异常或损坏
Skip 什么都不做 暂时不打算启动
怎么选？
选 Restart
只有：
Gateway 起不来
行为异常
配置严重乱了
才需要 Reinstall
第9步 选择启动方式（✅ Hatch in TUI ）
这是“最后一步：你准备用什么方式正式启动（孵化）你的 OpenClaw 代理”。
怎么选？
选项 什么时候选
Hatch in TUI ⭐ 第一次用，强烈推荐
Open the Web UI 想用网页操作
Do this later 先装好，暂时不用
三、打开web页面
执行命令：
openclaw dashboard
运行项目并下载源码
bash
1
结果如下：
到这里已经成功安装完成，如果安装过程有遇到问题，可以参考下面的踩坑教程，或者想要修改模型，也可以参考
四、卸载OpenClaw
步骤一：使用官方命令卸载（首选方法）
这是最干净、最省心的方式，前提是 OpenClaw 的命令行工具还能正常运行。
1. 打开”终端”（在”启动台”的”其他”文件夹里）。
2. 输入以下命令并回车。这个命令会移除 OpenClaw 的服务、配置和状态文件。
openclaw uninstall –all –yes –non-interactive
运行项目并下载源码
bash
1
–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
运行项目并下载源码
bash
1
2
3
4
5
6
7
2. 删除所有相关文件和配置目录
这会删除 OpenClaw 的核心程序、配置文件、聊天记录以及它下载的各种技能。
# 删除应用（如果安装在 Applications 文件夹）
rm -rf /Applications/OpenClaw.app
# 删除所有配置和数据目录
rm -rf ~/.openclaw ~/.clawdbot ~/.moltbot
rm -rf ~/.molthub ~/molthub-cache ~/.local/share/openclaw/
运行项目并下载源码
bash
1
2
3
4
5
6
3. 卸载命令行工具（ CLI ）
最后，移除 openclaw 命令本身。
# 如果你是通过 npm 安装的
npm uninstall -g openclaw
npm uninstall -g moltbot
npm uninstall -g clawdbot
# （可选）如果上面的命令没找到，可以强制删除可执行文件
sudo rm -f /usr/local/bin/openclaw
sudo rm -f /opt/homebrew/bin/openclaw
运行项目并下载源码
bash
1
2
3
4
5
6
7
8
4. 清理 shell 配置中的残留
之前你遇到过 .zshrc 中残留 source 行导致报错。再次检查并清理：
# 编辑 ~/.zshrc
nano ~/.zshrc
运行项目并下载源码
bash
1
2
查找并删除或注释掉任何包含 openclaw、moltbot、clawdbot 的行，尤其是类似：
source /Users/5i5j/.openclaw/completions/openclaw.zsh
运行项目并下载源码
bash
1
保存文件后，重新加载配置：
source ~/.zshrc
运行项目并下载源码
bash
1
5. 检查 npm 全局安装目录是否还有残留
ls -la /opt/homebrew/lib/node_modules | grep -E ‘openclaw|molt|claw’
运行项目并下载源码
bash
1
如果有输出，可以手动删除：
rm -rf /opt/homebrew/lib/node_modules/openclaw
rm -rf /opt/homebrew/lib/node_modules/moltbot
rm -rf /opt/homebrew/lib/node_modules/clawdbot
运行项目并下载源码
bash
1
2
3
6. 验证卸载结果
运行以下命令，确保没有任何 openclaw 相关文件残留：
which openclaw
ls -la ~/.openclaw 2>/dev/null
ls -la /opt/homebrew/bin/openclaw 2>/dev/null
运行项目并下载源码
bash
1
2
3
如果全部返回“没有这个文件或目录”，说明本地卸载完成。
额外提醒：撤销云端授权
五、安装过程报错：
一、配置网关后重启报错
报错如下图：
可以先执行openclaw gateway status 查看输出结果，会展示出来需要查看哪些错误日志
📂 请查看以下日志文件
根据之前 openclaw gateway status 的输出，有两个关键日志文件可能包含错误信息：
1.标准错误日志（最可能直接显示崩溃原因）：
cat ~/.openclaw/logs/gateway.err.log
运行项目并下载源码
bash
1
2.本次启动的详细文件日志：
cat /tmp/openclaw/openclaw-2026-02-25.log
运行项目并下载源码
bash
1
3.日志信息如下：
错误日志：网关启动被阻止，因为 gateway.mode 配置项未设置。默认情况下，OpenClaw 要求明确指定运行模式（通常是 local）以确保安全。
🔧 立即修复
运行以下命令设置 gateway.mode 为 local：
openclaw config set gateway.mode local
运行项目并下载源码
bash
1
然后重启网关服务：
openclaw gateway restart
运行项目并下载源码
bash
1
二、启动后模型上下文窗口太小错误
这个错误是因为 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
运行项目并下载源码
bash
1
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 等）保持原样不动 …
}
运行项目并下载源码
json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
如果你的文件里没有 “models” 这一整段，就把从 { “models”: { … } } 的内容完整复制进去。
3. 重启 OpenClaw 网关并开启新会话
保存文件并退出编辑器后，在终端执行以下命令使配置生效：
# 1. 重启网关
openclaw gateway restart
# 2. 在TUI界面中，发送 /new 命令开始一个全新的会话
# 这一步非常重要，旧的会话仍然会保留旧的（4096）限制
运行项目并下载源码
bash
1
2
3
4
5
在 TUI 中：输入 /new 然后回车，这将创建一个全新的会话，并重新加载模型配置。
完成以上步骤后，再尝试你的任务，应该就不会再报错了。你配置的 contextWindow 值会覆盖掉原来的 4096 限制，让 Agent 拥有完整的记忆能力。
重新配置密钥&模型命令
启动时报错提示没有密钥，推荐使用 CLI 命令配置（自动处理文件格式和权限），执行下面命令，可重新配置模型，同首次配置交互一致
openclaw agents add main
运行项目并下载源码
bash
1
从头开始配置命令
如果你想从头开始，完整地再次配置模型、网关、通道和 Skills，可以运行：
openclaw onboard
运行项目并下载源码
bash
1
修改模型配置文件
找到配置文件：通常位于 ~/.openclaw/openclaw.json。
修改配置：找到 models.providers 下面的 anthropic 部分，同时修改以下两项：
baseUrl：改为你的代理服务地址（例如 EvoLink 是 https://code.evolink.ai）
apiKey：改为你的代理服务 API Key
修改后的示例（以 EvoLink 为例）：
{
“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”
}
}
}
}
运行项目并下载源码
原文链接：https://blog.csdn.net/qq_44945384/article/details/158424336
© 版权声明
THE END
暂无评论内容