OpenClaw 使用指南

创建和管理 Agent

列出所有 Agent

bash

openclaw agents list

添加新 Agent

bash

openclaw agents add <agent-name> --workspace ~/.openclaw/workspace-<name>

设置 Agent 身份

bash

openclaw agents set-identity --agent main --name "My Assistant" --emoji "🦞"

从文件加载身份

bash

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

与 Agent 对话

基本对话

bash

openclaw agent --message "帮我总结今天的任务"

指定 Agent

bash

openclaw agent --agent <agent-id> --message "执行某个任务"

指定思考模式

bash

openclaw agent --message "复杂任务" --thinking high

发送到渠道并回复

bash

openclaw agent --to +1234567890 --message "状态更新" --deliver

发送消息

发送到电话号码

bash

openclaw message send --to +1234567890 --message "Hello from OpenClaw"

发送到渠道

bash

openclaw message send --channel telegram --to @username --message "Hello"

渠道管理

登录渠道

bash

openclaw channels login

查看渠道状态

bash

openclaw channels status

深度检查（探测连接）

bash

openclaw channels status --probe

工作区管理

创建工作区

bash

openclaw setup --workspace ~/.openclaw/workspace

工作区文件结构

默认工作区位置：~/.openclaw/workspace

重要文件：

AGENTS.md - Agent 指令和技能列表
SOUL.md - Agent 身份和边界
USER.md - 用户信息
TOOLS.md - 工具配置
memory/ - 记忆系统（每日日志）

初始化工作区模板

bash

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

自动化任务

Cron 任务

bash

openclaw cron add "0 9 * * *" --message "每日晨报"

Webhooks

配置 webhook 接收外部触发：

bash

openclaw webhooks add <name> --url <webhook-url>

Gmail Pub/Sub

配置 Gmail 触发器（需要额外设置）：参考文档：https://docs.openclaw.ai/automation/gmail-pubsub

更新和升级

更新 OpenClaw

bash

npm install -g openclaw@latest

或使用 pnpm：

bash

pnpm add -g openclaw@latest

更新后运行 Doctor

bash

openclaw doctor

这会：

检查配置迁移需求
修复过时的配置
检查服务状态

开发渠道切换

bash

openclaw update --channel stable|beta|dev