飞书机器人开启文件上传权限 | 技术博客

← 返回博客列表

    <h1>📤 飞书机器人开启文件上传权限</h1>
    <div class="meta">
        <span class="tag">飞书</span>
        <span class="tag">OpenClaw</span>
        <span class="tag">权限配置</span>
        发布于 2026-03-15
    </div>

    <div class="content">
        <h2>🎯 问题描述</h2>
        <p>在使用 OpenClaw 发送文件到飞书时，可能会遇到以下错误：</p>
        <pre><code>Access denied. One of the following scopes is required: [im:resource:upload, im:resource]</code></pre>
        <p>这意味着机器人应用没有开通文件上传的权限，需要在飞书开放平台手动申请。</p>

        <h2>🔧 解决方案</h2>
        <ol>
            <li>打开飞书开放平台：<a href="https://open.feishu.cn/" target="_blank">https://open.feishu.cn/</a></li>
            <li>登录后进入「应用管理」页面</li>
            <li>找到你正在使用的 OpenClaw 机器人应用（通常是 cli_xxx 开头）</li>
            <li>点击进入应用详情，切换到「权限管理」标签</li>
            <li>搜索并添加以下权限：
                <ul>
                    <li><code>im:resource</code> - 资源权限</li>
                    <li><code>im:resource:upload</code> - 文件上传权限</li>
                </ul>
            </li>
            <li>提交权限申请并等待审批（如果需要）</li>
            <li>申请通过后，机器人就可以发送文件了</li>
        </ol>

        <div class="warning">
            <strong>⚠️ 注意：</strong>权限申请可能需要企业管理员审批。如果是自建应用，可能需要联系企业管理员开启相应权限。
        </div>

        <h2>📋 常见权限说明</h2>
        <ul>
            <li><code>im:message</code> - 发送消息基础权限</li>
            <li><code>im:resource</code> - 资源管理权限</li>
            <li><code>im:resource:upload</code> - 上传文件权限</li>
            <li><code>im:resource:download</code> - 下载文件权限</li>
            <li><code>im:chat</code> - 群聊管理权限</li>
            <li><code>im:chat:readonly</code> - 群聊只读权限</li>
        </ul>

        <h2>🔗 相关链接</h2>
        <ul>
            <li>飞书开放平台：<a href="https://open.feishu.cn/" target="_blank">https://open.feishu.cn/</a></li>
            <li>权限问题排查：<a href="https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-fix-the-99991672-error" target="_blank">错误码 99991672 处理</a></li>
        </ul>
    </div>