OpenClaw 完整文档知识库。涵盖安装、配置、Gateway 网关、渠道、节点、CLI 命令、自动化、安全等所有核心功能。
OpenClaw 是一个适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等多种聊天渠道。通过单个 Gateway 网关进程将聊天应用连接到编程智能体。
Chat apps + plugins → Gateway → 智能体/CLI/Web UI/macOS/iOS/Android
Gateway 网关是会话、路由和渠道连接的唯一事实来源。
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw channels login
openclaw gateway --port 18789
配置文件位于 ~/.openclaw/openclaw.json。
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: {
"*": { requireMention: true }
},
},
},
messages: {
groupChat: {
mentionPatterns: ["@openclaw"]
}
},
}
allowFrom：限制允许访问的电话号码requireMention：群聊中需要 @ 提及才会响应mentionPatterns：自定义提及模式# 状态检查
openclaw status
# Gateway 管理
openclaw gateway --port 18789
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
# 渠道管理
openclaw channels login
openclaw channels list
openclaw channels connect
# 配置管理
openclaw config get <key>
openclaw config set <key> <value>
openclaw configure
# 日志查看
openclaw logs
openclaw logs --follow
# 技能管理
openclaw skills list
openclaw skills install <skill>
openclaw skills uninstall <skill>
# 会话管理
openclaw sessions list
openclaw sessions info <id>
openclaw sessions clear <id>
# 节点管理
openclaw nodes list
openclaw nodes pair
openclaw nodes status
# 更新
openclaw update
# 新手引导
openclaw onboard --install-daemon
# 诊断
openclaw doctor
# 重置
openclaw reset
openclaw nodes pair
支持的设备：
定期执行任务：
openclaw cron create "0 9 * * *" "早上好"
心跳检查，适合定期检查状态：
接收外部事件触发。
在特定事件时执行脚本。
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
},
},
}
通过 Tailscale 访问远程 Gateway：
openclaw gateway --tailscale
通过 SSH 隧道访问：
ssh -L 18789:localhost:18789 user@remote
在 ~/.openclaw/workspace/skills/ 目录下创建：
skills/
└── my-skill/
├── SKILL.md
└── (可选的脚本和资源)
---
name: my-skill
description: 技能描述
---
# 技能文档
内容...
openclaw skills install ./my-skill
长期记忆，存储重要决策、偏好、上下文。
memory/YYYY-MM-DD.md 存储每日日志。
定期压缩和整理内存文件。
默认工作区：~/.openclaw/workspace/
AGENTS.md - 工作区配置SOUL.md - AI 人格定义USER.md - 用户信息MEMORY.md - 长期记忆HEARTBEAT.md - 心跳任务TOOLS.md - 工具配置openclaw doctor
Gateway 无法启动
openclaw logs渠道连接失败
会话丢失
openclaw logs --followopenclaw status{
agents: {
my-agent: {
model: "anthropic/claude-3-opus",
},
},
}
使用 Ollama 或 vLLM 等本地模型。
开发自定义插件扩展功能。
openclaw update
openclaw uninstall
来源：OpenClaw 官方文档 文档链接：https://docs.openclaw.ai/zh-CN 文档索引：https://docs.openclaw.ai/llms.txt
ZIP package — ready to use