其实我之前一直没太关注OpenClaw这个项目，直到上个月在一个技术群里看到有人用它做了个自动化的代码Review工具，我才开始认真了解。研究了一周之后，我的结论是：这东西的上手门槛被很多人高估了。网上不少教程写得特别复杂，又是Docker又是Node版本管理又是环境变量的一顿操作，看得新手望而却步。但实际上，如果你想快速体验它的核心功能，5分钟真的够了。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

这篇文章的定位就是——帮你用最短的时间跑通第一个对话。不讲底层架构，不深入配置文件，不走复杂的服务端部署流程。就是纯粹地：装上、启动、对话，三步到位。

先搞清楚你需要什么

在动手之前，先确认两件事：

1. 你需要一台能上网的电脑

Windows、macOS都行。OpenClaw官方提供的安装包已经把Node.js运行时打包进去了，所以你不需要自己装Node、npm这些东西。这一点很多教程都没说清楚，搞得新手以为必须先配一整套开发环境。

2. 你需要一个大语言模型的API Key

OpenClaw本身不包含大模型，它只是个调度框架。你需要至少一个LLM的API Key。目前支持的Provider还挺多的：

智谱AI (GLM系列)     → https://open.bigmodel.cn
DeepSeek             → https://platform.deepseek.com
OpenAI               → https://platform.openai.com
月之暗面 (Kimi)      → https://platform.moonshot.cn
通义千问             → https://dashscope.aliyun.com

如果你是第一次接触这类API，建议先注册一个智谱AI的账号——注册送一点免费额度，够你测试用的。

安装过程（真的就几步）

第一步：下载安装包

去官网下载对应系统的安装包。Windows用户直接下载.exe安装器，macOS用户注意区分Intel芯片和Apple芯片（M1/M2/M3）版本，别下错了。

安装过程全程自动，没有需要手动配置的地方。安装完成后，会在你的用户目录下创建 ~/.qclaw 这个配置目录。你可以在文件管理器里直接打开看：

# Windows
explorer %USERPROFILE%\.qclaw

# macOS
open ~/.qclaw

第二步：配置API Key

安装完成后第一次启动时，会弹出一个配置向导。如果没弹出来也没关系，手动创建配置文件就行。

在 ~/.qclaw 目录下创建一个 .env 文件，内容就一行：

ZHIPU_API_KEY=your_api_key_here

把 your_api_key_here 替换成你自己的Key就行。注意这个文件是隐藏文件（以点开头），在某些系统的文件管理器里默认看不到，需要开启"显示隐藏文件"选项。

如果你想用其他Provider的模型，Key的名字不一样。比如用DeepSeek的话就是 DEEPSEEK_API_KEY。具体对应关系可以在配置向导里看到，或者去官方文档查。

第三步：启动

# Windows用户，在开始菜单里找到OpenClaw快捷方式，直接双击

# 或者用命令行启动
openclaw gateway start

启动成功后，终端里会输出一行类似这样的日志：

[Gateway] Listening on http://0.0.0.0:3456

看到这行就说明服务跑起来了。打开浏览器，访问 http://localhost:3456，就能看到Web管理界面了。

第一次对话

在Web界面的聊天框里输入一条消息试试，比如"你好，介绍一下你自己"。

正常情况下，你会看到Agent的回复出现在几秒钟之内。这个回复的内容取决于Agent的人设配置——默认人设在 ~/.qclaw/workspace/soul.md 文件里，你可以随时修改。

如果这时候没收到回复，别慌。排查一下几个常见原因：

问题1: 终端报 "API Key not configured"
解决: 检查 .env 文件是否在 ~/.qclaw/ 目录下，文件名是否正确

问题2: 回复延迟很高（超过10秒）
解决: 检查你的网络是否能正常访问LLM的API地址
       国内的API（智谱、DeepSeek等）一般不会有这个问题
       如果用OpenAI的API，需要配置代理

问题3: 端口被占用，启动失败
解决: 在配置里把端口改一下，比如改成 3780
       gateway:
         port: 3780

说个题外话，我第一次测试的时候碰到了问题3。折腾了半天才发现是Windows的Hyper-V保留了一些端口范围，刚好把3456占了。后面我在另一台macOS上测试就没这个问题，看来是Windows独有的坑。

几个实用的小配置

跑通对话之后，你可能还想做一些个性化调整。下面列几个我常用的配置改动，都是改一行就能生效的：

换个模型

# 在 ~/.qclaw/config.yaml 里找到 models 部分，修改默认模型
models:
  - id: "my-deepseek"
    provider: "deepseek"
    baseUrl: "https://api.deepseek.com/v1"
    model: "deepseek-chat"    # 换成你想用的模型

修改Agent人设

直接编辑 ~/.qclaw/workspace/soul.md 文件。用任何文本编辑器打开，修改里面的内容就行。比如你想让Agent回复更简洁：

# soul.md 示例
你是一个简洁的AI助手。回复不超过三句话，直接给出答案，不要废话。

修改保存之后，下一次对话就会用新的人设。不需要重启服务，OpenClaw会在每次对话开始时重新读取soul.md。

开启记忆功能

OpenClaw的Agent有长期记忆能力——它会把重要的对话内容记录到 memory.md 文件里，下次对话时会参考这些记忆。这个功能默认是开启的。如果你想清空记忆重新开始，直接删除或清空 ~/.qclaw/workspace/memory.md 就行。

关于Skill插件的简单说明

你可能在文档里看到"Skill"这个词。简单解释一下：Skill就是OpenClaw的功能插件。默认安装会带几个基础Skill（浏览器控制、文件操作、定时任务等），开箱即用，你不需要手动安装什么。

比如你跟Agent说"帮我搜索一下XXX"，它会自动调用浏览器相关的Skill来完成任务。这个过程是Agent自己判断的，你不需要手动指定用哪个Skill。

后续如果你想扩展功能（比如接邮件、接日历、接数据库），再去研究Skill的安装和配置也不迟。对于刚上手的新手来说，默认的Skill已经够用了。

写在后面

OpenClaw的文档说实话还有不少地方写得不够清晰，这也是我决定写这篇快速上手指南的原因——把那些弯弯绕绕的说明简化成最核心的步骤，帮大家省点时间。

这5分钟的教程只能带你入门。后面还有很多可以深入玩的东西，比如多Agent协作、Skill自定义开发、定时任务调度等等。但那些都是后面的事了，先把第一步走通才是最重要的。