OpenClaw 入门指南与实战案例合集

# macOS/Linux curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 openclaw | iex

openclaw onboard --install-daemon

openclaw gateway status

# 启动 Dashboard openclaw dashboard # 或直接访问 open http://127.0.0.1:18789

# 检查版本 openclaw --version # 检查状态 openclaw status # 发送测试消息 openclaw message send --target + --message "Hello OpenClaw!"

# 方法 1：使用向导（推荐） openclaw onboard # 方法 2：手动配置 # 1. 生成 Gateway token openclaw gateway create-token # 2. 在手机上配对 # 扫描二维码或输入配对代码 # 3. 测试连接 openclaw message send --target + --message "Test"

# 1. 创建 Bot # 访问 @BotFather，创建新 Bot # 2. 获取 Token # 复制 Bot Token # 3. 配置 OpenClaw openclaw configure --channel telegram \ --token "your-bot-token-here" \ --allow-from "+" # 4. 测试 openclaw message send --channel telegram --message "Hello Telegram!"

# 1. 创建 Bot 和应用 # 访问 Discord Developer Portal # 2. 获取 Bot Token 和 Client ID # 3. 配置 OpenClaw openclaw configure --channel discord \ --bot-token "your-bot-token" \ --client-id "your-client-id" \ --client-secret "your-client-secret" # 4. 配置 Intents # 需要启用：MESSAGE_CONTENT, MESSAGE_READ, SERVERS # 5. 测试 openclaw message send --channel discord --message "Hello Discord!"

┌─────────────────────────────────────┐ │ Messaging Apps │ │ (WhatsApp/Telegram/Discord) │ └─────────────┬───────────────────┘ │ WebSocket │ ┌─────────▼──────────┐ │ Gateway │ │ (single daemon) │ └─────────┬──────────┘ │ ┌────────▼────────┐ │ Provider APIs │ │ (Anthropic/OpenAI)│ └─────────┬────────┘ │ ┌────────▼──────┐ │ AI Agents │ │ (Claude/GPT) │ └────────────────┘

{ "tools": { "allow": ["read", "write", "browser"], "deny": ["exec"] } }

{ "tools": { "profile": "coding" } }

{ "channels": { "discord": { "groups": { "*": { "requireMention": true } } }, "slack": { "allowFrom": ["U", "U0"] } } }

{ "agents": { "list": [ { "id": "coder", "tools": { "profile": "coding" } }, { "id": "researcher", "tools": { "allow": ["web_search", "web_fetch", "read"] } }, { "id": "writer", "tools": { "allow": ["write", "edit"] } } ] } }

{ "cron": [ { "schedule": "0 9 * * *", "task": "morning-briefing" }, { "schedule": "0 18 * * *", "task": "daily-summary" } ] }

# morning-briefing.py def morning_briefing(): # 搜索新闻 news = search_ai_news() # 生成简报 brief = generate_briefing(news) # 发送到 Telegram send_to_telegram(brief)

{ "memory": { "enabled": true, "search": { "enabled": true }, "store": { "onReply": true, "onMessage": true } } }

# 1. 打开网页 openclaw browser open --url "https://example.com" # 2. 导航到登录页 openclaw browser act \ --ref "login-button" \ --request '{ "kind": "click", "ref": "login-button" }' # 3. 填写表单 openclaw browser act \ --ref "username-input" \ --request '{ "kind": "fill", "ref": "username-input", "text": "my-username" }' # 4. 提交表单 openclaw browser act \ --ref "submit-button" \ --request '{ "kind": "click", "ref": "submit-button" }'

# 1. 截取当前页面 openclaw browser screenshot # 2. 分析页面内容 openclaw browser act \ --request '{ "kind": "evaluate", "fn": "document.querySelector(\"h1\").textContent" }' # 3. 基于分析导航 openclaw browser act \ --request '{ "kind": "navigate", "url": "https://next-page.com" }'

# OpenClaw 配置目录 export OPENCLAW_HOME="/custom/path" # 状态目录 export OPENCLAW_STATE_DIR="/custom/state" # 配置文件路径 export OPENCLAW_CONFIG_PATH="/custom/config.json"

{ "channels": { "telegram": { "token": "your-bot-token", "allowFrom": ["+"] }, "discord": { "botToken": "your-bot-token", "clientId": "your-client-id", "clientSecret": "your-client-secret" }, "whatsapp": { "gatewayToken": "your-gateway-token", "allowFrom": ["+"], "groups": { "*": { "requireMention": false } } } }, "tools": { "profile": "coding", "allow": ["group:fs", "group:sessions", "group:memory"], "deny": ["exec", "process"] }, "agents": { "list": [ { "id": "assistant", "model": "openai/gpt-4", "tools": { "profile": "full" } } ] }, "memory": { "enabled": true, "search": { "enabled": true } }, "gateway": { "host": "127.0.0.1", "port": 18789, "tls": { "enabled": false } } }

{ "tools": { "byProvider": { "openai/gpt-4": { "profile": "minimal" }, "google-antigravity": { "allow": ["web_search", "web_fetch"] } } } }

{ "agents": { "list": [ { "id": "support", "tools": { "byProvider": { "openai/gpt-4": { "allow": ["message", "sessions_list"] } } } } ] } }

openclaw gateway status # Error: Gateway is not running

# 1. 检查端口占用 netstat -tuln | grep 18789 # 2. 查看 Gateway 日志 journalctl -u openclaw-gateway -n 50 # 3. 重新启动 openclaw gateway restart # 4. 如果是权限问题 sudo openclaw gateway restart

# WhatsApp: 提示 "Not paired" # Telegram: 发送消息无响应 # Discord: Bot 不在线

# 1. 重新配对 openclaw whatsapp unpair openclaw whatsapp pair # 2. 检查 Gateway token openclaw gateway status # 3. 检查网络 ping wa.me

# 1. 验证 Bot Token # 访问 @BotFather，检查 Bot 状态 # 2. 检查 Token 配置 openclaw status | grep telegram # 3. 测试连接 openclaw message send --channel telegram --message "Test"

# 1. 检查 Intents # 访问 Discord Developer Portal # 2. 验证 Bot 权限 # 需要：MESSAGE_CONTENT, MESSAGE_READ, SERVERS # 3. 检查服务器配置 openclaw status | grep discord

Agent: I'm sorry, I cannot use the browser tool.

# 检查工具策略 openclaw status # 方法 1：全局允许 openclaw configure tools.allow '["browser"]' # 方法 2：按配置文件允许 openclaw configure tools.profile "full" # 方法 3：Agent 级别覆盖 openclaw configure agents.list[].tools.allow '["browser"]'

# 频繁掉线 openclaw gateway status # 显示大量连接重连

# 1. 检查网络稳定性 ping api.anthropic.com # 2. 检查 Gateway 配置 openclaw configure gateway.keepalive true # 3. 检查 TLS 配置 openclaw configure gateway.tls.enabled true # 4. 使用远程访问（Tailscale） tailscale up

# Gateway 进程占用大量内存 top | grep openclaw-gateway # 显示 > 1GB 使用量

# 1. 启用会话修剪 openclaw configure session.pruning.enabled true # 2. 限制历史记录长度 openclaw configure session.history.maxMessages 100 # 3. 启用压缩 openclaw configure gateway.compression.enabled true # 4. 重启 Gateway openclaw gateway restart

{ "tools": { "loopDetection": { "enabled": true, "warningThreshold": 10, "criticalThreshold": 20 } } }

{ "gateway": { "streaming": { "enabled": true, "chunkSize": 1000 } } }

{ "gateway": { "cache": { "responses": { "enabled": true, "ttl": 900 } } } }