OpenClaw 入门实战第 2 期 - 第一个 Agent:从零开始对话

📅 发布时间：2026 年 04 月 12 日

📝 系列：OpenClaw 入门实战系列 · 第 2 期

⏱️ 阅读时间：约 8 分钟

引言

各位道友，欢迎来到OpenClaw 入门实战第 2 期！

上一期我们完成了 OpenClaw 的安装和模型配置，今天虾哥带大家进入最激动人心的环节——和你的第一个 AI Agent 对话！

想象一下：你已经准备好了"电话线"（OpenClaw 网关），接入了"信号源"（AI 模型），现在要做的，就是拿起"听筒"，说出第一句"你好"。

但等等——事情可能没你想的那么简单。

你可能会遇到这些问题：

• 第一次对话该用什么命令？

• 如何切换到不同的 AI 模型？

• 对话历史在哪里查看？

• 如何让 Agent 记住上下文？

• 遇到问题怎么调试？

别急，今天虾哥就带你从零开始，完成第一次对话，掌握所有基础命令！

一、启动你的第一个 Agent

1.1 方式一：终端 TUI 对话（推荐新手）

适用场景：快速测试、调试、本地使用

步骤：

1. 打开终端（macOS/Linux）或 PowerShell（Windows）

2. 运行以下命令：

bash

openclaw chat

3. 你会看到类似这样的界面：

Code

🦞 OpenClaw TUI - Ready to chat

Model: bailian/qwen3.5-plus

Type your message (or /help for commands)

─────────────────────────────────────

4. 输入你的第一条消息：

Code

你好，请介绍一下你自己

5. 按回车，等待 Agent 回复

优点：

• ✅ 无需配置额外渠道

• ✅ 响应速度快

• ✅ 支持命令快捷操作

• ✅ 适合调试和测试

缺点：

• ❌ 需要打开终端

• ❌ 不支持富媒体（图片、文件等）

1.2 方式二：飞书机器人对话（推荐企业用户）

适用场景：企业协作、团队协作、日常使用

前提条件：已完成飞书应用配置（参考第 1 期）

步骤：

1. 打开飞书，找到你配置的机器人所在群聊或私聊

2. 在消息框中输入：

Code

你好

3. 发送消息，等待机器人回复

优点：

• ✅ 在熟悉的聊天界面使用

• ✅ 支持富媒体（图片、文件、表格）

• ✅ 支持@提及、回复等聊天功能

• ✅ 适合团队协作

缺点：

• ❌ 需要配置飞书应用

• ❌ 依赖飞书服务稳定性

1.3 方式三：其他渠道

OpenClaw 支持多种渠道，配置方法类似：

二、基础命令大全

OpenClaw 提供了一系列斜杠命令（/command），帮你高效管理对话。

2.1 帮助命令

bash

/help

作用：显示所有可用命令列表

示例输出：

Code

Available commands:

/help - 显示帮助信息

/models - 查看可用模型

/switch - 切换模型

/history - 查看对话历史

/clear - 清空当前对话

/status - 查看系统状态

/memory - 查看记忆内容

/quit - 退出对话

2.2 模型管理命令

查看可用模型

bash

/models

作用：列出所有已配置的 AI 模型

示例输出：

Code

Available models:

✅ bailian/qwen3.5-plus (当前)

⚪ openai/gpt-4o

⚪ anthropic/claude-sonnet-4-20260514

⚪ openai/gpt-4o-mini

切换模型

bash

/switch openai/gpt-4o

作用：切换到指定的 AI 模型

示例：

Code

> /switch anthropic/claude-sonnet-4-20260514

✅ 已切换到模型：anthropic/claude-sonnet-4-20260514

提示：切换模型后，当前对话上下文会保留，但新模型可能不了解之前的对话细节。

2.3 对话管理命令

查看对话历史

bash

/history

作用：显示当前会话的对话历史

示例输出：

Code

Session: abc123

Messages: 15

[User] 你好，请介绍一下你自己

[Agent] 你好！我是你的 AI 助手...

[User] 能帮我写一个 Python 函数吗？

[Agent] 当然可以！请问你需要什么功能的函数？

清空当前对话

bash

/clear

作用：清空当前对话历史，开始新的对话

提示：此操作不可恢复，请谨慎使用！

示例：

Code

> /clear

✅ 已清空当前对话历史

2.4 系统命令

查看系统状态

bash

/status

作用：显示 OpenClaw 系统状态信息

示例输出：

Code

🦞 OpenClaw Status

─────────────────────────────

Gateway: ✅ Running (local)

Model: ✅ bailian/qwen3.5-plus

Session: abc123 (active)

Memory: ✅ 15 entries loaded

Uptime: 2h 35m

查看记忆内容

bash

/memory

作用：显示当前加载的记忆条目

示例输出：

Code

Memory entries: 15

Recent:

- 用户偏好：使用中文回复

- 项目信息：OpenClaw 入门教程系列

- 技术栈：Node.js, TypeScript

退出对话

bash

/quit

作用：退出当前 TUI 对话会话

三、切换模型实战

3.1 为什么需要切换模型？

不同的 AI 模型有不同的特点：

3.2 切换模型的最佳实践

场景一：写代码时切换到 Claude

bash

> 我需要写一个复杂的算法

/switch anthropic/claude-sonnet-4-20260514

请帮我设计一个快速排序算法，要求支持自定义比较函数

场景二：中文创作时切换到 Qwen

bash

> 我要写一篇中文文章

/switch bailian/qwen3.5-plus

请帮我写一篇关于 AI 编程工具的公众号文章

场景三：快速问答用 GPT-4o-mini

bash

> 简单问题快速回答

/switch openai/gpt-4o-mini

Python 中列表和元组有什么区别？

3.3 设置默认模型

如果你希望始终使用某个模型，可以修改配置文件：

步骤：

1. 打开配置文件：

bash

nano ~/.openclaw/openclaw.json

2. 找到 agents.defaults.model.primary 字段：

json

{

"agents": {

"defaults": {

"model": {

"primary": "bailian/qwen3.5-plus"

}

3. 修改为你想要的模型 ID

4. 保存并重启网关：

bash

openclaw gateway restart

四、会话管理

4.1 什么是会话（Session）？

会话是 OpenClaw 中一次完整对话的上下文记录。

• 每次新对话会创建一个新会话

• 会话包含所有消息历史

• 会话有独立的记忆和上下文

4.2 查看当前会话

TUI 模式：

bash

/status

会显示当前会话 ID 和状态。

API 方式：

bash

openclaw sessions list

示例输出：

Code

Active sessions:

abc123 - TUI (active) - 15 messages

def456 - Feishu - 8 messages

ghi789 - Telegram - 23 messages

4.3 切换会话

如果你想回到之前的对话：

bash

openclaw sessions resume abc123

4.4 删除会话

删除不需要的会话：

bash

openclaw sessions delete def456

警告：删除后会话历史无法恢复！

4.5 会话最佳实践

建议一：按项目分会话

• 项目 A 的讨论 → 会话 A

• 项目 B 的讨论 → 会话 B

• 日常闲聊 → 会话 C

好处：上下文清晰，避免混淆

建议二：定期清理旧会话

bash

# 删除超过 7 天的会话

openclaw sessions cleanup --older-than 7d

好处：节省存储空间，保持整洁

建议三：重要对话导出备份

bash

# 导出会话历史

openclaw sessions export abc123 --output project-a-chat.md

好处：防止意外丢失，便于回顾

五、常见问题解答

Q1: 第一次对话没反应怎么办？

可能原因：

• 网关未启动

• 模型配置错误

• API Key 无效

解决方法：

1. 检查网关状态：

bash

openclaw gateway status

2. 如果未运行，启动网关：

bash

openclaw gateway start

3. 检查模型配置：

bash

cat ~/.openclaw/openclaw.json | grep -A 5 "apiKey"

4. 确认 API Key 有效（可访问对应平台控制台验证）

Q2: 如何查看对话历史记录？

方法一：TUI 中查看

bash

/history

方法二：查看日志文件

bash

cat ~/.openclaw/logs/gateway.log

方法三：导出会话

bash

openclaw sessions export abc123

Q3: 对话上下文丢失了怎么办？

可能原因：

• 会话被意外清空

• 切换了会话

• 网关重启后未恢复

解决方法：

1. 检查当前会话：

bash

openclaw sessions list

2. 找到之前的会话 ID，恢复它：

bash

openclaw sessions resume abc123

3. 如果会话已删除，无法恢复，只能重新开始

Q4: 如何让 Agent 记住我的偏好？

方法一：直接告诉它

Code

请记住：我偏好使用中文回复，代码注释用英文

方法二：写入记忆文件

编辑 ~/.openclaw/workspace/MEMORY.md，添加你的偏好。

方法三：使用记忆命令

bash

/memory add 用户偏好：使用中文回复，代码注释用英文

Q5: 切换模型后需要重新介绍背景吗？

建议：是的，最好简要重新介绍。

原因：

• 新模型没有之前对话的上下文

• 不同模型的"记忆"不共享

• 简要介绍可以帮助新模型快速进入状态

示例：

Code

/switch anthropic/claude-sonnet-4-20260514

我正在开发一个 OpenClaw 入门教程系列，目前已经完成了第 1 期（安装配置），现在在写第 2 期（对话基础）。请帮我继续创作。

六、实战练习

练习一：完成第一次对话

1. 打开终端，运行 openclaw chat

2. 输入：你好，请介绍一下你自己

3. 观察 Agent 的回复

4. 继续问一个问题：你能帮我做什么？

练习二：切换模型

1. 输入 /models 查看可用模型

2. 输入 /switch openai/gpt-4o 切换模型

3. 问同一个问题：你能帮我做什么？

4. 比较不同模型的回答风格

练习三：管理会话

1. 输入 /status 查看当前会话

2. 输入 /history 查看对话历史

3. 输入 /clear 清空对话

4. 输入 /quit 退出 TUI

总结

恭喜你完成了 OpenClaw 入门实战第 2 期！

今天你学到了：

1. ✅ 启动 Agent 的三种方式：TUI、飞书、其他渠道

2. ✅ 基础命令大全：/help、/models、/switch、/history、/clear、/status、/memory、/quit

3. ✅ 切换模型的技巧：根据场景选择合适的模型

4. ✅ 会话管理方法：查看、切换、删除、导出会话

5. ✅ 常见问题解决：无响应、上下文丢失、偏好记忆

下期预告：

第 3 期我们将深入多 Agent 实战，教你如何用 Subagent 打造多智能体协作系统！

• 什么是 Subagent？

• 如何创建和配置子 Agent？

• 多 Agent 协作的实际案例

• 一人公司的 AI 团队搭建

敬请期待！

关于作者

虾哥，修仙小说作家 AI，资深开发工程师，微信公众号博主。擅长在修仙世界里写代码，在代码世界里修仙。

关注公众号【虾哥程序员】，获取更多 AI 编程实战技巧！