1. 首页首页
  2. 科技前沿科技前沿

从零开始：OpenClaw本地 AI 助手部署指南

科技前沿 • • 阅读 1

从零开始：OpenClaw本地 AI 助手部署指南OpenClaw 是一个本地 AI 助手框架 让你能在自己的电脑 树莓派或服务器上运行一个智能助手 它支持自动化任务 集成多个消息平台 浏览器自动化 系统监控 以及与飞书 GitHub 等工具的深度集成 你可以定义助手的个性 让它理解你的工作方式 逐步构建属于自己的生产力工具 GitHub 文档 技能市场 多渠道通信 OpenClaw 可以在众多平台上与你交流 多 AI 模型支持

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



OpenClaw 是一个本地 AI 助手框架，让你能在自己的电脑、树莓派或服务器上运行一个智能助手。它支持自动化任务、集成多个消息平台、浏览器自动化、系统监控，以及与飞书、GitHub 等工具的深度集成。你可以定义助手的个性，让它理解你的工作方式，逐步构建属于自己的生产力工具。

GitHub：

文档：

技能市场：

多渠道通信：OpenClaw 可以在众多平台上与你交流：

 
  
多AI 模型支持：支持任何 OpenAI 兼容的 LLM（Claude、GPT-5、Deepseek 等）
 
  
 
  
强大的工具集
 
  
 
  
隐私与控制
 
  
 
  
前置条件
 
  
 
   
安装OpenClaw的前提是部署机器上有：NodeJs>=22，并且还需要安装 Git
 
  
 
  
Windows系统：
 
  
 
   
使用Powershell执行以下命令
 
  
 
  
 
  
Linux系统：
 
  
 
  
脚本安装
 
  
 
   
通过 npm 全局安装 openclaw 并运行新手引导。
 
  
 
  
Linux、Mac：
 
  
 
  
Windows（PowerShell）：
 
  
 
  
手动NPM安装
 
  
 
   
需要系统已安装nodejs，且版本>=22
 
  
 
  
全局安装openclaw
 
  
 
  
运行新手引导向导（并安装服务）
 
  
 
  
源代码构建安装
 
  
 
  
Docker安装
 
  
在使用云服务基于Docker方式安装时遇到问题不少，特此额外记录下。
 
  
基于本地Docker安装可能没什么问题，经过一段时间使用经验来说，OpenClaw就该部署在本地，操作部署机器上的各种资源，充当你的私人助手。
 
  
Docker具体安装方式查阅下文。
 
  
 
  
选择NPM安装方式
 
  
 
   
这里使用手动NPM安装方式，也就是执行以下2行命令后将自动开始开配置引导
 
  
 
  
 
  
依赖检测与安装
 
  
如果使用脚本安装，在运行脚本后，将会自动检测并安装相关缺失依赖 在这里插入图片描述 脚本执行完成后，OpenClaw后会自动打开配置引导 在这里插入图片描述 NPM方式安装后需要执行以下命令进入新手引导向导
 
  
 
  
风险提示
 
  
选择yes回车，明白相关风险
 
  
 
  
选择操作模式
 
  
这里直接选择快速启动
 
  
 
  
选择模型供应商
 
  
根据需求选择使用那个模型供应商，这里选择的是 在这里插入图片描述
 
  
供应商授权或配置API_KEY
 
  
这里选择供应商后，复制授权链接到浏览器访问授权
 
  
 
  
完成供应商授权后，设置模型
 
  
 
  
选择聊天渠道
 
  
 
   
如何配置请参考下文
 
  
 
  
在这里插入图片描述
 
  
配置Skill
 
  
根据需要决定是否需要配置，这里选择Skip for now
 
  
 
  
Hooks配置
 
  
根据需要决定是否需要配置，这里选择Skip for now
 
  
 
  
访问
 
  
Hooks配置过后将自动启动OpenClaw服务，且控制台打印很多信息，关键的信息如下，包含访问地址与TOKEN值
 
  
 
  
建议复制带Token的URL地址到浏览器访问，例如：，它会自动配置Token信息 在这里插入图片描述 否则需要按如下截图处配置Token 在这里插入图片描述
 
  
测试
 
  
随便发送一个提问，简单测试是否配置成功 在这里插入图片描述
 
  
 
  
 
  
输入以下命令开始配置OpenClaw
 
  
 
  
依次选择Local （本机）、Channels （渠道）、Configure/link （配置链接）、选择渠道
 
  
 
  
 
  
 
  
创建飞书应用
 
  
访问飞书开放平台创建应用 在这里插入图片描述 得到AppID、AppSecrect 在这里插入图片描述 根据使用情况添加对应的权限 在这里插入图片描述 也可以根据后台日志提示开通相关权限
 
  
 
  
还可以按官方推荐，批量导入以下权限信息：
 
  
 
  
配置事件回调，选择 在这里插入图片描述 添加接收消息事件 在这里插入图片描述 然后发布应用 在这里插入图片描述
 
  
配置
 
  
需要安装一个飞书插件，执行以下命令进行安装或者配置飞书时根据提示安装
 
  
 
  
依次选择飞书聊天通道，分别进行安装插件、输入AppID+AppSecrect、选择中国域名、接受群组聊天策略、完成配置、然后选择YES配置数据访问策略、选择Open、Continue即可
 
  
 
  
添加设备
 
  
第一次对话，从新设备连到Gateway时，需要做一次性设备配对批准 在这里插入图片描述 根据提示执行对应命令即可
 
  
 
  
验证
 
  
在飞书客户端搜索到创建的应用 在这里插入图片描述再对话进行验证 在这里插入图片描述
 
  
异常
 
  
注意：在Windows环境下遇到了如下错误
 
  
 
  
根据提示，修改exec-BhaMholX.js文件的runCommandWithTimeout函数，大概196行的位置，使用以下代码替换对应代码片段后重新执行安装
 
  
 
  
 
  
 
  
创建Boot
 
  
与@BotFather对话，输入，根据提示操作创建Boot，得到Token
 
  
添加配置
 
  
1.直接喊OpenClaw配置TG
 
  
2.直接修改文件添加对应聊天通道
 
  
 
  
添加设备
 
  
在TG机器人输入，首次访问会生成配对码
 
  
 
  
使用openclaw进行配对
 
  
 
  
 
  

    命令 功能 openclaw onboard 重新进入配置向导 openclaw onboard --install-daemon 重新进入配置向导并安装服务 openclaw config 配置 openclaw status 查看运行状态 openclaw gateway --port 18789 --verbose 指定端口且前台运行 openclaw health 健康检查 openclaw gateway start 启动服务 openclaw gateway restart 重启服务 openclaw gateway stop 停止服务 openclaw logs --follow 查看实时日志 openclaw update 更新到最新版本 openclaw doctor 诊断问题 openclaw doctor --fix 尝试自动修正错误 openclaw uninstall 卸载 OpenClaw openclaw channels add 渠道添加 openclaw plugins list 查看可用插件 openclaw devices list 查看所有设备 openclaw devices approve 
    批准硬件设备 openclaw pairing approve feishu KZXXX 批准聊天渠道设备 
  
 
  
 
  
克隆项目到本地并进入
 
  
 
  
解决网络访问问题
 
  
修改，让与能正常通信
 
  
 
  
修改，让使用Docker桥接网络
 
  
 
  
解决权限问题
 
  
在 执行启动镜像之后，出现一个权限错误：
 
  
 
  
授权容器用户（uid=1000）写入root或其他用户拥有目录的权限
 
  
 
  
启动脚本
 
  
执行脚本后会自动启动openclaw容器，参考上文继续后续操作
 
  
 
  
同步Gateway Token
 
  
执行时将在文件生成一个令牌，确保中与 文件中的 值一致。
 
  
 
  
 
  
重启openclaw-gateway使配置生效
 
  
 
  
浏览器访问
 
  
 
   
OpenClaw网关会强制要求安全校验，网关默认不允许非本地（non-loopback）的设备访问控制界面（Control UI），以防止恶意网站代表你向网关发送指令，如果需要通过浏览器访问，需要配置访问权限。
 
  
 
  
1.明确指定允许访问的来源
 
  
 
  
2.让网关直接信任任何访问来源
 
  
 
  
配置后虽然能访问了，但是又遇到http无法访问，要求使用HTTPS访问 在这里插入图片描述 解决方案：
 
  
1.开启 HTTPS，利用Nginx创建一个反向代理站点即可
 
  
2.修改网关配置来跳过这个限制，网关将只依赖 Token 进行身份验证 （无效，可能是Docker部署导致）
 
  
 
  
3.使用SSH隧道 在本地终端执行以下命令后，浏览器直接访问即可
 
  
 
  
常用命令
 
  

    命令 说明 docker compose run –rm openclaw-cli onboard 重新完成初始化向导 docker compose restart openclaw-gateway 重启网关 docker compose run –rm openclaw-cli config 配置 docker compose run –rm openclaw-cli pairing approve feishu KZXXXX 添加设备 docker compose up -d –force-recreate openclaw-gateway 当修改过docker-compose.yml时重建容器 docker compose logs -f 日志查看 
  
 
  
 
  

                    


                    


                    

                        

                            

                                小讯
                            

                            

                                

                                    
                                        
                                    
                                

                            

                        

                    

                


                

                    
                    
                    

                        
                        

                             上一篇
                            2026-03-30 21:38
                        

                    

                    
                    


                    
                    
                    

                        
                        

                            下一篇 
                            2026-03-30 21:36
                        

                    

                    
                    
                


                

                    
相关推荐

                    
                

                

                    

                        版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/229768.html