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 安装完会启动一个入门向导,问你要接哪个模型。

这一步其实就是告诉它:「脑子在哪儿」。

步骤如下:

  1. 当出现初始化界面,选择 Yes → 回车。

  2. 进入「快速配置 QuickStart」。

  3. 选择「自定义 API 接入」。

  4. 在提示输入 Base URL 时填入:

    https://api.openai-hub.com/v1
    
  5. 然后输入你的 API Key(在 openai-hub 控制台获取):

    sk-your-api-key
    
  6. 选择模型: 你可以选 GPT-4、Claude-3、Gemini、DeepSeek 等,全部走 OpenAI Hub,国内免代理直连。

  7. 回车确认完成配置。

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 的自动化任务功能,比如让它帮你定时汇总日报、自动整理文件或操作浏览器。它不只是会聊,还能自己“干活”。