OpenClaw
这份教程帮你在Mac、Windows或Linux上快速安装OpenClaw,并通过OpenAI Hub配置GPT/Claude/Gemini等大模型,无需代理即可直连。
快速接入 OpenClaw(龙虾)自动化智能体框架
这篇教程帮你在本地或服务器上快速跑通 OpenClaw,并让它用 OpenAI Hub 的模型 API 动起来。
一、安装 OpenClaw
不管你是 Mac、Linux 还是 Windows,都支持一键安装。一套脚本自动检测 Node.js(要 ≥ v22),没装的话它会帮你装上。
✅ macOS 或 Linux:
打开终端,执行:
# 官方安装脚本(推荐)
curl -fsSL https://openclaw.ai/install.sh | bash
# 网络卡的话可以用国内源脚本(更稳)
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
执行过程中会提示输入电脑密码(输入时不显示,直接敲回车)。
搞定后让环境变量生效:
# 如果你用的是 zsh(Mac 默认)
source ~/.zshrc
# 如果是 bash
source ~/.bash_profile
验证是否安装成功:
openclaw --version
能看到版本号(类似 2026.x.x)就说明 OK。
✅ Windows:
用管理员身份打开 PowerShell,执行:
iwr -useb https://openclaw.ai/install.ps1 | iex
注意这里有个坑:一定要“以管理员身份运行”PowerShell,否则 Node.js 安装可能卡住。
二、配置大模型 API(用 OpenAI Hub)
OpenClaw 安装完会启动一个入门向导,问你要接哪个模型。
这一步其实就是告诉它:「脑子在哪儿」。
步骤如下:
当出现初始化界面,选择
Yes→ 回车。进入「快速配置 QuickStart」。
选择「自定义 API 接入」。
在提示输入 Base URL 时填入:
https://api.openai-hub.com/v1然后输入你的 API Key(在 openai-hub 控制台获取):
sk-your-api-key选择模型: 你可以选 GPT-4、Claude-3、Gemini、DeepSeek 等,全部走 OpenAI Hub,国内免代理直连。
回车确认完成配置。
OpenClaw 会自动测试连通性,看到 “✅ Model connect success” 就说明模型接好了。
三、验证是否能跑通
在终端输入:
openclaw tui
这会启动一个终端界面(text UI),你直接和 OpenClaw 聊天,比如:
帮我整理一下今天的待办安排
如果模型回答正常,说明已经完全接通。
注意这里有个坑:如果报错 Unauthorized,检查是不是 Key 前后多了空格或者有中文符号。
四、扩展技能 Skills(选做)
OpenClaw 的 Skill 有点像 Chrome 插件,是它干活的「手脚」。想让它处理文件、发邮件或监控任务,可以装技能包。
安装方式:
# 查看当前能用的技能
openclaw skill list
# 安装一个 Skill,例如 PDF 处理
openclaw skill install pdf-kit
技能装好后,就能直接用自然语言触发,比如:
把这份 PDF 压缩到 10MB 以内
Skill 默认安装在:
~/.openclaw/skills
别随意改路径,不然 OpenClaw 会找不到文件。
五、常见问题
Q1:说找不到 Node.js?
执行 node -v 看看版本号是不是 22 以上,不够的话重装一遍。
Q2:配置完模型还是没反应?
执行:
openclaw service restart
再试一次。
Q3:我在中国大陆,联网报错?
用 OpenAI Hub 的域名 https://api.openai-hub.com/v1 代替官方接口,直连无需代理。
下一步可以试试
玩玩 OpenClaw 的自动化任务功能,比如让它帮你定时汇总日报、自动整理文件或操作浏览器。它不只是会聊,还能自己“干活”。