OpenClaw 快速开始指南

本指南将帮助你快速上手 OpenClaw，从第一次对话到实际应用场景。

前置准备

在开始之前，确保你已经：

✅ 完成 OpenClaw 安装
✅ 配置了至少一个 AI 模型
✅ Gateway 正常运行
✅ 连接了至少一个消息平台

如果还没有完成，请先阅读安装部署指南。

第一次对话

使用 CLI 对话

最简单的方式是通过命令行与 AI 对话：

# 发送单条消息
openclaw agent --message "你好，介绍一下你自己"

# 交互式对话
openclaw tui

使用 WebChat

启动 Gateway：

openclaw gateway

打开浏览器访问：http://localhost:18789
在 WebChat 界面输入消息

使用消息平台

如果你已经配置了 Telegram：

在 Telegram 中找到你的 Bot
发送 /start 命令
发送任意消息开始对话

基本对话技巧

简单问答

你：今天天气怎么样？
AI：我需要知道你的位置才能查询天气。请告诉我你在哪个城市？

你：北京
AI：[调用天气 API] 北京今天晴，温度 15-25°C...

多轮对话

OpenClaw 会记住对话上下文：

你：帮我写一个 Python 函数，计算斐波那契数列
AI：[生成代码]

你：加上类型注解
AI：[在之前的代码基础上添加类型注解]

你：再加上单元测试
AI：[生成测试代码]

工具调用

AI 可以主动调用工具完成任务：

你：帮我搜索一下 OpenAI 的最新新闻
AI：[调用浏览器工具] 我找到了以下信息...

你：把这些信息保存到文件
AI：[调用文件工具] 已保存到 openai-news.md

实用场景示例

场景 1：日程管理

你：明天上午 10 点提醒我开会
AI：好的，我已经设置了提醒。明天上午 10 点我会通知你。

你：列出我所有的提醒
AI：你有以下提醒：
1. 明天 10:00 - 开会
2. 周五 15:00 - 项目评审

场景 2：邮件处理

你：检查我的邮件，有什么重要的吗？
AI：[连接邮箱] 你有 3 封未读邮件，其中 1 封标记为重要...

你：帮我回复第一封
AI：我为你起草了回复：[显示草稿]

你：发送
AI：已发送。

场景 3：代码助手

你：这段代码有什么问题？
[粘贴代码]

AI：我发现了几个问题：
1. 第 5 行缺少错误处理
2. 第 12 行可能导致内存泄漏
3. 建议使用异步方式...

你：帮我修复
AI：[提供修复后的代码]

场景 4：信息搜索

你：搜索 TypeScript 5.0 的新特性
AI：[调用浏览器] TypeScript 5.0 主要新特性包括：
1. Decorators 正式支持
2. const 类型参数
3. 枚举改进
...

你：给我详细解释第一个
AI：Decorators 是一种...

场景 5：文件操作

你：读取 package.json 文件
AI：[读取文件] 这是你的 package.json 内容...

你：把 version 改成 2.0.0
AI：[修改文件] 已更新 version 字段为 2.0.0

你：创建一个 README.md
AI：[创建文件] 我为你创建了 README.md，内容如下...

使用技能（Skills）

查看可用技能

# 列出所有技能
openclaw skills list

# 搜索技能
openclaw skills search github

启用技能

# 启用 GitHub 技能
openclaw skills enable github

# 配置技能
openclaw skills config github --token YOUR_GITHUB_TOKEN

使用技能

启用技能后，AI 会自动在需要时调用：

你：列出我的 GitHub 仓库
AI：[调用 GitHub 技能] 你有以下仓库：
1. my-project (⭐ 123)
2. another-repo (⭐ 45)
...

你：创建一个新的 Issue
AI：请告诉我 Issue 的标题和内容

你：标题：修复登录 bug，内容：用户无法登录
AI：[创建 Issue] 已在 my-project 创建 Issue #42

记忆系统

AI 如何记忆

OpenClaw 使用两层记忆：

长期记忆（MEMORY.md）：重要信息
每日日志（memory/YYYY-MM-DD.md）：当天的对话

教 AI 记住信息

你：记住我的名字是张三
AI：好的，我会记住你的名字是张三。

你：记住我喜欢用 TypeScript
AI：已记录：你喜欢使用 TypeScript。

你：我的工作时间是 9:00-18:00
AI：已记录你的工作时间。

查看记忆

# 查看长期记忆
cat ~/.openclaw/workspace/MEMORY.md

# 查看今天的日志
cat ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md

搜索记忆

你：我之前说过我喜欢什么编程语言？
AI：[搜索记忆] 你说过你喜欢使用 TypeScript。

多 Agent 使用

创建专用 Agent

# 创建工作 Agent
openclaw agent create work --model anthropic:claude-opus-4.6

# 创建个人 Agent
openclaw agent create personal --model openai:gpt-4

# 创建编程 Agent
openclaw agent create coding --model anthropic:claude-sonnet-4.6

切换 Agent

# 使用特定 Agent
openclaw agent --name work --message "查看今天的任务"

# 在配置中设置默认 Agent
openclaw config set agent.default work

Agent 隔离

每个 Agent 有独立的：

工作空间
记忆文件
会话历史
技能配置

高级功能

定时任务

你：每天早上 8 点提醒我查看邮件
AI：[创建 Cron 任务] 已设置每日提醒。

你：每周一上午 10 点生成周报
AI：[创建 Cron 任务] 已设置周报生成任务。

Webhook 集成

# 创建 Webhook
openclaw webhook create github-push \
  --url /webhooks/github \
  --action "通知我有新的 push"

# 测试 Webhook
curl -X POST http://localhost:18789/webhooks/github \
  -H "Content-Type: application/json" \
  -d '{"event": "push"}'

语音对话

如果你使用 macOS/iOS/Android 应用：

启用 Voice Wake：说 "Hey OpenClaw"
使用 Talk Mode：按住按钮说话
实时语音对话

Canvas 工作区

Canvas 是 Agent 驱动的可视化工作区：

你：创建一个项目计划
AI：[在 Canvas 中创建] 我为你创建了项目计划...

你：添加时间线
AI：[更新 Canvas] 已添加时间线视图

常用命令速查

Gateway 管理

openclaw gateway                    # 启动 Gateway
openclaw gateway stop               # 停止 Gateway
openclaw gateway restart            # 重启 Gateway
openclaw gateway status             # 查看状态
openclaw doctor                     # 健康检查

Agent 操作

openclaw agent --message "..."      # 发送消息
openclaw tui                        # 交互式界面
openclaw agent list                 # 列出所有 Agent
openclaw agent create NAME          # 创建 Agent
openclaw agent delete NAME          # 删除 Agent

配置管理

openclaw config get KEY             # 获取配置
openclaw config set KEY VALUE       # 设置配置
openclaw config list                # 列出所有配置
openclaw config path                # 配置文件路径

技能管理

openclaw skills list                # 列出技能
openclaw skills enable NAME         # 启用技能
openclaw skills disable NAME        # 禁用技能
openclaw skills config NAME         # 配置技能

消息发送

openclaw message send \
  --to +1234567890 \
  --message "Hello"                 # 发送消息

openclaw message send \
  --channel telegram \
  --to @username \
  --message "Hi"                    # 指定平台

最佳实践

1. 清晰的指令

❌ 不好：

你：那个东西

✅ 好：

你：帮我查询北京今天的天气

2. 分步骤执行

❌ 不好：

你：帮我创建项目、写代码、测试、部署

✅ 好：

你：先帮我创建项目结构
AI：[完成]

你：现在写核心功能代码
AI：[完成]

你：添加测试
AI：[完成]

3. 利用上下文

✅ 好：

你：这段代码有问题吗？
[粘贴代码]

AI：[分析]

你：帮我修复第 5 行的问题
AI：[AI 知道你在说哪段代码]

4. 教 AI 你的偏好

你：记住我喜欢用 4 空格缩进
你：记住我的代码风格是 Airbnb
你：记住我的时区是 UTC+8

5. 定期清理记忆

# 查看记忆文件大小
du -sh ~/.openclaw/workspace/memory/

# 删除旧日志（保留最近 30 天）
find ~/.openclaw/workspace/memory/ -name "*.md" -mtime +30 -delete

故障排除

AI 无响应

# 检查 Gateway 状态
openclaw gateway status

# 查看日志
openclaw gateway --verbose

# 测试 API 连接
openclaw agent --message "test" --verbose

工具调用失败

你：为什么无法读取文件？
AI：我没有权限访问该文件。

解决方案：
1. 检查文件路径是否正确
2. 确保文件在工作空间内
3. 检查文件权限

记忆不生效

# 检查记忆文件
cat ~/.openclaw/workspace/MEMORY.md

# 手动编辑记忆
vim ~/.openclaw/workspace/MEMORY.md

# 重启 Gateway
openclaw gateway restart

消息平台连接断开

# 查看连接状态
openclaw gateway status

# 重新认证
openclaw channel auth telegram

# 重启 Gateway
openclaw gateway restart

下一步学习

现在你已经掌握了 OpenClaw 的基本使用，可以继续学习：

模型配置指南：了解如何配置和切换不同的 AI 模型
消息平台接入指南：连接更多消息平台
技能系统指南：深入了解技能系统和自定义技能
记忆系统指南：优化 AI 的记忆能力
多 Agent 协作指南：创建专用 Agent 团队

参考资源

官方文档：https://docs.openclaw.ai
快速开始：https://docs.openclaw.ai/quickstart
示例项目：https://github.com/openclaw/examples
Discord 社区：https://discord.gg/clawd
ClawHub 技能市场：https://clawhub.com

OpenClaw 快速开始指南

分享这篇文章