OpenClaw 配置完全指南(文科生友好版-其实是HR特别版)

字数 4786，阅读大约需 24 分钟

创建时间: 2026-03-22

版本: v1.0（文科生友好版）

适合人群: HR、行政、财务等非技术岗位的朋友

📖 写在前面：为什么要看这个文档？

你是这样的人吗？

• • ❓ 刚安装部署好 OpenClaw，但不知道从哪里开始配置
• • ❓ 看到配置文件就头疼，全是英文和代码
• • ❓ 担心配错了把系统搞坏
• • ❓ 想要一个能看懂、照着做的指南

如果是，这份文档就是为你写的！ ✅

这份文档能保证什么？

• • ✅ 每个参数都有通俗解释（用 HR 工作举例）
• • ✅ 每个配置都有操作步骤（复制粘贴就能用）
• • ✅ 所有内容都经过官方核对（不会出错）
• • ✅ 大量 HR 场景案例（招聘、考勤、员工关系等）
• • 🦞 龙虾认证：零基础也能看懂！
• • ❓ 看到配置文件就头疼，全是英文和代码
• • ❓ 担心配错了把系统搞坏
• • ❓ 想要一个能看懂、照着做的指南

如果是，这份文档就是为你写的！ ✅

这份文档能保证什么？

• • ✅ 每个参数都有通俗解释（用 HR 工作举例）
• • ✅ 每个配置都有操作步骤（复制粘贴就能用）
• • ✅ 所有内容都经过官方核对（不会出错）
• • ✅ 大量 HR 场景案例（招聘、考勤、员工关系等）

🎯 第一部分：认识配置文件

1.1 配置文件是什么？

通俗理解：配置文件 = AI 助手的「岗位说明书」

HR 类比：

就像你给新员工发岗位说明书：

• • 📍 你的办公桌在哪里？（工作区）
• • 🧠 你需要什么能力？（模型）
• • 📱 用什么沟通工具？（飞书/微信）
• • 🔐 能访问哪些系统？（权限）

1.2 配置文件在哪里？

文件位置：~/.openclaw/openclaw.json

通俗理解：

• • ~ = 你的「家目录」（电脑给你分配的专属文件夹）
• • .openclaw = AI 助手的「办公室」
• • openclaw.json = 「岗位说明书」文件

如何打开：

# 方法 1：用记事本打开notepad ~/.openclaw/openclaw.json# 方法 2：用专业编辑器（推荐）code ~/.openclaw/openclaw.json

1.3 配置文件长什么样？

示例（一个完整的 HR 部门配置）：

{  // ============ 智能体配置 ============  "agents": {    "defaults": {      // 工作区：AI 助手的「办公桌」      "workspace": "~/.openclaw/workspace",      // 模型：AI 助手的「能力等级」      "model": {        "primary": "gateway/qwen3.5-plus"      }    }  },  // ============ 飞书渠道配置 ============  "channels": {    "feishu": {      "enabled": true,  // 启用飞书      // 多账号：多个机器人分身      "accounts": {        // 主机器人        "main": {          "appId": "cli_xxx",          "appSecret": "xxx",          "botName": "公司助手"        },        // HR 专属机器人        "hr": {          "appId": "cli_yyy",          "appSecret": "yyy",          "botName": "HR 助手"        }      }    }  },  // ============ 安全配置 ============  "security": {    "exec": {      // 只允许执行安全的命令      "defaultPolicy": "allowlist",      "allowlist": ["git", "ls", "cat"]    }  }}

别怕！ 我们一个一个部分来解释！

🎯 第二部分：核心配置详解（HR 场景版）

2.1 智能体配置（agents）

作用：配置 AI 助手的基本信息

📍 工作区配置（workspace）

配置项：agents.defaults.workspace

通俗解释：AI 助手的「工位」放在哪里

HR 场景：

配置示例：

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace"    }  }}

常见位置：

什么时候需要改：

• • ✅ C 盘空间不够了，想放 D 盘
• • ✅ 公司有统一的文件服务器
• • ✅ 多个 AI 助手需要隔离

🧠 模型配置（model）

配置项：agents.defaults.model.primary通俗解释：AI 助手的「技能特长」

HR 场景：

配置示例：

{  "agents": {    "defaults": {      "model": {        "primary": "gateway/qwen3.5-plus"      }    }  }}

常见模型对比：

HR 场景选择建议：

重要提醒：

• • ⚠️ 不是越贵越好，而是匹配场景最重要
• • ⚠️ 就像你不会让博士做前台接待一样
• • ✅ 日常问答用 qwen3.5-plus 就够了
• • ✅ 复杂分析再用 qwen3-max

🤔 思考模式（thinking）

配置项：agents.defaults.thinking

通俗解释：AI 助手要不要「先想想再回答」

HR 场景：

配置示例：

{  "agents": {    "defaults": {      "thinking": "on"  // 或 "off"    }  }}

两种模式对比：

HR 场景建议：

2.2 渠道配置（channels）

作用：配置 AI 助手需要用哪些内部沟通工具工作

📱 启用飞书（enabled）

配置项：channels.feishu.enabled

通俗解释：要不要让 AI 助手用飞书工作

HR 场景：

配置示例：

{  "channels": {    "feishu": {      "enabled": true  // 或 false    }  }}

什么时候用 true/false：

🤖 多账号配置（accounts）

配置项：channels.feishu.accounts

通俗解释：配置多个机器人分身

HR 场景：

配置示例：

{  "channels": {    "feishu": {      "defaultAccount": "main",  // 默认用哪个机器人      "accounts": {        // 主机器人（全公司通用）        "main": {          "appId": "cli_xxx",          "appSecret": "xxx",          "botName": "公司助手"        },        // HR 专属机器人        "hr": {          "appId": "cli_yyy",          "appSecret": "yyy",          "botName": "HR 助手"        },        // 财务专属机器人        "finance": {          "appId": "cli_zzz",          "appSecret": "zzz",          "botName": "财务助手"        }      }    }  }}

字段解释：

HR 典型场景：

场景 1：部门隔离

"accounts": {  "hr": { ... },        // HR 部门专用  "finance": { ... },   // 财务部门专用  "admin": { ... }      // 行政部门专用}

场景 2：环境隔离

"accounts": {  "prod": { ... },      // 生产环境（真实员工使用）  "test": { ... }       // 测试环境（HR 测试用）}

场景 3：功能隔离

"accounts": {  "recruit": { ... },   // 招聘专用（筛选简历、安排面试）  "attendance": { ... },// 考勤专用（请假、加班）  "training": { ... }   // 培训专用（课程安排、考试）}

🔐 私聊权限（dmPolicy）

配置项：channels.feishu.dmPolicy

通俗解释：私聊时，谁可以跟机器人说话

HR 场景：

配置示例：

{  "channels": {    "feishu": {      "dmPolicy": "pairing"  // 或 "open" / "allowlist"    }  }}

三种模式对比：

HR 场景建议：

📋 白名单（allowFrom）

配置项：channels.feishu.allowFrom

通俗解释：只有名单上的人可以用

HR 场景：

配置示例：

{  "channels": {    "feishu": {      "allowFrom": ["ou_zhangsan", "ou_lisi", "ou_wangwu"]    }  }}

HR 典型场景：

场景 1：高管专属服务

"allowFrom": [  "ou_ceo",      // CEO  "ou_cfo",      // CFO  "ou_cto"       // CTO]

场景 2：HR 团队内部使用

"allowFrom": [  "ou_hr_manager",    // HR 经理  "ou_hr_specialist", // HR 专员  "ou_hr_intern"      // HR 实习生]

场景 3：项目组成员

"allowFrom": [  "ou_project_a_1",  "ou_project_a_2",  "ou_project_a_3"]

如何获取用户 ID：

方法 1：查看飞书消息日志

# 让员工给机器人发条消息，然后查看日志openclaw gateway logs | grep "sender_id"# 输出：sender_id: ou_xxxxxx

方法 2：用飞书搜索工具

// 在飞书开发者后台搜索员工搜索姓名 → 获取 open_id

2.3 安全配置（security）

作用：保护公司数据安全

🛡️ 执行权限（exec）

配置项：security.exec.defaultPolicy

通俗解释：允许 AI 助手执行哪些电脑命令

HR 场景：

配置示例：

{  "security": {    "exec": {      "defaultPolicy": "allowlist",  // 推荐      "allowlist": [        "git",      // 版本管理        "ls",       // 查看文件        "cat"       // 读取文件      ]    }  }}

三种策略对比：

HR 场景建议：

白名单示例：

"allowlist": [  "git",      // 版本管理（安全）  "ls",       // 列出文件（安全）  "cat",      // 查看文件（安全）  "grep"      // 搜索内容（安全）]

黑名单示例：

"denylist": [  "rm -rf",   // 删除文件（危险！）  "sudo",     // 管理员权限（危险！）  "curl | bash" // 下载执行（危险！）]

2.4 日志配置（logging）

作用：记录 AI 助手做了什么

📝 日志级别（consoleLevel）

配置项：logging.consoleLevel

通俗解释：日志记录的详细程度

HR 场景：

配置示例：

{  "logging": {    "consoleLevel": "info"  // 推荐  }}

级别对比：

HR 场景建议：

🎯 第三部分：HR 场景配置模板

场景 1：第一次安装（HR 个人使用）

背景：你是 HR，第一次使用 AI 助手，想要一个简单的配置

配置模板：

{  // 智能体配置  "agents": {    "defaults": {      // 工作区：默认位置      "workspace": "~/.openclaw/workspace",      // 模型：选择平衡型      "model": {        "primary": "gateway/qwen3.5-plus"      },      // 思考模式：开启（更准确）      "thinking": "on"    }  },  // 飞书配置  "channels": {    "feishu": {      "enabled": true,      // 单账号模式      "appId": "cli_xxx",      "appSecret": "xxx",      // 私聊权限：先配对      "dmPolicy": "pairing"    }  },  // 安全配置  "security": {    "exec": {      "defaultPolicy": "allowlist",      "allowlist": ["git", "ls", "cat", "grep"]    }  },  // 日志配置  "logging": {    "consoleLevel": "info"  }}

适用场景：

• • ✅ HR 个人使用
• • ✅ 处理日常员工问答
• • ✅ 不需要复杂功能

场景 2：多部门隔离（HR/财务/行政）

背景：公司有多个部门，每个部门需要一个专属机器人

配置模板：

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace",      "model": {        "primary": "gateway/qwen3.5-plus"      }    }  },  "channels": {    "feishu": {      "enabled": true,      "defaultAccount": "hr",  // 默认用 HR 机器人      // 多账号配置      "accounts": {        // HR 部门        "hr": {          "appId": "cli_hr",          "appSecret": "xxx",          "botName": "HR 助手",          "dmPolicy": "pairing"        },        // 财务部门        "finance": {          "appId": "cli_finance",          "appSecret": "yyy",          "botName": "财务助手",          "dmPolicy": "allowlist",          "allowFrom": ["ou_cfo", "ou_finance_1", "ou_finance_2"]        },        // 行政部门        "admin": {          "appId": "cli_admin",          "appSecret": "zzz",          "botName": "行政助手",          "dmPolicy": "pairing"        }      }    }  },  "security": {    "exec": {      "defaultPolicy": "allowlist",      "allowlist": ["git", "ls", "cat"]    }  }}

适用场景：

• • ✅ 多部门独立使用
• • ✅ 财务部门需要更高权限控制
• • ✅ 各部门数据隔离

场景 3：招聘专用机器人

背景：HR 需要一个专门处理招聘的机器人

配置模板：

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace/recruit",  // 独立工作区      "model": {        "primary": "gateway/qwen3-max"  // 更强的模型（写 JD、筛简历）      },      "thinking": "on"    }  },  "channels": {    "feishu": {      "enabled": true,      "appId": "cli_recruit",      "appSecret": "xxx",      "botName": "招聘助手",      // 对外公开（候选人也可以咨询）      "dmPolicy": "open"    }  },  "security": {    "exec": {      "defaultPolicy": "allowlist",      "allowlist": ["git", "ls", "cat", "grep"]    }  },  "logging": {    "consoleLevel": "info"  }}

适用场景：

• • ✅ 招聘专用（筛选简历、安排面试）
• • ✅ 对外服务（候选人咨询）
• • ✅ 需要更强的模型能力

场景 4：高管专属服务

背景：为公司高管提供专属 AI 助手服务

配置模板：

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace/executive",      "model": {        "primary": "gateway/qwen3-max"  // 最强模型      }    }  },  "channels": {    "feishu": {      "enabled": true,      "appId": "cli_executive",      "appSecret": "xxx",      "botName": "高管助手",      // 只允许高管使用      "dmPolicy": "allowlist",      "allowFrom": [        "ou_ceo",        "ou_cfo",        "ou_cto",        "ou_coo"      ]    }  },  "security": {    "exec": {      "defaultPolicy": "allowlist",      "allowlist": ["ls", "cat"]  // 只允许读取    }  },  "logging": {    "consoleLevel": "warn"  // 只记录重要的  }}

适用场景：

• • ✅ 高管专属服务
• • ✅ 最高安全级别
• • ✅ 只记录重要日志

场景 5：测试环境（HR 测试用）

背景：HR 想先测试一下，不直接影响员工

配置模板：

{  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace/test",  // 独立测试区      "model": {        "primary": "gateway/qwen3.5-plus"      },      "thinking": "off"  // 快速响应（测试用）    }  },  "channels": {    "feishu": {      "enabled": true,      "appId": "cli_test",      "appSecret": "xxx",      "botName": "测试助手",      // 只允许 HR 团队使用      "dmPolicy": "allowlist",      "allowFrom": [        "ou_hr_manager",        "ou_hr_specialist"      ]    }  },  "security": {    "exec": {      "defaultPolicy": "denylist",  // 宽松一点      "denylist": ["rm -rf", "sudo"]    }  },  "logging": {    "consoleLevel": "debug"  // 详细日志（方便排查）  }}

适用场景：

• • ✅ 上线前测试
• • ✅ HR 团队内部测试
• • ✅ 需要详细日志排查问题

🎯 第四部分：配置检查清单

初次配置必做（照着打勾）

• •设置 agents.defaults.workspace（工作区位置）
• •设置 agents.defaults.model.primary（选择模型）
• •配置 channels.feishu.appId 和 appSecret（飞书凭证）
• •设置 channels.feishu.dmPolicy（私聊权限）
• •设置 security.exec.defaultPolicy（安全策略）
• •设置 logging.consoleLevel（日志级别）

生产环境推荐（正式上线前检查）

• •security.exec.defaultPolicy = allowlist（白名单模式）
• •logging.consoleLevel = warn 或 error（减少日志）
• •使用环境变量存储密钥（不写在配置文件）
• •配置备份（防止丢失）
• •测试所有功能（确保正常）

开发环境推荐（测试用）

• •logging.consoleLevel = debug（详细日志）
• •agents.defaults.thinking = on（更准确）
• •使用本地插件（方便调试）
• •独立工作区（不影响生产）

🎯 第五部分：常见问题 Q&A

Q1: 配置文件在哪里？怎么打开？

答：

位置：~/.openclaw/openclaw.json

打开方法：

# Windows（用记事本）notepad %USERPROFILE%\.openclaw\openclaw.json# Mac/Linux（用文本编辑器）code ~/.openclaw/openclaw.json

HR 类比：

Q2: 修改配置后需要重启吗？

答：需要！

openclaw gateway restart

HR 类比：

Q3: 配置错了怎么办？会不会搞坏系统？

答：不会搞坏，但 AI 助手可能无法启动。

解决方法：

# 1. 检查配置格式cat ~/.openclaw/openclaw.json | jq .# 2. 运行诊断openclaw doctor# 3. 恢复备份cp ~/.openclaw/openclaw.json.backup.20260322 ~/.openclaw/openclaw.jsonopenclaw gateway restart

HR 类比：

Q4: 如何备份配置？

答：

# 手动备份cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d)# 示例：备份到 openclaw.json.backup.20260322

HR 类比：

Q5: 多个 HR 可以共用一个配置吗？

答：可以，但推荐各自配置各自的。

方案 1：共用配置

{  "channels": {    "feishu": {      "accounts": {        "hr_team": { ... }  // HR 团队共用      }    }  }}

方案 2：各自配置（推荐）

// HR 经理的配置{  "channels": {    "feishu": {      "accounts": {        "hr_manager": { ... }      }    }  }}// HR 专员的配置{  "channels": {    "feishu": {      "accounts": {        "hr_specialist": { ... }      }    }  }}

HR 类比：

Q6: 如何知道配置是否生效？

答：

# 1. 检查 Gateway 状态openclaw gateway status# 2. 查看日志openclaw gateway logs --follow# 3. 测试功能# 在飞书中给机器人发消息，看是否响应

HR 类比：

Q7: 环境变量是什么？为什么要用？

答：

环境变量 = 电脑系统级别的「便签纸」

不用环境变量（不推荐）：

{  "models": {    "apiKey": "sk-123456789"  // 密码直接写在文件里（危险！）  }}

使用环境变量（推荐）：

{  "models": {    "apiKey": "${GATEWAY_API_KEY}"  // 密码存在别处  }}// ~/.openclaw/.env 文件GATEWAY_API_KEY=sk-123456789

HR 类比：

Q8: 多久备份一次配置？

答：

推荐频率：

• • 每次修改配置后 → 立即备份
• • 每周 → 定期检查备份

备份脚本（可选）：

# 添加到定时任务，每周五自动备份0 17 * * 5 cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d)

HR 类比：

Q9: 配置文件可以分享给其他人吗？

答：可以，但要注意：

可以分享的内容：

• • ✅ 配置结构
• • ✅ 参数说明
• • ✅ 配置示例

不能分享的内容：

• • ❌ appId 和 appSecret（相当于密码）
• • ❌ API Key（相当于密码）
• • ❌ 其他敏感信息

分享前处理：

// 分享前，把敏感信息替换成 xxx{  "appId": "cli_xxx",      // 替换真实 ID  "appSecret": "xxx",      // 替换真实密码  "apiKey": "xxx"          // 替换真实密钥}

HR 类比：

Q10: 配置太复杂了，有没有简单的方法？

答：有！用模板！

最简单的方法：

• • 复制上面的「场景 1：第一次安装」配置
• • 修改 appId 和 appSecret 为你的
• • 保存并重启

openclaw gateway restart

HR 类比：

🎯 第六部分：术语对照表（HR 版）

🎯 第七部分：下一步

你已经学会了：

• • ✅ 配置文件是什么
• • ✅ 每个配置参数的含义（用 HR 场景理解）
• • ✅ 如何根据自己的需求配置
• • ✅ 常见问题如何解决

接下来可以：

• • 动手实践：按照上面的模板配置一个
• • 深入学习：阅读技术版文档了解更多细节
• • 分享经验：教会其他 HR 朋友

📞 需要帮助？

如果还有不明白的地方：

• • 查看官方文档：https://docs.openclaw.ai
• • 加入社区：加入雷神的OpenClaw社群咨询

记住：配置其实很简单，就像给新员工发岗位说明书一样！🎉

祝你使用愉快！😄