由 joan 👋 大家好！欢迎来到 Jeniya 技术分享。
最近，OpenClaw 这款开源的 AI 个人助手在开发者圈子里彻底火了！🔥 它能直接运行在你自己的机器上，通过 Telegram、Slack、Discord 甚至专属的 Web 控制面板与你交互。帮你处理邮件、管理日历、写代码、控制智能家居、抓取网页数据……简直就是一个 24 小时待命的赛博私人助理！🤖
点击进入api中转站
很多小伙伴都在好奇，AI 打工人是否真的名副其实？但在实际部署的过程中，大家普遍卡在了一个痛点上：官方默认配置门槛较高，如何优雅地给 OpenClaw 接入第三方 API中转站，并自定义我们常用的 AI大模型API 呢？
今天，小编就为大家带来这篇硬核又通俗的 OpenClaw配置教程，帮你解决网络和接口的卡脖子难题，轻松调教属于你的最强 AI 助理！✨
📑 文章目录
- 一、安装与配置（从零到可用）
- 二、核心：接入第三方 API 中转站
- 三、启动与日常使用指南
- 四、OpenClaw 到底能做什么？
- 五、常用命令速查表
- 六、一分钟快速上手路线图
- 📚 参考链接
一、安装与配置（从零到可用）🛠️
整个过程其实非常清晰，主要分为 3 步：安装 OpenClaw → 运行初始化向导 → 配置网关。
1. 安装 OpenClaw
首先，你需要准备好 Node.js 环境。
- 环境要求：Node.js ≥ 22.12.0（如果没有，请先去 Node.js 官网下载安装）。
打开你的终端（Terminal / PowerShell），输入以下命令进行全局安装：
Bashnpm install -g openclaw
安装完成后，验证一下是否成功：
Bashopenclaw --version
🎉 如果看到版本号输出，恭喜你，第一步搞定！
(💡 补充：如果你喜欢折腾，官方也提供了脚本安装和源码编译安装的方式，具体可参考官方文档。)
2. 运行初始化向导 (Onboard)
接下来，我们要让 OpenClaw 认识它的新家：
Bashopenclaw onboard
这个向导会交互式地引导你完成基础设置。
- 安全提示：阅读后输入
Yes继续。 - 模式选择：强烈推荐选择 QuickStart，它会使用默认端口
18789并绑定127.0.0.1，非常省事。 - AI 模型 / API_KEY / Skills 等：这里可以先全部跳过（直接按回车），因为我们稍后会在第二部分统一配置更划算的 API中转站。
3. 配置网关服务（Gateway）⚠️ 必看避坑指南
网关是 OpenClaw 的心脏。很多小伙伴在这里遇到 Gateway service install failed 的报错，这通常是因为没有使用管理员权限！
你有两种选择：
- 方式一：前台运行（适合快速试用）
直接在终端执行openclaw gateway。注意：不要关闭这个黑框框，否则服务就断了。 - 方式二：守护进程（强烈推荐，可开机自启）
用管理员身份打开 PowerShell 或终端，重新执行openclaw gateway install，然后再执行openclaw gateway start。
🔑 重要提示： 向导结束时，屏幕上会显示一段带有 Token 的 Web UI 链接（例如：
http://127.0.0.1:18789/#token=你的token）。请务必把这个链接保存下来！ 后续访问控制台必须带上这个 Token，否则会报错。
二、核心：接入第三方 API 中转站 🌐
直接使用官方的 API 往往面临网络不通畅或者充值困难的问题。这时候，使用API中转站来调用 AI大模型API 就是最完美的解决方案。
这里我们以某支持 OpenAI / Anthropic / Gemini 协议的中转站（例如 Poixe）为例。如果你使用其他中转站，只需要修改 baseUrl 和 apiKey 即可。
📌 操作步骤：
- 找到本机的配置文件
openclaw.json：- Windows 路径：
C:\Users\你的用户名\.openclaw\openclaw.json - macOS / Linux 路径：
~/.openclaw/openclaw.json
- Windows 路径：
- 用 VS Code 或记事本打开它。
- 将里面的内容替换为下方的模板（⚠️ 注意替换为你自己的 API Key 和网关 Token）。
- 保存文件，重启网关服务，然后用带 Token 的链接访问 Web 控制台。
📝 配置文件模板 (openclaw.json)
JSON{
"wizard": {
"lastRunAt": "2026-02-28T05:57:22.460Z",
"lastRunVersion": "2026.2.26",
"lastRunCommand": "onboard",
"lastRunMode": "local"
},
"models": {
"providers": {
"poixeapi-openai": {
"baseUrl": "https://api.poixe.com/v1",
"apiKey": "YOUR_API_KEY_HERE",
"api": "openai-responses",
"models": [
{
"id": "gpt-5.3-codex",
"name": "GPT-5.3 Codex",
"reasoning": true,
"input": ["text", "image"],
"cost": { "input": 1.75, "output": 14, "cacheRead": 0.175, "cacheWrite": 0.175 },
"contextWindow": 400000,
"maxTokens": 128000
}
]
},
"poixeapi-claude": {
"baseUrl": "https://api.poixe.com",
"apiKey": "YOUR_API_KEY_HERE",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": true,
"input": ["text", "image"],
"cost": { "input": 5, "output": 25, "cacheRead": 0.5, "cacheWrite": 6.25 },
"contextWindow": 200000,
"maxTokens": 64000
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "poixeapi-openai/gpt-5.3-codex",
"fallbacks": [
"poixeapi-claude/claude-opus-4-6"
]
},
"models": {
"poixeapi-openai/gpt-5.3-codex": {},
"poixeapi-claude/claude-opus-4-6": {}
},
"workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace",
"contextPruning": { "mode": "cache-ttl", "ttl": "1h" },
"compaction": { "mode": "safeguard" },
"heartbeat": { "every": "30m" },
"maxConcurrent": 4,
"subagents": { "maxConcurrent": 8 }
}
},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": { "mode": "token", "token": "你的网关token（onboard 结束时显示的）" },
"tailscale": { "mode": "off", "resetOnExit": false },
"nodes": {
"denyCommands": [
"camera.snap", "camera.clip", "screen.record",
"calendar.add", "contacts.add", "reminders.add"
]
}
}
}
💡 细节提醒：Windows 系统的 workspace 路径必须用双反斜杠 \\；macOS/Linux 请改为类似 /Users/你的用户名/.openclaw/workspace 的格式。千万别把真实的 Token 发到网上哦！
三、启动与日常使用指南 💻
搞定了配置，怎么在日常中优雅地使用呢？首先你要分清两个概念：
| 组件 | 说明 | 是否需要一直开着？ |
|---|---|---|
| Gateway 守护进程 | 后台服务，负责连接渠道、处理消息，没有界面。 | ✅ 是（建议开机自启） |
| TUI / Web 控制面板 | 浏览器里的聊天界面，你和 AI 沟通的窗口。 | ❌ 否（想聊天时打开即可） |
🔄 日常使用姿势
如果你已经用管理员权限安装了守护进程，每次开机它都会默默在后台运行。你可以随时在终端输入 openclaw status，如果看到 Gateway service: running 就说明一切正常。
想要和 AI 对话时，只需输入：
Bashopenclaw dashboard
浏览器会自动弹出带有 Token 的控制台链接，开启你的 AI 冲浪之旅！🏄♂️
四、OpenClaw 到底能做什么？ 🪄
配置好了强大的 AI大模型API，OpenClaw 就不再是一个简单的聊天机器人了。它能干的活儿超乎你的想象：
- 💬 日常对话与问答：充当你的百科全书，总结长文章。
- ⌨️ 执行 Shell 与写代码：直接让 Bot 帮你写脚本并运行（注意给好权限哦）。
- 📧 邮件管理：接入 Gmail，帮你读未读邮件、自动起草回复。
- 📅 日历与提醒：一句话帮你安排会议、设定备忘录。
- 🕷️ 网页抓取：自动访问指定网页，提取核心数据保存到本地。
- 📂 文件操作：帮你整理杂乱的文件夹，批量重命名。
五、常用命令速查表 📋
把这个表格收藏起来，日常维护不用愁：
| 命令 | 作用说明 |
|---|---|
openclaw onboard | 初始化配置向导（重置神器） |
openclaw gateway start | 启动网关守护进程（后台默默打工） |
openclaw dashboard | 打开 Web 聊天控制面板 |
openclaw status | 查看当前运行状态 |
openclaw logs --follow | 实时查看运行日志（排错必备） |
openclaw daemon install | 安装后台守护进程（需管理员权限） |
六、一分钟快速上手路线图 🗺️
为了方便大家复习，这里总结一条极简路线：
- 装环境：装 Node 22+ -> 执行
npm install -g openclaw-> 跑openclaw onboard。 - 改配置：打开
openclaw.json，把 API中转站 的baseUrl和apiKey填进去，配置好 AI大模型API。 - 跑起来：执行
openclaw gateway start，然后用带 Token 的链接打开浏览器，开始享受！
📚 参考链接
- 更多技术干货，欢迎常来逛逛：Jeniya 技术分享
- OpenClaw 官网：
https://openclaw.ai/ - 官方文档：
https://docs.openclaw.ai/ - GitHub 源码：
https://github.com/openclaw/openclaw
小编有话说：
AI 时代，拥有一个专属的智能助理不再是科幻电影里的情节。希望这篇 OpenClaw配置教程 能帮你顺利跨过 API 接入的门槛。如果在配置过程中遇到任何问题，欢迎在评论区留言交流，我们一起折腾，一起进步！💪✨