OpenClaw 保姆级超详细教程：小白也能轻松上手的 AI 智能体

OpenClaw 保姆级超详细教程：小白也能轻松上手的 AI 智能体 | 极客日志

你常用的聊天App（Telegram/WhatsApp等）【消息入口Channels】 ↓（消息流入/流出） Gateway网关【唯一总机，管理所有连接、认证、消息路由】 ↓（RPC调用） Agent智能体运行时【理解指令、调用模型、执行工具、维护会话上下文】 ↓（工具调用） 内置工具/技能插件【浏览器/终端/文件管理/邮件/日历等扩展能力】 ↓（模型调用） AI大模型提供商【Claude/GPT/Kimi/本地模型】

名词	核心作用	新手通俗理解
Gateway	唯一常驻后台进程，管理所有聊天渠道、消息路由、认证授权，默认端口 18789	相当于总机，所有消息都要经过它中转
Agent	智能体运行时，负责对话逻辑、工具调用、上下文维护，可配置多个独立 Agent	相当于接线员 + 执行者，负责理解需求并干活
Channels	消息入口渠道，即你用来发指令的聊天软件（Telegram/WhatsApp 等）	你给智能体打电话的手机
Session	会话上下文容器，跨消息保存对话历史，默认按发送者隔离	你和接线员的通话记录
Workspace	Agent 的工作目录，存放生成的文件、脚本、配置模板	执行者的办公文件夹
Pairing	安全配对机制，陌生用户发消息需你手动批准，防止机器人被滥用	来电防火墙，只接你批准的号码
Skills	技能插件，扩展 OpenClaw 的能力，比如邮件管理、智能家居控制	给执行者新增的专业技能

系统	推荐配置	注意事项
macOS	macOS 14+，内存≥4GB，磁盘≥5GB	需安装 Xcode Command Line Tools（源码构建时）
Windows	强烈推荐 WSL2（Ubuntu 22.04+），原生 Windows 支持有限	原生 Windows 工具兼容性差，大概率会出现未知问题
Linux	Ubuntu/Debian/Fedora/Arch 等主流发行版，内置 systemd，内存≥4GB	适合 7×24 小时服务器部署

# 1. 安装nvm（macOS/Linux/WSL2） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 2. 重载终端配置 source ~/.bashrc # bash终端 source ~/.zshrc # zsh终端 # 3. 安装Node.js 22 LTS版本 nvm install 22 nvm use 22 # 4. 验证安装成功（必须输出版本≥22.0.0） node -v npm -v

sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true EOF

wsl --set-default-version 2

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 终端临时配置代理（端口改为你自己的代理端口） export HTTPS_PROXY="http://127.0.0.1:7890" export HTTP_PROXY="http://127.0.0.1:7890" # 永久配置（写入终端配置文件） echo 'export HTTPS_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc echo 'export HTTP_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc source ~/.zshrc # 也可直接在OpenClaw配置中设置代理 openclaw config set gateway.proxy.url "http://127.0.0.1:7890"

# 检查Node.js版本（必须≥22.0.0） node -v # 检查npm是否正常 npm -v # 检查网络连通性（海外模型需执行，能正常返回即代理生效） curl https://api.anthropic.com/v1/messages --head # 国内模型检查 curl https://api.moonshot.cn/v1/chat/completions --head

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

# NPM安装（通用） npm install -g openclaw@latest # PNPM安装（推荐，性能更好） pnpm add -g openclaw@latest pnpm approve-builds -g

# 1. 克隆官方仓库 git clone https://github.com/openclaw/openclaw.git cd openclaw # 2. 安装依赖 pnpm install # 3. 构建UI和项目 pnpm ui:build pnpm build # 4. 执行初始化配置 openclaw onboard --install-daemon

openclaw --version # 查看帮助文档，确认命令可用 openclaw --help

# macOS/Linux/WSL2 # 1. 查找openclaw安装位置 which openclaw # 2. 若找不到，添加npm全局bin目录到PATH export PATH="$(npm prefix -g)/bin:$PATH" # 3. 永久生效 echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc # bash echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc # zsh source ~/.zshrc # 重载配置 # Windows PowerShell # 1. 查找安装位置 where.exe openclaw # 2. 添加到环境变量 $npmPath = npm prefix -g $env:Path += ";$npmPath" # 3. 永久生效 [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

openclaw onboard --install-daemon

🦞 OpenClaw Onboarding Wizard ───────────────────────────────────── Welcome! This wizard will help you set up OpenClaw. Mode selection: [1] QuickStart (recommended for first-time users) [2] Advanced (full control over every setting) Choose mode [1]:

Found existing config at ~/.openclaw/openclaw.json What would you like to do? [1] Keep existing config [2] Modify existing config [3] Reset (start fresh) Choose [1-3] [1]:

Gateway mode: [1] Local (run Gateway on this machine) [2] Remote (connect to Gateway elsewhere) Choose [1-2] [1]:

Checking for existing API keys... ✓ Found ANTHROPIC_API_KEY in environment ✗ No MOONSHOT_API_KEY found Authentication method: [1] Anthropic API Key (recommended) [2] Anthropic OAuth (Claude Code CLI) [3] OpenAI API Key [6] Moonshot (Kimi K2) [7] MiniMax M2.1 [8] 智谱GLM [11] Skip (configure later) Choose [1-11] [1]:

Workspace location: Default: ~/.openclaw/workspace [1] Use default [2] Custom path Choose [1-2] [1]:

Gateway settings: Port: 18789 Bind: 127.0.0.1 (loopback) Auth: Token (auto-generated) [1] Keep defaults [2] Customize Choose [1-2] [1]:

Channel setup: [1] Telegram [2] WhatsApp [3] Discord [4] Google Chat [5] Signal [6] Skip (configure later) Choose channels (comma-separated, e.g., 1,3) [1]:

Daemon installation: Install Gateway as a background service? This allows Gateway to run automatically on startup. [1] Yes (recommended) [2] No (run manually) Choose [1-2] [1]:

Skills installation: Skills are plugins that extend Agent capabilities. Recommended skills: - gmail (email management) - calendar (calendar integration) - web-search (Brave Search API) [1] Install recommended skills [2] Skip (install later) Choose [1-2] [1]:

openclaw onboard --non-interactive \ --mode local \ --auth-choice moonshot-api-key \ --moonshot-api-key "你的Kimi API Key" \ --gateway-port 18789 \ --gateway-bind loopback \ --install-daemon \ --daemon-runtime node \ --skip-skills

openclaw configure

openclaw configure --section models # 选择3 Moonshot (Kimi) # 粘贴API Key # 选择是否设为默认模型

{ "env": { "MOONSHOT_API_KEY": "你的Kimi API Key" }, "agents": { "defaults": { "model": { "primary": "moonshot/kimi-k2.5" } } }, "models": { "mode": "merge", "providers": { "moonshot": { "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "${MOONSHOT_API_KEY}", "api": "openai-completions", "models": [ { "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "contextWindow": 256000, "maxTokens": 8192 } ] } } } }

# 查看状态，确认模型已配置 openclaw status # 健康检查，验证API可正常调用 openclaw health # 发送测试消息，验证模型响应 openclaw agent --agent main --message "你好，用一句话介绍自己"

模型 ID	名称	思考能力	上下文窗口	适用场景
moonshot/kimi-k2.5	Kimi K2.5	❌	256K	通用场景，新手首选
moonshot/kimi-k2-turbo-preview	Kimi K2 Turbo	❌	256K	快速响应，低成本场景
moonshot/kimi-k2-thinking	Kimi K2 Thinking	✅	256K	复杂推理、代码开发场景
moonshot/kimi-k2-thinking-turbo	Kimi K2 Thinking Turbo	✅	256K	快速推理场景

{ "agents": { "defaults": { "model": { "primary": "ollama:你的模型名称" } } }, "models": { "providers": { "ollama": { "baseUrl": "http://127.0.0.1:11434", "api": "openai-completions" } } } }

运行方式	命令	适用场景
前台运行（调试用）	`openclaw gateway run --port 18789 --verbose`	排查问题时使用，可实时看到日志，按 Ctrl+C 停止
后台启动（常驻运行）	`openclaw gateway start`	日常使用，关闭终端也能运行，需先安装守护进程
停止网关	`openclaw gateway stop`	停止后台运行的网关
重启网关	`openclaw gateway restart`	修改配置后，必须重启网关才能生效
查看网关状态	`openclaw gateway status`	查看网关是否正常运行、PID、端口等信息

# 1. 查看网关状态，确认显示running openclaw gateway status # 2. 全量状态检查，确认渠道、模型均正常 openclaw status # 3. 健康检查，确认无报错 openclaw health

# 命令行修改 openclaw config set gateway.port 18790 # 重启网关生效 openclaw gateway restart

# 仅本地访问（默认，安全） openclaw config set gateway.bind loopback # 仅Tailscale网络访问（推荐远程使用） openclaw config set gateway.bind tailnet # 局域网访问（仅家庭内网使用） openclaw config set gateway.bind lan # 重启网关生效 openclaw gateway restart

# 进入渠道配置界面 openclaw configure --section channels.telegram # 按提示粘贴Bot Token，回车确认 # 重启网关生效 openclaw gateway restart

openclaw pairing approve telegram <你的配对码>

openclaw pairing list telegram

{ "channels": { "telegram": { "dmPolicy": "pairing", "allowFrom": [123456789, 987654321] } } }

{ "channels": { "telegram": { "groups": { "*": { "requireMention": true } } } }, "messages": { "groupChat": { "mentionPatterns": ["@你的机器人用户名"] } } }

openclaw channels login

brew install keith/formulae/imsg

# 1. 查看全量状态 openclaw status # 2. 健康检查，验证网关、模型、渠道是否正常 openclaw health # 3. 自动诊断并修复常见问题 openclaw doctor --fix

场景	指令示例
系统操作	帮我列出当前电脑桌面的所有文件，按文件大小排序，标注每个文件的修改时间
代码开发	帮我写一个 Python 爬虫，抓取某网站的公开文章标题、发布时间、链接，保存到 Excel 文件，要求加入异常处理，避免被反爬
代码优化	帮我优化这段 PostgreSQL 查询语句，分析执行计划，添加合适的索引，把查询耗时从 8s 降到 100ms 以内
浏览器自动化	帮我打开 Chrome 浏览器，访问某购物网站，筛选价格 100-300 元的商品，按销量排序，截图前 10 个商品的信息，保存到工作目录
邮件管理	帮我读取今天的收件箱，把促销类、广告类邮件标为已读并归档，把工作相关的重要邮件整理成摘要，按优先级排序
运维部署	帮我写一个 K8s 部署配置文件，完成 3 个微服务的部署、ingress 配置、健康检查，注释每一项的作用
文档处理	帮我润色这份工作总结，优化语言逻辑，突出工作成果和数据亮点，适配正式的年终汇报场景，控制在 3000 字以内
安全审计	帮我对这段代码做安全审计，找出 SQL 注入、XSS 等安全漏洞，给出修复方案和完整的修复代码

# 查看可用技能列表 openclaw skills list # 安装指定技能 openclaw skills install gmail # 配置技能 openclaw skills config gmail # 更新技能 openclaw skills update gmail

技能名称	核心作用
gmail	邮件管理，读取、发送、归档、筛选邮件
calendar	日历管理，创建、查看、修改日程，设置提醒
web-search	网页搜索，支持 Brave Search，获取实时网络信息
github	GitHub 管理，查看 Issue、提交 PR、管理仓库
home-assistant	智能家居控制，对接 Home Assistant

{ "agents": { "default": { "model": "moonshot/kimi-k2.5", "skills": ["file-system", "terminal"], "workspace": "~/.openclaw/workspace/default" }, "code-agent": { "model": "anthropic/claude-3-5-sonnet-20241022", "skills": ["git", "code-review", "testing"], "workspace": "~/code", "allowFrom": ["+8613800138000", 123456789] }, "local-agent": { "model": "ollama:llama3", "memorySearch": { "provider": "local" }, "skills": ["browser"], "workspace": "~/.openclaw/workspace/local" } }, "routing": { "bySender": { "+8613800138000": "code-agent", "123456789": "code-agent", "*": "default" }, "byChannel": { "telegram": "local-agent", "whatsapp": "default" } } }

{ "cron": { "jobs": [ { "name": "daily-email-cleanup", "schedule": "0 9 * * *", "agent": "default", "message": "帮我清理今天的收件箱，把广告、促销邮件标为已读并归档，整理重要工作邮件的摘要，发送到我的Telegram" }, { "name": "weekly-report", "schedule": "0 18 * * 5", "agent": "default", "message": "帮我读取本周的工作文档、邮件、Git提交记录，生成一份完整的工作周报，突出核心成果和下周计划" } ] } }

openclaw config set gateway.bind tailnet openclaw gateway restart

ssh -N -L 18789:127.0.0.1:18789 你的服务器用户名@服务器IP

openclaw sandbox explain

{ "agents": { "defaults": { "sandbox": { "mode": "non-main", "scope": "agent", "workspaceAccess": "rw", "bindMounts": [ { "source": "~/Downloads", "target": "/downloads", "access": "ro" } ] } } } }

{ "agents": { "defaults": { "tools": { "allow": ["read", "exec"], "deny": ["write", "delete", "edit", "sudo"], "sandbox": { "tools": { "allow": ["read"], "deny": ["write", "delete", "exec"] } } } } } }

openclaw config set gateway.auth.mode token # 生成强随机Token，替换为你自己的 openclaw config set gateway.auth.token "你的强随机Token" openclaw gateway restart

# Linux ufw防火墙配置 sudo ufw allow from 127.0.0.1 to any port 18789 sudo ufw deny 18789 sudo ufw reload

# 检查当前绑定地址 openclaw status --all | grep "Bind" # 修正为本地回环地址 openclaw config set gateway.bind loopback openclaw gateway restart

chmod 600 ~/.openclaw/openclaw.json chmod 600 ~/.openclaw/.env chmod 700 ~/.openclaw/workspace/

# 添加需要审批的危险命令 openclaw approvals allowlist add "rm -rf" openclaw approvals allowlist add "/usr/bin/dd" openclaw approvals allowlist add "mkfs" openclaw approvals allowlist add "sudo" # 查看当前审批配置 openclaw approvals get

openclaw approvals set --file ./exec-approvals.json

{ "allowlist": [ "rm -rf", "/usr/bin/dd", "mkfs", "sudo", "shutdown", "reboot" ] }

# 基础安全审计 openclaw security audit # 深度安全审计，全面检查配置、权限、网络、凭证 openclaw security audit --deep

检查频率	检查命令	检查目的
每日	openclaw status``openclaw health	确认网关、模型、渠道正常运行
每周	openclaw status --all``openclaw doctor	全面检查系统状态，自动修复常见问题
每周	`openclaw logs --limit 500	grep -i error`	查看错误日志，及时发现潜在问题
每月	`openclaw security audit --deep`	安全审计，修复安全隐患
每月	检查模型 API 使用额度	避免额度超额，及时发现异常调用

# 实时查看运行日志，排查问题必备 openclaw logs --follow # 实时查看日志，只过滤错误和警告 openclaw logs --follow | grep -i "error\|warning\|unauthorized" # 查看最近100行日志 openclaw logs --limit 100 # 查看最近1小时的日志 openclaw logs --since 3600000 # 清理7天前的旧日志 find /tmp/openclaw -name "openclaw-*.log" -mtime +7 -delete

# 备份主配置文件 cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d) # 备份环境变量和凭证 cp -r ~/.openclaw/credentials/ ~/.openclaw/backup/credentials-$(date +%Y%m%d) cp ~/.openclaw/.env ~/.openclaw/backup/.env.backup.$(date +%Y%m%d) # 备份整个工作区 tar -czvf ~/openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/ --exclude='*.log' --exclude='sessions/'

crontab -e # 添加以下内容 0 2 * * * ~/.openclaw/backup.sh >> ~/.openclaw/backup.log 2>&1

#!/bin/bash BACKUP_DIR=~/openclaw-backups mkdir -p $BACKUP_DIR DATE=$(date +%Y%m%d) # 备份配置 cp ~/.openclaw/openclaw.json $BACKUP_DIR/openclaw.json.backup.$DATE cp ~/.openclaw/.env $BACKUP_DIR/.env.backup.$DATE tar -czvf $BACKUP_DIR/openclaw-full-backup-$DATE.tar.gz ~/.openclaw/ --exclude='*.log' --exclude='sessions/' # 保留最近30天的备份 find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete

# 恢复配置文件 cp ~/openclaw-backups/openclaw.json.backup.20260204 ~/.openclaw/openclaw.json # 恢复完整备份 tar -xzvf ~/openclaw-backups/openclaw-full-backup-20260204.tar.gz -C ~/ # 重启网关生效 openclaw gateway restart

# 1. 停止网关服务 openclaw gateway stop # 2. 备份配置（必做） cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.before-update # 3. 执行更新（一键脚本安装的用户） curl -fsSL https://openclaw.ai/install.sh | bash # NPM安装的用户执行：npm install -g openclaw@latest # 4. 运行诊断，修复配置兼容问题 openclaw doctor --fix # 5. 重启网关服务 openclaw gateway start # 6. 验证更新成功，查看新版本号 openclaw --version openclaw status

crontab -e # 添加以下内容 0 * * * * ~/.openclaw/monitor.sh

#!/bin/bash LOG_FILE=~/.openclaw/monitor.log echo "=== $(date) ===" >> $LOG_FILE # 检查网关状态 if ! openclaw gateway status | grep -q "running"; then echo "⚠️ Gateway 未运行，尝试重启..." >> $LOG_FILE openclaw gateway restart >> $LOG_FILE 2>&1 # 重启后再次检查 sleep 5 if openclaw gateway status | grep -q "running"; then echo "✅ Gateway 重启成功" >> $LOG_FILE else echo "❌ Gateway 重启失败，请手动排查" >> $LOG_FILE # 可在这里添加邮件/企业微信/飞书告警通知 fi fi # 健康检查 if ! openclaw health | grep -q "Model API: ✓ accessible"; then echo "⚠️ 模型API调用异常，请检查API Key和网络" >> $LOG_FILE fi

# 清理7天前的旧日志 find /tmp/openclaw -name "openclaw-*.log" -mtime +7 -delete # 清理临时文件 rm -rf ~/.openclaw/tmp/* # 清理过期会话缓存（保留最近30天） find ~/.openclaw/agents/*/sessions/ -mtime +30 -delete # 清理npm缓存 npm cache clean --force

# macOS/Linux/WSL2 export PATH="$(npm prefix -g)/bin:$PATH" # 永久生效 echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # Windows PowerShell $npmPath = npm prefix -g $env:Path += ";$npmPath" # 永久生效 [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

# macOS/Linux/WSL2 which openclaw find /usr -name openclaw -type f 2>/dev/null find ~/.npm -name openclaw -type f 2>/dev/null # Windows PowerShell where.exe openclaw

# 运行诊断，检查配置文件 openclaw doctor # 若提示JSON格式错误，修复配置文件语法，或重置配置 openclaw reset # 选择"Config only"，仅重置配置，保留凭证和会话

# 查看占用端口的进程 # macOS/Linux/WSL2 lsof -i :18789 # Windows PowerShell netstat -ano | findstr :18789 # 解决方法1：杀死占用进程（替换为实际PID） kill -9 12345 # Linux/macOS Stop-Process -Id 12345 -Force # Windows # 解决方法2：更换端口启动 openclaw config set gateway.port 18790 openclaw gateway restart

openclaw gateway run --port 18789 --verbose

openclaw logs --follow | grep -i "channel\|message"

# 查看待处理的配对请求 openclaw pairing list telegram # 替换为你的渠道 # 若有pending的配对请求，批准配对 openclaw pairing approve telegram <配对码>

# 查看渠道状态，探测连通性 openclaw channels status --probe # 若显示disconnected，重新配置渠道Token，重启网关 openclaw configure --section channels.telegram openclaw gateway restart

openclaw gateway status # 若未运行，启动网关 openclaw gateway start

openclaw logs --follow | grep -i "error\|tool\|exec"

# 验证浏览器安装 google-chrome --version chromium --version # 未安装则执行安装 # macOS brew install --cask google-chrome # Linux/Ubuntu sudo apt-get update && sudo apt-get install chromium-browser

# 查看当前沙箱权限 openclaw sandbox explain # 若权限不足，修改沙箱配置，开放对应的目录访问权限

# 测试Kimi API curl https://api.moonshot.cn/v1/chat/completions \ -H "Authorization: Bearer 你的Kimi API Key" \ -H "Content-Type: application/json" \ -d '{"model":"kimi-k2.5","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

openclaw health

openclaw config set gateway.proxy.url "http://127.0.0.1:7890" openclaw gateway restart

# 确认代理环境变量已设置 env | grep -E "(HTTPS_PROXY|HTTP_PROXY)" # 测试代理是否生效 curl https://api.anthropic.com/v1/messages --head

openclaw logs --follow log show --predicate 'process == "openclaw"' --last 5m

launchctl list | grep openclaw

systemctl --user status openclaw-gateway

cp ~/.openclaw/openclaw.json.emergency ~/.openclaw/openclaw.json openclaw gateway start

openclaw onboard

openclaw reset # 选择"Config only"，仅重置配置

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.emergency cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.emergency

openclaw gateway stop

命令	核心作用
`openclaw --version`	查看当前版本号
`openclaw --help`	查看帮助文档，所有命令用法
`openclaw status`	查看核心状态概览
`openclaw status --all`	查看全量详细状态，调试必备
`openclaw health`	健康检查，验证网关、模型、渠道
`openclaw doctor`	自动诊断常见问题
`openclaw doctor --fix`	自动诊断并修复常见问题
`openclaw dashboard`	自动打开 Web 仪表板
`openclaw update`	更新 OpenClaw 到最新版本

命令	核心作用
`openclaw gateway start`	后台启动网关服务
`openclaw gateway stop`	停止后台网关服务
`openclaw gateway restart`	重启网关服务（修改配置后必执行）
`openclaw gateway status`	查看网关运行状态、PID、端口
`openclaw gateway run --verbose`	前台运行网关，实时输出日志，调试必备
`openclaw gateway install`	安装网关后台守护进程
`openclaw gateway uninstall`	卸载网关后台守护进程

命令	核心作用
`openclaw configure`	进入交互式配置界面，修改所有配置
`openclaw configure --section xxx`	配置指定模块，比如 channels.telegram
`openclaw config get`	查看完整的配置文件
`openclaw config get xxx`	查看指定配置项，比如 gateway.port
`openclaw config set xxx yyy`	设置指定配置项的值
`openclaw config unset xxx`	删除指定配置项
`openclaw reset`	重置配置，可选择仅重置配置或全量重置

命令	核心作用
`openclaw models list`	查看所有可用的模型列表
`openclaw models status`	查看当前默认模型的状态
`openclaw models scan`	扫描可用的模型，包括本地 Ollama 模型
`openclaw models set 模型ID`	设置默认模型
`openclaw models probe 模型ID`	测试指定模型的连通性

命令	核心作用
`openclaw channels login`	渠道登录，主要用于 WhatsApp 扫码登录
`openclaw channels logout`	退出渠道登录
`openclaw channels list`	查看所有已配置的渠道列表
`openclaw channels status`	查看所有渠道的运行状态
`openclaw channels status --probe`	探测所有渠道的连通性

命令	核心作用
`openclaw pairing list 渠道名`	查看指定渠道的待处理配对请求
`openclaw pairing approve 渠道名配对码`	批准指定配对请求
`openclaw pairing deny 渠道名配对码`	拒绝指定配对请求
`openclaw pairing list --all`	查看所有渠道的配对请求

命令	核心作用
`openclaw agents list`	查看所有已配置的 Agent 列表
`openclaw agents add 代理名 --workspace 路径`	添加新的 Agent
`openclaw agents status 代理名`	查看指定 Agent 的状态
`openclaw agent --agent 代理名 --message "xxx"`	给指定 Agent 发送测试消息
`openclaw sessions list`	查看所有活跃会话
`openclaw sessions history 会话ID`	查看指定会话的历史记录
`openclaw sessions reset 会话ID`	重置指定会话的上下文

命令	核心作用
`openclaw skills list`	查看所有已安装的技能列表
`openclaw skills install 技能名`	安装指定技能
`openclaw skills uninstall 技能名`	卸载指定技能
`openclaw skills config 技能名`	配置指定技能
`openclaw skills update 技能名`	更新指定技能到最新版本
`openclaw skills update --all`	更新所有已安装的技能

命令	核心作用
`openclaw logs --follow`	实时查看运行日志，排查问题必备
`openclaw logs --limit 100`	查看最近 100 行日志
`openclaw logs --since 3600000`	查看最近 1 小时的日志
`openclaw security audit`	基础安全审计
`openclaw security audit --deep`	深度安全审计
`openclaw sandbox explain`	查看当前沙箱权限配置
`openclaw approvals get`	查看高风险命令审批配置

OpenClaw 保姆级超详细教程：小白也能轻松上手的 AI 智能体

前置快速通关路径（20 分钟极速体验）

第一章 先搞懂 OpenClaw：核心定位 & 架构原理

1.1 核心定位

1.2 核心架构全景（新手必看，少走 90% 弯路）

关键名词解释

1.3 新手使用的正确心态

第二章 安装前的全量环境准备（避坑第一步）

2.1 系统与硬性要求

2.2 必备依赖安装（分平台手把手）

核心必装：Node.js（必须≥22.0 版本，否则必报错）

可选依赖

WSL2 完整安装教程（Windows 用户必看）

2.3 AI 模型 API Key 准备

2.4 国内用户网络环境准备

2.5 30 秒环境自检

第三章 OpenClaw 全方式安装教程

3.1 方式 1：一键脚本安装（新手首选，99% 兼容）

macOS / Linux / WSL2

Windows 原生系统（不推荐，优先用 WSL2）

3.2 方式 2：NPM/PNPM 手动安装（可控性强）

3.3 方式 3：源码安装（开发者专用，适合二次开发）

3.4 安装后必做的验证 & 问题解决

1. 验证安装成功

2. 高频问题：安装后提示command not found

3.5 新手安装避坑指南

第四章 手把手交互式初始化配置（onboard 向导全步骤详解）

4.1 启动配置向导

4.2 每一步配置详解 & 选择建议

步骤 1：选择配置模式

步骤 2：处理现有配置

步骤 3：选择 Gateway 运行模式

步骤 4：选择 AI 模型认证方式（最核心步骤）

步骤 5：Workspace 工作目录配置

步骤 6：Gateway 网关配置

步骤 7：聊天渠道配置

步骤 8：后台守护进程安装

步骤 9：技能插件安装（可选）

步骤 10：健康检查 & 配置完成

4.3 非交互模式自动化配置（适合服务器部署）

4.4 后续配置修改

第五章 国内大模型完整接入教程

5.1 Kimi（Moonshot）从零到接入全流程

步骤 1：获取 Kimi API Key

步骤 2：通过 onboard 向导配置（推荐）

步骤 3：手动配置（已完成初始化的用户）

步骤 4：验证配置是否生效

可用 Kimi 模型列表

模型切换方法

5.2 其他国内模型配置

5.3 本地 Ollama 模型接入教程

第六章 Gateway 网关启动 & Web 控制界面使用

6.1 网关的运行方式

6.2 网关启动后的必做验证

6.3 Web 控制界面使用

6.4 网关常见配置修改

1. 修改端口

2. 修改绑定地址

第七章 聊天渠道完整接入 & 安全配对（核心必看）

7.1 渠道接入前置说明

7.2 Telegram Bot 从零接入全流程

步骤 1：创建 Telegram Bot，获取 Token

步骤 2：接入 OpenClaw

步骤 3：安全配对（最关键，否则发消息没反应）

步骤 4：白名单免配对配置（可选）

步骤 5：群聊配置

7.3 WhatsApp 接入步骤

7.4 Discord 接入步骤

7.5 iMessage 接入（仅 macOS）

第八章 新手必看：先跑通最小闭环

8.1 第一步：确认链路通畅（基础对话测试）

8.2 第二步：低风险执行任务测试

8.3 官方自检三连（必跑）

8.4 新手最佳实践

第九章 日常基础使用 & 核心能力演示

9.1 基础触发规则

9.2 媒体文件使用

9.3 高频场景指令示例

9.4 内置工具使用

9.5 技能插件安装 & 使用

第一章先搞懂 OpenClaw：核心定位 & 架构原理

第二章安装前的全量环境准备（避坑第一步）

2. 高频问题：安装后提示`command not found`

第四章手把手交互式初始化配置（onboard 向导全步骤详解）

第五章国内大模型完整接入教程

第七章聊天渠道完整接入 & 安全配对（核心必看）

第八章新手必看：先跑通最小闭环

第九章日常基础使用 & 核心能力演示

第十章进阶玩法 & 能力扩展

第十一章全方面安全加固（越能干活，越要克制）

第十二章日常维护 & 版本管理

场景 1：安装后提示`command not found`

第十四章常用命令大全（速查手册）

第十五章官方资源 & 社区支持