OpenClaw（2026.2.25版本）专业使用指南 🦞

部署完成后，以下是完整的使用指南：

---

🚀 一、快速验证

先确认 Gateway 状态：

openclaw gateway status

打开控制 UI（浏览器面板）：

openclaw dashboard

或直接访问：http://127.0.0.1:18789/

💡 控制 UI 可以聊天、配置、管理会话和节点，无需配置任何频道即可开始使用。

---

📋 二、核心命令速查

命令	说明
openclaw status	查看整体状态
openclaw gateway status/start/stop/restart	管理 Gateway 服务
openclaw dashboard	打开控制 UI
openclaw onboard	运行配置向导
openclaw configure	配置向导
openclaw doctor	诊断问题
openclaw logs	查看日志
openclaw sessions list	查看会话
openclaw memory	管理记忆
openclaw nodes	管理移动节点
openclaw channels login	登录频道（WhatsApp 等）

---

🔧 三、配置频道

WhatsApp（最常用）

openclaw channels login whatsapp

扫描 QR 码后，你的 WhatsApp 就能和 AI 对话了。

Telegram

1. 找 @BotFather 创建机器人，获取 token
2. 配置：

openclaw config set channels.telegram.botToken "YOUR_TOKEN"
openclaw config set channels.telegram.enabled true

Discord

1. 创建 Discord 应用和机器人
2. 配置 token 和邀请链接

---

📁 四、工作区文件结构

你的工作区在 ~/.openclaw/workspace/：

workspace/
├── SOUL.md # AI 的人格定义
├── USER.md # 关于你的信息
├── IDENTITY.md # AI 的身份（名字、emoji 等）
├── AGENTS.md # 行为准则
├── TOOLS.md # 本地工具配置
├── HEARTBEAT.md # 定期任务清单
├── BOOTSTRAP.md # 首次启动引导（用完可删）
├── MEMORY.md # 长期记忆
└── memory/ # 每日记忆日志
└── YYYY-MM-DD.md

每次会话前，AI 会自动读取这些文件来保持连续性。

---

⚙️ 五、配置文件

配置位于 ~/.openclaw/openclaw.json（JSON5 格式，支持注释）

最小配置示例

{
// 默认工作区
agents: {
defaults: {
workspace: "~/.openclaw/workspace"
}
},

// WhatsApp 白名单
channels: {
whatsapp: {
allowFrom: ["+8613800138000"]
}
},

// 模型选择
agents: {
defaults: {
model: {
primary: "anthropic/claude-sonnet-4-5"
}
}
}
}

常用配置项

{
// 心跳（定期主动汇报）
agents: {
defaults: {
heartbeat: {
every: "30m",
target: "last"
}
}
},

// 群聊提及触发
messages: {
groupChat: {
mentionPatterns: ["@openclaw"]
}
},

// 会话管理
session: {
dmScope: "per-channel-peer",
reset: {
mode: "daily",
atHour: 4
}
}
}

配置后 Gateway 会热重载，无需重启。

---

🎯 六、核心功能

1. 多频道支持

• WhatsApp、Telegram、Discord、iMessage、Slack、Signal 等
• 一个 Gateway 服务所有频道

2. 多 Agent 路由

可以配置多个独立的 AI 实例，不同场景用不同 Agent：

{
agents: {
list: [
{ id: "home", default: true, workspace: "~/.openclaw/workspace-home" },
{ id: "work", workspace: "~/.openclaw/workspace-work" }
]
}
}

3. 记忆系统

• 每日记忆: memory/YYYY-MM-DD.md - 原始日志
• 长期记忆: MEMORY.md - 精选的重要信息

4. 心跳机制

定期主动检查（邮件、日历、天气等），2-4 次/天

5. 定时任务 (Cron)

{
cron: {
enabled: true,
maxConcurrentRuns: 2
}
}

6. Webhooks

接收外部事件触发 AI 响应

---

📱 七、移动节点

可以配对 iOS/Android 设备：

openclaw nodes pair

配对后手机可以：

• 接收通知
• 使用 Canvas（网页预览）
• 相机控制

---

🔒 八、安全最佳实践

1. 配置白名单：allowFrom 限制可发消息的用户
2. 群聊提及触发：避免 AI 在群里过度发言
3. 沙箱模式：用 Docker 隔离 Agent 执行环境
4. 定期审计：openclaw health 检查安全状态

---

🛠️ 九、故障排查

# 诊断
openclaw doctor

# 查看日志
openclaw logs --follow

# 检查状态
openclaw status

# 重启 Gateway
openclaw gateway restart

---

📚 十、进阶资源

主题	文档
完整配置参考	/gateway/configuration-reference
频道设置	/channels/
自动化	/automation/cron-jobs
安全	/gateway/security
API 参考	/reference/

本地文档：/home/node/openclaw/docs/
在线文档：https://docs.openclaw.ai

---

💡 快速上手建议

1. 先打开控制 UI 试试聊天功能
2. 配置 WhatsApp 实现手机端对话
3. 编辑 USER.md 让 AI 了解你
4. 设置心跳 让 AI 定期主动汇报
5. 根据需要配置其他频道

---

运行 openclaw help 查看完整命令列表。🦞

个人微信公众号（欢迎关注交流学习👏👏微信🔍时间时间满满走👏👏）