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