OpenClaw从入门到精通：AGENTS.md等六核心文件配置、云端本地部署与大模型对接实战教程-阿里云开发者社区

OpenClaw从入门到精通：AGENTS.md等六核心文件配置、云端本地部署与大模型对接实战教程

2026-03-24 499

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 很多用户在使用OpenClaw（Clawdbot）时都会遇到同样的困扰：AI记不住习惯、理解偏差、执行混乱、乱删文件、回复风格不符预期。实际上，OpenClaw并非黑盒系统，它的行为、人格、记忆、工作流程完全由**六个核心Markdown配置文件**控制。这些文件构成了AI的“大脑、性格、手册、记忆、知识库、用户档案”，只要正确配置，就能把普通AI变成听话、稳定、专业的专属数字员工。

一、前言

很多用户在使用OpenClaw（Clawdbot）时都会遇到同样的困扰：AI记不住习惯、理解偏差、执行混乱、乱删文件、回复风格不符预期。实际上，OpenClaw并非黑盒系统，它的行为、人格、记忆、工作流程完全由六个核心Markdown配置文件控制。这些文件构成了AI的“大脑、性格、手册、记忆、知识库、用户档案”，只要正确配置，就能把普通AI变成听话、稳定、专业的专属数字员工。

本文基于2026年3月最新环境，完整讲解AGENTS.md、IDENTITY.md、SOUL.md、USER.md、TOOLS.md、MEMORY.md六大核心文件的作用、编辑方法与最佳实践，同时提供阿里云轻量服务器部署、本地MacOS/Linux/Windows11部署流程、阿里云百炼通义千问API配置、免费大模型Coding Plan对接，以及高频问题一站式解答。所有命令可直接复制，零基础用户也能彻底驯服OpenClaw。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

二、OpenClaw六大核心配置文件详解（AI的灵魂与规则）

OpenClaw的所有行为逻辑都来自~/.openclaw/workspace/目录下的六个文件，每次对话都会加载这些文件作为系统上下文，决定AI“是谁、做什么、怎么做、记得什么”。

1. AGENTS.md：工作规范与SOP（操作手册）

作用：定义AI的执行流程、命令规范、决策逻辑、安全边界、报错处理机制，相当于员工操作手册。
适用场景：规范代码流程、限制危险操作、固定工作流。
典型内容：

# 执行规范
1. 修改代码前必须先查看文件完整内容
2. 修改完成后必须执行 npm test 验证
3. 禁止删除 .env、*.key、*.json 配置文件
4. 禁止未经确认执行 rm -rf、格式化磁盘等危险命令
5. 遇到环境错误优先使用 openclaw doctor 诊断

修改时机：AI乱改代码、不按流程执行、执行危险操作时。

2. IDENTITY.md：身份认知（我是谁）

作用：定义AI的基础身份、名称、角色、定位。
典型内容：

Name: 智能助手
Role: 资深全栈工程师与效率助手
Version: 2026.3
Language: 中文

修改时机：需要AI扮演特定职业、固定名称、统一身份时。

3. SOUL.md：性格与价值观（说话风格）

作用：控制AI的语气、态度、表达风格、行为底线。
典型内容：

沟通风格：简洁专业，不啰嗦，不解释多余内容
价值观：安全第一，用户利益优先，严谨可靠
禁止行为：不编造信息、不执行危险操作、不泄露配置信息
回复格式：分点清晰，重点突出，使用结构化输出

修改时机：AI说话啰嗦、语气不当、态度不专业时。

4. USER.md：用户档案（懂用户）

作用：记录你的偏好、习惯、技术栈、工作时间、特殊需求。
典型内容：

用户名：开发者
常用语言：TypeScript > JavaScript
缩进：2空格
偏好：简洁代码、自动格式化、注释清晰
工作时间：9:00-23:00
特殊需求：晚上10点后提醒休息，生成内容带结论优先

修改时机：AI不了解你的习惯、反复询问重复信息时。

5. TOOLS.md：工具与环境说明（技术备忘录）

作用：告诉AI当前环境、技术栈、路径、命令、MCP服务信息。
典型内容：

项目技术栈：Next.js + Prisma + PostgreSQL
数据库路径：./prisma/schema.prisma
构建命令：npm run build
启动命令：npm run dev
MCP服务：本地启动，端口18789

修改时机：AI不了解环境、调用工具错误、路径不匹配时。

6. MEMORY.md：长期记忆（重要结论）

作用：存储跨会话的重要信息、项目决策、Bug解决方案、关键配置。
典型内容：

2026-03-20 项目使用端口18789
2026-03-21 数据库迁移命令 npx prisma migrate dev
2026-03-22 修复启动失败：依赖缺失，执行 npm install

修改时机：AI反复遗忘关键信息、重复踩坑时。

三、2026年OpenClaw全平台标准化部署流程

（一）阿里云轻量服务器部署（推荐7×24小时运行）

适用系统：Alibaba Cloud Linux 3
开放端口：18789

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。

第二步：打开选购阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

# 更新系统
sudo yum update -y
sudo yum install -y curl git

# 安装 Node.js 22.x
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node.tar.xz
sudo tar -xf node.tar.xz -C /usr/local/
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npx /usr/bin/npx

# 配置国内镜像
npm config set registry https://registry.npmmirror.com

# 安装 OpenClaw
npm install -g openclaw

# 初始化
openclaw onboard

# 配置公网访问
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789

# 启动服务
openclaw gateway start

# 设置开机自启
echo "openclaw gateway start &" | sudo tee -a /etc/rc.d/rc.local
sudo chmod +x /etc/rc.d/rc.local

访问控制台：http://你的公网IP:18789

（二）MacOS本地部署

# 安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Node.js
brew install node

# 配置镜像
npm config set registry https://registry.npmmirror.com

# 安装OpenClaw
npm install -g openclaw

# 初始化
openclaw onboard

# 启动
openclaw gateway start

（三）Linux（Ubuntu/Debian）部署

sudo apt update
sudo apt install -y curl git nodejs npm
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start

（四）Windows11部署（管理员PowerShell）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
winget install OpenJS.NodeJS --version 22.0.0
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start

四、阿里云百炼通义千问API配置（2026稳定版）

配置文件路径：

Mac/Linux：~/.openclaw/config.json
Windows：C:\Users\用户名\.openclaw\config.json

"model": {
   
  "type": "aliyun-bailian",
  "api_key": "你的APIKey",
  "secret": "你的AccessKeySecret",
  "model_name": "qwen-turbo",
  "max_tokens": 2048,
  "temperature": 0.7,
  "timeout": 60,
  "reasoning": false
}

重启服务生效：

openclaw gateway restart

免费大模型Coding Plan配置

"model": {
   
  "type": "openai",
  "api_key": "免费密钥",
  "base_url": "https://api.coding-plan.com/v1",
  "model_name": "general-v1",
  "max_tokens": 2048,
  "temperature": 0.6
}

五、一键配置六大文件（可直接复制使用）

快速配置命令

# 打开配置目录
# Mac/Linux
open ~/.openclaw/workspace

# Windows
explorer %USERPROFILE%\.openclaw\workspace

全套稳定模板示例

AGENTS.md

1. 先查看再修改，不直接覆盖文件
2. 执行操作前给出确认步骤
3. 禁止删除配置文件与环境文件
4. 输出结构化、可执行、清晰的结果
5. 错误优先使用 openclaw doctor 排查

IDENTITY.md

Name: 高效助手
Role: 开发者、创作者、效率顾问
Style: 专业、简洁、可靠

SOUL.md

语气：冷静、专业、精炼
输出：分点、带结论、少废话
原则：安全、准确、不编造
禁止：不猜测、不虚构、不执行危险操作

USER.md

用户名：用户
语言：中文
偏好：结构化、步骤化、自动化
技术：Node.js、TypeScript、Markdown

TOOLS.md

运行端口：18789
工作目录：~/.openclaw/workspace
技能目录：skills/
启动命令：openclaw gateway start

MEMORY.md

长期记忆归档
2026-03-24 OpenClaw部署完成，端口18789
2026-03-24 模型使用阿里云百炼通义千问
2026-03-24 禁止删除配置文件

六、OpenClaw行为矫正优先级（快速驯服AI）

当AI表现异常时，按以下顺序修改文件即可快速修复：

流程乱 → 修改 AGENTS.md
性格差 → 修改 SOUL.md
身份错 → 修改 IDENTITY.md
不懂你 → 修改 USER.md
环境错 → 修改 TOOLS.md
记不住 → 修改 MEMORY.md 或清理 memory/ 日志

七、常用命令合集

# 启动服务
openclaw gateway start

# 重启服务
openclaw gateway restart

# 查看状态
openclaw gateway status

# 查看日志
openclaw logs

# 系统诊断
openclaw doctor

# 打开配置目录
# Mac/Linux
open ~/.openclaw
# Windows
explorer %USERPROFILE%\.openclaw

八、高频常见问题一站式解答

1. AI记不住信息

清理短期记忆：

rm ~/.openclaw/memory/$(date +%Y-%m-%d).md
openclaw gateway restart

2. AI乱删文件

在 AGENTS.md 顶部添加：

严禁删除 .env、*.json、*.key、*.md 配置文件

3. AI说话啰嗦

在 SOUL.md 添加：

沟通风格：极简，非必要不解释，直接给结果

4. 无法连接模型

检查 config.json 模型配置，重启服务：

openclaw gateway restart

5. 端口被占用

# Mac/Linux
lsof -i:18789
kill -9 进程ID

# Windows
netstat -ano | findstr "18789"
taskkill /F /PID 进程ID

6. 命令不存在

npm install -g openclaw
# 关闭终端重新打开

7. 阿里云无法访问控制台

放行安全组端口18789，确认监听0.0.0.0。

8. AI不按流程执行

强化 AGENTS.md 规则，重启服务生效。

九、最佳实践：打造听话的专属AI

先配置六核心文件，再开始使用，避免行为混乱
定期更新 USER.md，让AI越来越懂你
重要结论手动写入 MEMORY.md，避免遗忘
危险操作全部写入 AGENTS.md 禁止列表
使用阿里云服务器长期运行，稳定不掉线
搭配免费模型轻量使用，降低成本

十、总结

OpenClaw的强大并不在于默认状态，而在于可高度定制。六大配置文件就是驯服AI的关键钥匙：AGENTS.md定流程、IDENTITY.md定身份、SOUL.md定性格、USER.md定用户偏好、TOOLS.md定环境、MEMORY.md定记忆。正确配置后，AI不再是随机应答的工具，而是稳定、专业、听话、能长期协作的数字员工。

本文完整覆盖2026年最新全平台部署流程、六大核心文件配置、阿里云百炼API与免费模型对接、问题一站式排查，所有命令可直接复制，零基础用户也能快速搭建并驯服OpenClaw，让AI真正服务于工作与创作。

OpenClaw从入门到精通：AGENTS.md等六核心文件配置、云端本地部署与大模型对接实战教程

一、前言

二、OpenClaw六大核心配置文件详解（AI的灵魂与规则）

1. AGENTS.md：工作规范与SOP（操作手册）

2. IDENTITY.md：身份认知（我是谁）

3. SOUL.md：性格与价值观（说话风格）

4. USER.md：用户档案（懂用户）

5. TOOLS.md：工具与环境说明（技术备忘录）

6. MEMORY.md：长期记忆（重要结论）

三、2026年OpenClaw全平台标准化部署流程

（一）阿里云轻量服务器部署（推荐7×24小时运行）

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

（二）MacOS本地部署

（三）Linux（Ubuntu/Debian）部署

（四）Windows11部署（管理员PowerShell）

四、阿里云百炼通义千问API配置（2026稳定版）

免费大模型Coding Plan配置

五、一键配置六大文件（可直接复制使用）

快速配置命令

全套稳定模板示例

六、OpenClaw行为矫正优先级（快速驯服AI）

七、常用命令合集

八、高频常见问题一站式解答

1. AI记不住信息

2. AI乱删文件

3. AI说话啰嗦

4. 无法连接模型

5. 端口被占用

6. 命令不存在

7. 阿里云无法访问控制台

8. AI不按流程执行

九、最佳实践：打造听话的专属AI

十、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

OpenClaw从入门到精通：AGENTS.md等六核心文件配置、云端本地部署与大模型对接实战教程

一、前言

二、OpenClaw六大核心配置文件详解（AI的灵魂与规则）

1. AGENTS.md：工作规范与SOP（操作手册）

2. IDENTITY.md：身份认知（我是谁）

3. SOUL.md：性格与价值观（说话风格）

4. USER.md：用户档案（懂用户）

5. TOOLS.md：工具与环境说明（技术备忘录）

6. MEMORY.md：长期记忆（重要结论）

三、2026年OpenClaw全平台标准化部署流程

（一）阿里云轻量服务器部署（推荐7×24小时运行）

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

（二）MacOS本地部署

（三）Linux（Ubuntu/Debian）部署

（四）Windows11部署（管理员PowerShell）

四、阿里云百炼通义千问API配置（2026稳定版）

免费大模型Coding Plan配置

五、一键配置六大文件（可直接复制使用）

快速配置命令

全套稳定模板示例

六、OpenClaw行为矫正优先级（快速驯服AI）

七、常用命令合集

八、高频常见问题一站式解答

1. AI记不住信息

2. AI乱删文件

3. AI说话啰嗦

4. 无法连接模型

5. 端口被占用

6. 命令不存在

7. 阿里云无法访问控制台

8. AI不按流程执行

九、最佳实践：打造听话的专属AI

十、总结

热门文章

最新文章

相关电子书