1
AI服务
2
基础设置
3
对话方式
4
激活
check
完成
👋 欢迎回来！
检测到您之前已配置过 OpenClawCN
🎉
您的历史配置仍然有效，可以直接开始使用
info
温馨提示
如果您需要更换 AI 服务、修改工作目录或更新许可证，可以选择「修改配置」重新设置。
第一步：选择 AI 服务
选择你要使用的 AI 平台，或者注册一个新账号
💡
不知道选哪个？选「Kimi Code」就对了！代码专用模型，262K 超长上下文，极速响应。也可以试试 Aliyun Code 和 GLM Code！
⚠️
配置完成后，记得在模型下拉框中选择你需要的模型！每个平台有多种模型可选。
🔥 代码助手 (Coding Plan)
☁️
Aliyun Code
一个 Key 调 Qwen3.5/Kimi-K2.5/GLM-5/MiniMax · 模型聚合
rocket_launch
免费注册 AI Star
check_circle
⚡
MiniMax Code
MiniMax-M2.5 · Coding Plan 订阅 · Anthropic 协议
rocket_launch
订阅 Coding Plan
check_circle
expand_more
🇨🇳 更多国内服务
expand_more
🌐 国际服务 （需要科学上网）
🤖
OpenAI
GPT-4.1 / o3 系列，ChatGPT 官方
check_circle
🧬
Anthropic Claude
Claude Sonnet 4 / Opus 4.5，编程最强
check_circle
🔷
Google Gemini
Gemini 3 系列，免费额度充足
check_circle
💚
NVIDIA NIM
高性能推理，有免费额度
check_circle
🔀
OpenRouter
聚合多家模型，统一 API，按量付费
check_circle
expand_more
🔧 本地模型 & 自定义
🎯
魔搭社区
完全免费！每日2000次调用
check_circle
🦙
Ollama 本地模型
本地运行，完全免费，数据私密
check_circle
⚙️
自定义 API
Xinference、LM Studio 或其他 OpenAI 兼容服务
check_circle
🔑
API Key
👆 点击上方金色按钮注册后获取
在对应平台的控制台获取 API Key
模型
（推荐值已选好，直接下一步即可）
✏️ 可编辑
expand_more
💡
选好后也能随时改 — 直接删改输入框里的模型名即可，不是选了就定死的
兼容 OpenAI 格式的 API 地址（如 Ollama、LM Studio）
第二步：基础设置
设置 AI 助手的能力范围和工作目录
🎯
AI 能做什么？
⚡
完全信任
解锁全部能力 · AI 可以帮你做任何事
check_circle
✅ 无任何限制，AI 可访问整个系统
✅ 自动执行复杂任务，效率最高
⚠️ 有风险，仅建议开发者或独立测试设备使用
⭐ 推荐
🏠
正常使用
平衡安全与能力 · 适合日常办公、学习、写作
check_circle
✅ 帮你打开软件、浏览网页、搜索信息
✅ 帮你在指定文件夹内读写、整理文件
⚠️ 删除文件等敏感操作会先询问你
expand_more
查看更保守的选项
🔒
只聊天
绝对安全模式 · AI 完全无法操作你的电脑
🛡️ 零风险
适合：纯问答、学习知识、头脑风暴
check_circle
📁
AI 的工作目录
folder
AI 只能在这个文件夹内读写文件
warning
重要提醒：请勿将工作目录设置在系统盘（C 盘）！AI 在工作时会创建、修改和删除文件，如果误操作可能导致系统文件损坏，影响电脑正常使用。建议选择 D 盘或其他非系统盘。
add_circle_outline
添加额外目录（可选）
expand_more
暂未添加
虽然 AI 现在很强大，但 AI 生成内容可能存在随机性或偏差。使用 OpenClawCN 即表示你已了解风险：我们不对 AI 产生的任何错误或潜在风险承担法律责任。请理性对待，安全使用哦~
第三步：选择对话方式
选择你与 AI 助手交流的方式
🌐
网页对话
✨ 推荐
直接在浏览器中和 AI 对话，零配置立即可用
✅ 零配置
✅ 立即可用
✅ 手机电脑都能访问
check_circle
💬
钉钉 / 飞书 / 企业微信机器人
通过企业IM发消息给AI（需要企业管理员权限）
需要配置
需要企业账号
check_circle
💡
配置完成后，你可以这样使用：
- 在浏览器访问
http://localhost:18789开始对话 - 也可以通过手机访问（需在同一局域网内）
- 随时可以在设置中添加钉钉/飞书/企业微信渠道
settings
配置企业IM机器人
📱
钉钉
🪶
飞书
💼
企业微信
📱
钉钉机器人配置
使用 Stream 模式，无需公网 IP，本地即可接收消息
menu_book
钉钉 Stream 模式配置指南（详细版）
📋 前置条件
- ✅ 拥有钉钉企业管理员或开发者权限
- ✅ 企业已完成钉钉认证（否则无法创建应用）
- ✅ 电脑已登录钉钉账号（用于扫码登录开放平台）
1
登录钉钉开放平台
- 打开浏览器，访问 open-dev.dingtalk.com
- 看到页面后，点击右上角的蓝色「登录」按钮
- 页面会显示二维码，打开手机钉钉 App，扫描二维码登录
- 如果你有多个企业，会弹出企业选择框，选择要创建机器人的企业
- 登录成功后，会进入「开发者后台」首页
2
创建企业内部应用
- 登录后看到开发者后台首页
- 看页面左侧的菜单栏，找到并点击「应用开发」
- 展开后会看到几个选项，点击「企业内部开发」
- 在右侧页面中，点击蓝色的「创建应用」按钮
- 弹出创建应用的表单，填写：
应用名称：给机器人起个名字，比如 "AI 助手" 或 "小智"应用描述：简单写一下用途，比如 "智能问答助手"应用图标：可以上传一个图片作为机器人头像（可跳过）
- 填写完成后，点击表单底部的「确定创建」按钮
3
获取 AppKey 和 AppSecret（重要！请复制保存）
- 创建成功后，会自动跳转到应用详情页
- 看页面左侧菜单，点击「凭证与基础信息」（在"基础信息"分组下）
- 在右侧页面中，你会看到一个表格，里面有：
Client ID（即 AppKey）： 一串字母数字，形如
dingxxxxxxxxxx，点击右边的复制图标复制它Client Secret（即 AppSecret）： 默认显示为 ****，点击「查看」按钮，可能需要手机钉钉扫码验证，验证后会显示完整的 Secret，立即复制！ - 把复制的 AppKey 和 AppSecret 粘贴到下方的输入框中
4
添加「机器人」能力
- 还是在应用详情页，看左侧菜单
- 找到「添加应用能力」并点击（可能在"应用能力"分组下）
- 右侧会显示各种能力卡片，找到「机器人」这个卡片
- 点击机器人卡片上的「添加」按钮
- 添加成功后，左侧菜单会多出一个「机器人」选项
5
配置机器人 - 选择 Stream 模式（最关键的一步！）
- 点击左侧菜单的「机器人」（刚才添加的）
- 进入机器人配置页面，你会看到一个表单
- 最重要的一步来了：找到「消息接收模式」这一项
- 你会看到两个选项：「HTTP 模式」和「Stream 模式」
- ⭐ 请选择「Stream 模式」！不要选 HTTP 模式！
- 填写下面的信息：
机器人名称：用户在钉钉里看到的机器人名字机器人描述：简单说明机器人功能
- 填好后，点击页面底部的「发布」按钮保存
选了 Stream 模式后：
✅ 不需要买服务器
✅ 不需要有公网 IP
✅ 不需要配置域名和 HTTPS
✅ 在自己电脑上运行 OpenClawCN 就能收到消息
如果选了 HTTP 模式，你需要有一台能被外网访问的服务器，配置起来很麻烦！
6
添加权限（推荐做，不做也能用）
- 点击左侧菜单的「权限管理」
- 在右侧页面顶部，有一个搜索框
- 搜索「机器人发送消息」，找到后点击「申请权限」
- 可选：搜索「通讯录」添加读取用户信息的权限
- 添加完想要的权限后，点击「批量申请」按钮
7
发布应用，让员工能用上
- 点击左侧菜单的「版本管理与发布」
- 在右侧页面，点击「创建新版本」按钮
- 填写版本信息：
版本号：填
1.0.0就行版本描述：填"首次发布"或随便写点 - 点击「保存」然后点「发布」
- 企业内部应用一般秒过审核，稍等几秒就发布成功了
❓ 常见问题
Q: 提示"AppKey 不存在或无效"？
A: 检查 AppKey 是否复制完整，确认应用已发布上线。
Q: 提示"AppSecret 不正确"？
A: AppSecret 可能已过期或复制错误，可在开放平台重新生成。
Q: 机器人不响应消息？
A: 检查：1) 应用是否已发布 2) 是否选择了 Stream 模式 3) OpenClawCN Gateway 是否正在运行
在「应用信息」→「凭证与基础信息」中获取
用于接收单聊消息回调，Stream 模式下通常不需要
🪶
飞书机器人配置
使用 WebSocket 长连接，无需公网 IP
✨ 支持能力
✅ 私聊消息
✅ 群聊 @机器人
✅ 图片/文件收发
✅ Markdown 卡片
✅ 无需公网 IP
📄 文档读写
📚 知识库访问
📊 多维表格
menu_book
飞书 WebSocket 长连接配置指南（详细版）
📋 前置条件
- ✅ 拥有飞书企业管理员或应用管理员权限
- ✅ 企业已开通飞书开放平台功能
- ✅ 电脑已登录飞书账号（用于扫码登录开放平台）
1
登录飞书开放平台
- 打开浏览器，访问 open.feishu.cn/app
- 看到页面后，点击右上角的「登录」按钮
- 页面会显示二维码，打开手机飞书 App，点击右上角「+」→「扫一扫」扫码登录
- 登录成功后，会进入「开发者后台」首页，显示你的应用列表
2
创建企业自建应用
- 在开发者后台首页，你会看到一个蓝色的「创建企业自建应用」按钮，点击它
- 弹出创建应用的表单，填写：
应用名称：给机器人起个名字，比如 "AI 助手" 或 "小飞"应用描述：简单写一下用途，比如 "智能问答机器人"应用图标：可以上传一个图片作为机器人头像（可跳过）
- 填写完成后，点击「创建」按钮
- 创建成功！会自动跳转到应用详情页
3
添加「机器人」能力
- 现在你在应用详情页，看页面左侧的菜单栏
- 找到「添加应用能力」这一项并点击
- 右侧会显示很多能力卡片，比如"网页"、"小程序"、"机器人"等
- 找到「机器人」这个卡片（有个机器人图标），点击它上面的「+ 添加」按钮
- 添加成功后，你会看到左侧菜单多了一个「机器人」选项
4
获取 App ID 和 App Secret（重要！请复制保存）
- 看左侧菜单，找到「凭证与基础信息」并点击
- 在右侧页面中，你会看到应用的基本信息
- 找到这两个重要的值：
App ID： 一串字母数字，形如
cli_a1b2c3d4e5f6（以 cli_ 开头），点击右边的复制图标复制它App Secret： 默认显示为 ****，点击「显示」按钮后会显示完整内容，立即复制！ - 把复制的 App ID 和 App Secret 粘贴到下方的输入框中
5
获取 Encrypt Key 和 Verification Token
- 看左侧菜单，找到「开发配置」这个分组
- 点击展开后，找到「事件与回调」并点击
- 找到「加密策略」，点击进入
- 就能看到 Encrypt Key 和 Verification Token
- 点击右边的小眼睛图标，就能显示出来了
- 把这两个密钥复制粘贴到下方配置输入框中
6
配置事件订阅 - 启用长连接（最关键的一步！）
- 还是在「事件与回调」页面
- 在右侧页面中，找到「事件配置方式」这一栏
- 你会看到有两个选项：
- 「将事件发送至开发者服务器」- 不要选这个！
- 「使用长连接接收事件」- ⭐ 选这个！
- 选好后，点击「保存」按钮
选了长连接模式后：
✅ 不需要买服务器
✅ 不需要有公网 IP
✅ 不需要配置域名和 HTTPS
✅ 在自己电脑上运行 OpenClawCN 就能收到消息
如果选了"发送至开发者服务器"，你需要有一台能被外网访问的服务器，配置起来很麻烦！
7
添加「接收消息」事件（必须做，否则收不到消息！）
- 还是在「事件与回调」这个页面
- 往下滚动，找到「添加事件」按钮（蓝色的），点击它
- 会弹出一个事件选择窗口
- 在搜索框中输入：
接收消息 - 在搜索结果中找到「接收消息 im.message.receive_v1」这一项
- 点击它右边的复选框打勾
- 点击窗口底部的「确认添加」按钮
- 回到事件列表，确认已经添加成功
8
添加权限（必须做，否则发不出消息！）
- 点击左侧菜单的「权限管理」
- 在右侧页面顶部，有一个搜索框
- 需要添加这几个权限（一个一个来）：
第1个（必须）：搜索
im:message，找到「获取与发送单聊、群组消息」，点击「开通权限」第2个（必须）：搜索im:message:send_as_bot，找到「以应用的身份发消息」，点击「开通权限」第3个（群聊必须）：搜索im:message.group_at_msg，找到「接收群聊中@机器人消息事件」，点击「开通权限」第4个（推荐）：搜索im:resource，找到「获取与上传图片或文件资源」，点击「开通权限」
9
发布应用，让员工能用上
- 点击左侧菜单的「版本管理与发布」
- 在右侧页面，点击「创建版本」按钮
- 填写版本信息：
版本号：填
1.0.0就行更新说明：填"首次发布"或者随便写点可用性状态：选择「所有员工可用」或者选择特定部门 - 点击「保存」
- 然后点击「申请发布」按钮
- 如果你是管理员，可以直接审批通过；否则等管理员审批
❓ 常见问题
Q: 找不到「添加应用能力」在哪？
A: 在应用详情页的左侧菜单栏，可能需要往下滚动才能看到。如果还是找不到，可能是飞书改版了，试试在菜单里找"应用能力"或"机器人"相关的选项。
Q: 提示"App ID 不存在"？
A: 检查 App ID 是否复制完整，应该以
cli_ 开头。确认没有多复制空格。Q: 机器人能收到消息，但不回复？
A: 90% 是因为权限没开！回到第 8 步，确认
im:message 和 im:message:send_as_bot 这两个权限都已开通。Q: 群聊@机器人没反应？
A: 1) 检查是否开通了
2) 确认机器人已被邀请进群（在群设置里添加机器人）
im:message.group_at_msg 权限（第 8 步）2) 确认机器人已被邀请进群（在群设置里添加机器人）
Q: 完全收不到消息？
A: 检查：1) 是否添加了
im.message.receive_v1 事件（第 7 步）2) 是否选择了"长连接"模式（第 6 步）3) 应用是否已发布（第 9 步）Q: Encrypt Key 是空的？
A: 第一次创建的应用，需要在「加密策略」页面点击「刷新」按钮生成 Encrypt Key。
在「凭证与基础信息」中获取
在「事件订阅」页面的 Encrypt Key，用于消息加密
WebSocket 模式下通常不需要
💼
企业微信机器人配置
创建自建应用，通过回调接收消息
menu_book
企业微信自建应用配置指南（详细版）
📋 前置条件
- ✅ 拥有企业微信管理员权限
- ✅ 企业已完成企业微信认证（否则功能受限）
- ⚠️ 需要公网可访问的服务器或内网穿透工具（如 ngrok、frp）
- ⚠️ 回调地址必须是 HTTPS协议
1
登录企业微信管理后台
- 打开浏览器，访问 work.weixin.qq.com
- 看到页面后，用微信 App 扫描页面上的二维码
- 在手机上确认登录，会自动进入「企业微信管理后台」
2
获取企业 ID (CorpID)
- 登录后，看页面顶部的导航栏
- 点击「我的企业」这个 Tab
- 进入页面后，一直往下滚动到页面最底部
- 在最底部会看到「企业ID」这一项
- 点击企业 ID 右边的复制图标复制它
- 把复制的企业 ID 粘贴到下方的「企业 ID (CorpID)」输入框
企业 ID 格式：以
💡 企业 ID 是固定的，一个企业只有一个，所有应用共用
ww 开头，共 18 个字符，如 ww1234567890abcdef
3
创建自建应用
- 看页面顶部的导航栏，点击「应用管理」这个 Tab
- 进入应用管理页面后，你会看到页面分成几个区域
- 找到「自建」这个区域（在页面下方）
- 点击「创建应用」按钮
- 弹出创建表单，填写：
应用 logo：上传一个图片作为机器人头像应用名称：给机器人起个名字，比如 "AI 助手"应用介绍：简单写一下功能可见范围：选择哪些部门或成员可以使用这个应用
- 填好后点击「创建应用」按钮
4
获取 AgentId 和 Secret（重要！请复制保存）
- 创建成功后，会自动跳转到应用详情页
- 在页面上方，你会看到应用基本信息
- 找到这两个重要的值：
AgentId： 一个纯数字，形如
1000002，直接复制它填到下方「应用 ID」输入框Secret： 默认是隐藏的，点击「查看」按钮，会弹出二维码让你扫码验证。用企业微信 App 扫码确认后，Secret 会显示出来，立即复制！ - 把 AgentId 和 Secret 分别填到下方的输入框中
5
配置接收消息（最关键的一步！）
- 还是在应用详情页，往下滚动
- 找到「接收消息」这个区域
- 点击「设置API接收」按钮
- 会跳转到配置页面，需要填 3 个东西：
URL（回调地址）： 填写能接收消息的地址。必须是 HTTPS 开头！
格式：https://你的域名/api/wecom/callbackToken： 点击输入框右边的「随机获取」按钮自动生成一串字符，然后复制它填到下方配置EncodingAESKey： 同样点击「随机获取」自动生成（43个字符），复制它填到下方配置
请先把 Token 和 EncodingAESKey 复制填到下方，启动 OpenClawCN 后再回来点保存
6
填写下方配置并启动 OpenClawCN
- 把刚才复制的 Token 粘贴到下方「回调 Token」输入框
- 把刚才复制的 EncodingAESKey 粘贴到下方「回调 EncodingAESKey」输入框
- 确保 企业 ID、AgentId、Secret 都已填好
- 点击「下一步」完成配置向导
- 确保 OpenClawCN Gateway 已经启动
7
回到企业微信验证回调
- OpenClawCN 启动后，回到企业微信后台的「设置API接收」页面
- 确认 URL、Token、EncodingAESKey 都已正确填写
- 点击「保存」按钮
- 企业微信会自动发一个验证请求到你的回调地址
- 如果一切正确，会提示「配置成功」
8
测试机器人
- 打开企业微信 App
- 在「工作台」中找到刚创建的应用
- 点击进入应用，发送一条消息
- 等待 AI 助手回复
🔗 没有公网服务器？使用内网穿透
如果您没有公网服务器，可以使用内网穿透工具将本地服务暴露到公网：
ngrok（推荐新手）
- 访问 ngrok.com 注册账号
- 下载 ngrok 客户端
- 运行
ngrok http 18789 - 复制生成的 HTTPS 地址作为回调 URL
frp（更稳定）
- 需要一台有公网 IP 的服务器
- 部署 frps 服务端
- 本地运行 frpc 客户端
- 配置域名解析到服务器
❓ 常见问题
Q: 提示"企业 ID (CorpID) 无效"？
A: 检查企业 ID 是否复制完整，应以 ww 开头，共 18 位字符。
Q: 提示"应用 Secret 不正确"？
A: Secret 可能已过期。进入应用详情页，点击 Secret 旁的「重置」重新获取。
Q: 回调地址验证失败？
A: 检查：1) URL 是否可公网访问 2) 是否使用 HTTPS 3) Gateway 是否已启动 4) Token 和 EncodingAESKey 是否正确
Q: 机器人不回复消息？
A: 检查：1) 回调地址是否验证通过 2) 应用可见范围是否包含当前用户 3) 查看 Gateway 日志是否收到消息
Q: ngrok 免费版地址会变怎么办？
A: 每次 ngrok 重启后地址会变，需要重新配置回调 URL。建议升级付费版或使用 frp 自建。
在「我的企业」→「企业信息」底部获取
在应用详情页顶部获取
在应用详情页点击查看 Secret 获取
在「接收消息」→「设置API接收」中配置的 Token
在「接收消息」→「设置API接收」中配置的 EncodingAESKey
第四步：激活增值服务
解锁完整体验，让 AI 助手更强大
🚀
为什么选择 OpenClawCN？
⚡
10分钟极速上手，告别3小时繁琐配置
🎯
国产 Skills 持续赋能，本地化技能开箱即用
🌐
国内国际大模型任选，硅基流动/通义/豆包/OpenAI...
✨
比原版更优质的交互，中文深度优化
🎁 增值服务
OpenClawCN 会员服务
软件免费使用，增值服务助你更高效
📚 中文教程文档 · 从入门到精通
🔌 国内AI平台适配 · UI/Skills 深度汉化
🔄 持续更新维护 · 新功能新玩法第一时间体验
💬 技术答疑支持 · 遇到问题随时咨询
在闲鱼搜索「OpenClawCN」或点击上方按钮
support_agent
免费技术支持
加载中...
获取免费专属技术支持及咨询
微信扫码加入专属技术群
info
凭证格式：以
clawd- 或 test- 开头，例如 clawd-xxxx-xxxx
协议标题
🎉 欢迎来到 ClawbotCN 世界！
感谢支持！配置已完成
🎊
配置摘要
-
checkAI 服务 -
-
check运行环境 Linux Lite 版（轻量沙盒）
-
check安全模式 -
-
check工作目录 -
-
check额外信任目录 -
-
check对话方式 -
-
check许可证 已激活
lightbulb
后续步骤
- 如需使用钉钉/飞书/企业微信，可在设置中添加渠道配置
- 把需要处理的文件放到工作目录
- 随时可以在设置中调整配置
- Skills 仓库: gitee.com/tecbinai/skills
🐧
Linux 特别提示
- 启动服务:
sudo systemctl start openclawcn - 开机自启:
sudo systemctl enable openclawcn - 查看日志:
journalctl -u openclawcn -f