OpenClaw 首次安装教程

本教程面向从未安装过 OpenClaw 的用户，从零开始完成安装、初始化和接入一元模型。

前置条件

1. 前往 一元模型控制台 注册并获取 API Key（分组选择 cc7 或 cc5）
2. 安装 Node.js ≥ 22（注意版本要求比其他工具更高！）

验证 Node 版本：

node --version   # 需要 v22+

1. 安装 OpenClaw

npm install -g openclaw@latest
# 或使用 pnpm
pnpm add -g openclaw@latest

2. 运行初始化向导

openclaw onboard --install-daemon

3. 按向导提示逐步操作

步骤	选项	填写内容
Install daemon?	yes	—
Onboarding mode	选择第一个选项	—
Model/auth provider	Custom Provider	(Any OpenAI or Anthropic compatible endpoint)
API Base URL	—	https://timesniper.club
API Key	—	填入从 令牌页面 获取的 Key
Endpoint compatibility	Anthropic-compatible	(Uses /messages)
Model ID	—	claude-sonnet-4-6（或 claude-opus-4-6-thinking）
Endpoint ID	使用默认值	—
Model alias	—	可选，例如 claude-4.6
QuickStart / Skills / Hooks	可全部跳过	初次使用
How to hatch your bot?	Open the Web UI	方便查看界面

⚠️ Base URL 注意：使用 anthropic-messages API，Base URL 为 https://timesniper.club，不要加 /v1 后缀！

4. 优化配置参数

向导完成后，编辑 ~/.openclaw/openclaw.json，将默认参数提升：

• contextWindow: 从 4096 → 200000
• maxTokens: 从 4096 → 8192

👉 完整的配置文件模板可直接在 OpenClaw 配置模板（一键复制） 页面获取。

5. 可用模型

模型 ID	说明	深度推理
claude-sonnet-4-6	Claude 4.6 Sonnet，快速高效	❌
claude-sonnet-4-6-thinking	Claude 4.6 Sonnet 深度推理版	✅
claude-opus-4-6	Claude 4.6 Opus，最强能力	❌
claude-opus-4-6-thinking	Claude 4.6 Opus 深度推理版	✅

6. 开始使用

配置完成后，OpenClaw 自动打开 Web UI 界面。先发一条简单消息测试连通性，确认正常后再进行复杂任务。

---

常见问题与异常处理 (FAQ)

错误	原因	解决方案
401 Unauthorized	API Key 错误或为空	前往 一元模型控制台 重新获取密钥
404 Not Found	Base URL 格式错误	确认为 https://timesniper.club（不加 /v1）
429 Too Many Requests	请求频繁或额度耗尽	等待冷却或在充值页面充值
连接超时 / Network Error	网络或代理冲突	检查代理/VPN，确认 URL 无空格
模型不可用	contextWindow 或 maxTokens 过低	提升至 contextWindow: 200000、maxTokens: 8192

提示: 如果依然无法解决，请携带完整报错截图到客服群中寻求帮助。