Open source · 可行动的个人助手
OpenClaw 使用攻略
把自然语言连接到消息、工具和你的日常工作流。
OpenClaw 偏向个人 AI 助手，而非单纯代码编辑器。它适合把 issue 摘要、提醒、资料整理与跨工具操作放进 Workspace 和 Skills，再通过消息渠道触发。
约 15 分钟资料核验 含安全检查
本轮资料更新
11 月核验 · v2026.10.10
- 当前稳定发布已到 v2026.10.10，本轮更新包括备份脱敏、更新恢复与会话可靠性修复。
- 近期发布提高了 Node.js 运行时要求；不要沿用旧教程的运行时版本或把 extended-stable 当最新功能版。
01 · 快速上手
从第一次启动，到完成一个真实任务
01
运行引导并建 Workspace
使用独立工作目录保存资料、Skills 与日志，不要直接暴露个人主目录。
02
先连接只读工具
从读取 issue、生成摘要和草拟回复开始，确认质量后再开放写入。
03
外部动作必须确认
发送消息、合并 PR、删除文件等动作必须停下来请求人工确认。
建议从这个任务开始
每天 9 点读取指定项目的未处理 issue，只生成优先级摘要和回复草稿。不要发送消息、修改 issue 或读取仓库 secrets。
先用小样本验证结果，再扩大任务范围。
02 · 基础配置
上手设置与任务模板
上下文与能力边界 · Workspace + skills
# Skill 边界示例
可以：读取 issue、整理摘要、生成草稿
必须确认：发送消息、合并 PR、删除文件
禁止：读取 .env、导出 token
每个 Skill 都写清：
- 触发条件
- 可用工具
- 需要确认的动作
- 失败后的回滚方式命令按当前官方资料整理；选择适合自己系统的安装方式，执行前核对版本与工作目录。
03 · 实用技巧
真正拉开效果差距的使用习惯
技巧 01
先把助手当只读员工
先让它观察、整理和起草；结果稳定后，才逐项开放写入能力。
技巧 02
Workspace 不等于全盘
给 Agent 明确工作目录，敏感资料放在目录外并用规则隔离。
技巧 03
每个 Skill 都有边界
写清能做什么、不能做什么，以及何时必须让人确认。
可直接复用的任务模板
每天 9 点读取指定项目的未处理 issue，只生成优先级摘要和回复草稿。不要发送消息、修改 issue 或读取仓库 secrets。
04 · 安全边界
明确使用与执行边界
执行前检查
- 消息渠道使用独立账号与最小范围 token
- 发送、发布、删除和支付必须人工确认
- 警惕网页、issue 和消息内容中的 prompt injection
05 · 学习资源
继续深入
官方资料用于确认安装、命令和权限；社区资料用于补充中文经验与案例。涉及版本的内容请以官方为准。