首页 / 教程 / 第一次对话
⏱️ 预计 5 分钟
🟢 入门
📋 前置:安装 OpenClaw
🎯 学完这一课,你将能够:
  • 打开 OpenClaw 控制台
  • 发送第一条消息
  • 获得 AI 的回复

学习目标

打开 OpenClaw 的控制台界面,和 AI 助手完成你的第一次聊天。

概念解释

OpenClaw 安装好之后,你的电脑就像多了一个”AI 前台”。这个前台有两种使用方式:一种是打开浏览器,就像打开一个网页聊天工具,跟 AI 打字交流;另一种是在终端里用命令行直接发消息,就像给 AI 发短信。这一课我们先用最直观的浏览器方式来体验,因为界面更友好、更容易上手。

动手做

第一步:确认 Gateway 正在运行

在打开控制台之前,先确认 OpenClaw 的 Gateway(网关服务)正在运行。

打开终端,输入:

openclaw gateway status

如果显示 runninghealthy,直接跳到第二步。

如果显示未运行,先启动它:

openclaw gateway --port 18789

看到类似 Gateway listening on port 18789 的提示,就说明启动成功了。

注意: 这种前台运行模式下,终端窗口不能关闭。如果你想继续用这个终端窗口做其他事情,可以新开一个终端标签页(Mac/Linux 按 Command + TCtrl + Shift + T,Windows Terminal 按 Ctrl + Shift + T)。


第二步:打开控制台

在终端中运行:

openclaw dashboard

执行后,你的浏览器会自动打开一个新标签页,地址是:

http://127.0.0.1:18789/

如果浏览器没有自动打开? 没关系,手动打开浏览器,在地址栏输入 http://127.0.0.1:18789/ 然后按回车,效果是一样的。

你应该能看到 OpenClaw 的控制台界面,中间有一个聊天输入框。


第三步:发送你的第一条消息

在聊天输入框中,输入以下内容:

你好,请介绍一下你自己

然后按 回车(或点击发送按钮)。

等待几秒钟,你会看到 AI 开始”打字”,逐渐显示出回复内容。这就像在微信里等对方回复一样。

你可能会看到类似这样的回复:

你好!我是你的 AI 助手,由 OpenClaw 提供网关服务。我可以帮你回答问题、写文案、写代码、翻译文本等等。有什么我可以帮你的吗?

恭喜你!你已经成功和 AI 完成了第一次对话!


第四步:试试更多对话

现在你已经知道怎么聊天了,试着发送下面这些问题,体验一下 AI 的能力:

实用型问题:

帮我写一个一周工作计划模板

创意型问题:

帮我给一只橘色的小猫起名字,要可爱一点

技术型问题:

用简单的语言解释一下什么是人工智能

每次发送后,观察 AI 的回复速度和内容质量。你会发现它能处理各种类型的问题。


第五步(进阶):用命令行发消息

除了浏览器界面,你也可以直接在终端里发消息。这种方式适合你只想快速问一个问题、不想打开浏览器的时候。

在终端中运行:

openclaw message send --message "你好,这是通过命令行发的消息"

你会直接在终端中看到 AI 的回复。

命令行发消息和浏览器发消息有什么区别? 功能上完全一样,只是界面不同。浏览器界面更直观,适合长时间对话;命令行方式更快捷,适合快速提问。选你喜欢的就好。


检查你的成果

完成以上步骤后,逐项确认:

检查项怎么确认期望结果
控制台能打开浏览器访问 http://127.0.0.1:18789/看到 OpenClaw 聊天界面
能发送消息在输入框输入文字并发送消息成功发出,界面显示你的消息
能收到回复等待 AI 回复看到完整的 AI 回复内容

三项全部通过?你已经可以跟 AI 正常交流了!

常见失败排查

问题 1:浏览器页面打不开(显示”无法访问此网站”)

症状: 浏览器提示”无法访问此网站”或”连接被拒绝”。

原因: Gateway 没有在运行,或者端口不对。

解决方案:

  1. 回到终端,运行 openclaw gateway status 检查状态
  2. 如果显示未运行,执行 openclaw gateway --port 18789 启动
  3. 确认地址栏输入的是 http://127.0.0.1:18789/(注意是 http 不是 https)
  4. 如果端口 18789 被占用,换个端口试试:openclaw gateway --port 18790,然后访问 http://127.0.0.1:18790/

问题 2:发送消息后没有回复

症状: 消息发出去了,但一直显示”思考中”或”正在输入”,等了很久都没有回复。

原因: 最常见的是 API Key 配置有问题,或者网络连接不上 AI 服务商。

解决方案:

  1. 检查 API Key: 打开配置文件 ~/.openclaw/openclaw.json,确认 API Key 填写正确、没有多余空格
  2. 检查网络: 如果你在国内使用 OpenAI 等海外服务,可能需要配置代理。在配置文件中添加代理设置
  3. 查看日志: 在前台运行 Gateway(openclaw gateway --port 18789),发送消息时观察终端输出的错误信息,通常会告诉你具体什么问题

问题 3:回复速度非常慢

症状: AI 能回复,但是要等很久(超过 30 秒)。

原因: 可能是网络延迟大,或者选择的模型本身就比较慢。

解决方案:

  1. 换一个更快的模型: 在配置文件 ~/.openclaw/openclaw.json 中,尝试切换到更轻量的模型(比如 GPT-4o-mini)
  2. 检查网络: 如果你在国内访问海外 AI 服务,延迟是常见的。考虑配置代理或使用国内可用的模型(如 DeepSeek)
  3. 检查 API 余额: 有些服务商在免费额度用完后会降低优先级,导致响应变慢

挑战任务

你已经完成了第一次对话,试试下面的小挑战:

  1. 连续对话: 试着跟 AI 进行多轮对话。比如先问”帮我推荐三部科幻电影”,然后追问”第一部电影的导演是谁”。观察 AI 是否记得你们之前的对话上下文。
  2. 角色扮演: 让 AI 扮演一个角色来回答问题,比如:“请你扮演一个资深健身教练,给我制定一份新手健身计划”。你会发现 AI 在角色扮演方面非常擅长。
  3. 多语言测试: 试着用英文问 AI 一个问题,比如 “What are the benefits of learning to code?”,看看它是否能流畅切换语言。

下一课预告: 你已经会跟 AI 聊天了!接下来我们将学习如何根据你的需求,调整 OpenClaw 的各种配置,让 AI 更好地为你服务。