OpenClaw 核心命令速查手册 (2026 增强版)

OpenClaw 是一个高隐私、可扩展的 AI 助手网关。本手册旨在帮助开发者快速掌握从基础配置到生产环境加固、数据备份、故障排查的全量核心命令。

1. 🛠️ 全局参数与环境隔离
2. 🚀 快速起步与基础配置
3. 🌐 核心网关 (Gateway) 管理与控制面板
4. 🛡️ 安全审计与生产环境加固
5. 💬 消息、频道与会话控制
6. 🧠 AI 模型、技能与内存
7. 📱 设备/节点 (Devices/Nodes) 管理
8. 📂 工作区核心文件 (Files)
9. 💾 数据备份与恢复 (Backup)
10. 🚨 常见问题排障 (Troubleshooting)

1. 🛠️ 全局参数与环境隔离

在执行任何 openclaw 命令前，可以添加以下全局 Flag 来改变运行环境：

参数	说明	示例
`--dev`	开发模式，状态隔离在 ~/.openclaw-dev	`openclaw --dev gateway start`
`--profile <name>`	使用指定配置文件，实现多助手切换	`openclaw --profile work doctor`
`--log-level <level>`	设置日志级别 (debug/info/warn/error)	`openclaw --log-level debug logs`
`--no-color`	禁用 ANSI 颜色（适用于 CI/CD 环境）	`openclaw --no-color status`

2. 🚀 快速起步与基础配置

初始化与工作区

# 交互式初始化
openclaw onboard --wizard

# 手动初始化指定路径
openclaw setup --workspace ~/my-ai-Agent

# 设置 Shell 自动补全 (以 Zsh 为例)
openclaw completion zsh > ~/.zsh-completion
echo "source ~/.zsh-completion" >> ~/.zshrc

基础参数配置与校验

# 修改默认端口 (永久生效)
openclaw config set gateway.port 19000

# 配置模型 API Key
openclaw config set providers.mistral.apiKey "your_key_here"

# 校验配置文件 (检查语法错误或缺失项)
openclaw config validate

# 查看特定路径的配置值
openclaw config get gateway.port

3. 🌐 核心网关 (Gateway) 管理与控制面板

运行控制

# 启动 Gateway
openclaw gateway start --bind lan

# 强制启动（自动杀死占用端口的旧进程）
openclaw gateway start --force

# 重启或停止服务
openclaw gateway restart
openclaw gateway stop

Web Dashboard

# 本地自动打开
openclaw dashboard

# 远程服务器获取登录 URL 与 Token (不自动打开浏览器)
openclaw dashboard --no-open

4. 🛡️ 安全审计与生产环境加固

# 强制启用网关 Token 验证
openclaw config set gateway.authEnabled true
openclaw config set gateway.authToken "Your_Secret_Token"

# 设置 IP 白名单
openclaw config set gateway.allowlist "127.0.0.1, 10.0.0.5"

# 运行深度安全审计
openclaw security audit --deep

5. 💬 消息、频道与会话控制

# 频道登录
openclaw channels login --channel telegram

# 测试连接性
openclaw channels test --channel telegram --target @mychat --message "Ping"

# 强制重置会话
openclaw sessions reset <session-id>

6. 🧠 AI 模型、技能与内存

# 内存索引重建 (重要：修改文件后必行)
openclaw memory index

# 查看内存状态
openclaw memory status

# 语义搜索记忆
openclaw memory search "配置细节"

7. 📱 设备/节点 (Devices/Nodes) 管理

# 查看待批准的设备
openclaw devices list

# 批准手机端配对
openclaw devices approve <id>

8. 📂 工作区核心文件 (Files)

工作区元文件位于 ~/.openclaw/workspace，通过编辑这些文件可以深度定制助手：

文件名	用途说明
AGENTS.md	代理配置定义子代理（Sub-agents）或特定领域的专业角色，支持多代理协作。
HEARTBEAT.md	心跳逻辑定义 Cron 任务、周期性检查及助手主动触发的行为（如定时提醒）。
IDENTITY.md	人设设定助手的名字、性格特征、说话语气、背景故事等外在表现。
README.md	工作区概览整个 AI 工作区的总体描述、项目目标及使用说明。
SOUL.md	价值观准则决策底层逻辑、价值观、安全底线（什么绝对不能做）及思考策略。
TOOLS.md	工具清单定义助手可调用的外部工具、API 或脚本技能的描述与约束。
USER.md	用户画像记录关于你（用户）的偏好、习惯、专业背景及长期记忆信息。
MEMORY.md	长期记忆助手自动维护的知识库索引，用于 RAG 检索。

9. 💾 数据备份与恢复 (Backup)

OpenClaw 2026 版引入了原生的备份机制，用于打包配置、凭据和工作区。

创建备份

# 完整备份 (包含配置、状态、凭据和工作区)
openclaw backup create

# 导出到指定目录
openclaw backup create --output ~/my-backups/

# 仅备份配置文件
openclaw backup create --only-config

# 排除工作区文件 (仅备份系统状态和 Key)
openclaw backup create --no-include-workspace

# 备份并立即执行完整性验证
openclaw backup create --verify

校验与恢复

# 校验备份文件是否损坏或被篡改
openclaw backup verify ./2026-03-27-openclaw-backup.tar.gz

💡 提示：恢复前请务必先停止服务

10. 🚨 常见问题排障 (Troubleshooting)

典型报错及对策

错误现象	可能原因	解决方案
EADDRINUSE	端口被占用	`openclaw gateway start --force`
403 Forbidden	Token 错误	检查 gateway.authToken
Memory Not Found	索引未同步	`openclaw memory index`
Backup Failed	磁盘空间不足	`openclaw doctor` 检查环境
Config Error	配置文件语法错误	执行 `openclaw config validate`

生产环境服务管理 (Systemd 用户模式)

方法 A：自动化部署（推荐）

# 自动安装系统服务 (开机自启)
openclaw daemon install

# 启动/停止/状态查看
openclaw daemon start
openclaw daemon stop
openclaw daemon status

方法 B：手动命令管理

# 查看服务状态 (无需 sudo)
systemctl --user status openclaw-gateway

# 实时查看日志
journalctl --user -u openclaw-gateway -f

# 立即重启服务
systemctl --user restart openclaw-gateway

{{userData.name}}已认证