更新时间：2026-09-15 GMT+08:00
macOS系统安装和登录
准备工作
如果是个人用户，请使用实名认证的华为账号登录；如果涉及多人使用，建议使用IAM用户登录。
- 华为账号：华为账号是您访问华为各网站的统一身份标识，您只需注册华为账号，即可访问所有华为服务。在登录果办OfficeAce之前，请先注册华为账号并开通华为云，实名认证。
如果您已开通华为云并进行实名认证，请忽略此步骤。
- IAM用户：由管理员在IAM中创建的用户，是云服务的使用人员，根据账号授予的权限使用资源。账号与IAM用户为隶属关系，账号拥有全部权限，IAM用户仅拥有被授予的权限。IAM用户登录后可根据权限使用云服务。管理员创建IAM用户的方法请参考创建IAM用户。
- 首次开通果办OfficeAce需admin权限，日常使用无需该权限。
- IAM用户使用果办OfficeAce需管理员授予signin::authorizeOAuth2Access、signin::createOauth2Token、agentarts::createAgreement权限，详细操作请参见创建自定义身份策略。 图1 授予IAM用户权限
下载果办OfficeAce
- 访问华为云果办OfficeAce官方网站。
- 单击“立即下载”，选择“Mac ARM64”，在浏览器右上角下载区域，可查看下载进度。 下载完成后，安装包文件名格式为OfficeAce-x.x.x-macos-arm64。图2 下载客户端
安装果办OfficeAce
系统要求：macOS 13.0及以上版本。
- 下载完成后，打开安装包，将OfficeAce拖入Applications。 图3 打开安装包
图4 拷贝
- 拷贝完成后可在应用程序中搜索到OfficeAce，双击将立即启动，界面显示加载中，加载完成后进入登录界面。 图5 安装成功
图6 登录果办OfficeAce
登录
- 启动客户端，系统将自动跳转至登录界面，请使用华为账号或IAM用户登录。
默认无需配置网络代理，如果界面提示网络连接异常，请参见界面提示网络连接异常，如何处理？进行解决。
图7 登录界面
- 账号登录后，页面将跳转至授权界面。请核对信息，并单击“确认授权”。 图8 登录授权
- 授权成功后，在弹出的对话框中单击“打开OfficeAce”切换回果办OfficeAce客户端，进入“开通服务”界面。开通服务界面进度条完成后，进入果办OfficeAce界面。 图9 开通服务
- 首次登录果办OfficeAce时，界面会弹出“服务声明以及隐私政策”弹框，请阅读后：
- 勾选“我已阅读并同意 《隐私政策声明》、《华为云公测试用服务协议》和《AgentArts服务声明》”。
- 勾选“我同意将和 OfficeAce 交互的数据用于帮助模型优化和服务改进”。
- 单击“同意并继续”，进入果办OfficeAce界面。
登录成功后，系统支持30天内免登录。在此期间再次打开客户端，将直接进入首页。
图10 果办OfficeAce首页
常见问题
- Q：配置网络代理后，无法登录OfficeAce。
A：通常情况下，个人用户在普通的家庭网络环境下使用OfficeAce，无需手动配置网络代理，直接登录即可使用。
但在以下场景中，可能需要配置网络代理：
- 企业受限网络环境（如办公网络通过代理访问外网）
- 使用第三方网络加速工具
- 网络存在特殊访问限制
如果出现登录缓慢、模型调用超时或提示“模型未加载成功，无法使用”等问题，可尝试配置代理解决。
- Q：界面提示网络连接异常，如图11所示，如何处理？ A：请检查网络或配置网络代理，确保网络能够正常访问公网。配置网络代理的操作如下：
- 单击“配置网络代理”，进入网络代理配置界面，如图12所示。
- 配置网络代理信息，参数说明如表1所示。
表1 参数说明 参数
说明
示例
启用代理
- 开启：模型调用、技能广场等外部请求将经过配置的代理服务器转发。
- 关闭：所有请求直连目标服务器。默认关闭。
开启
代理服务器
代理服务器主机地址，无需填写协议前缀。
proxy.huawei.com
端口号
代理服务器端口号。
8080
代理鉴权
仅当代理需要用户名密码时开启。开启后，下方展示用户名和密码输入区域。
开启
用户名
开启“代理鉴权”后显示。
代理服务器的认证用户名。
/
密码
开启“代理鉴权”后显示。
代理服务器的认证用户名对应的认证密码。
/
不走代理
指定无需经过代理、直接访问的IP或域名列表。匹配该列表的请求将绕过代理服务器直连目标。
以英文逗号分隔的IP或域名，支持通配符，如 *.example.com。
典型场景示例：
- localhost, 127.0.0.1：本地回环地址，无需代理。
- *.huawei.com：华为内网域名，直接走内网更快。
- 10.*, 192.168.*：内网IP段，按需添加。
127.0.0.1,localhost,*.example.com
- 配置完成后单击“保存配置”，设置完成后，单击“立即重启”使设置生效。
- Q：如何切换登录账号？单击登录后会自动登录当前账号，无法切换到其他账号。
A：请按以下步骤操作：
- 关闭当前浏览器。
- 在OfficeAce客户端左下角，单击用户名称，选择“退出登录”。
- 在登录界面，单击“使用华为云登录”，在跳转的华为云登录页面中，输入需要切换的新账号凭据完成登录。
说明： 若关闭浏览器后仍自动登录，请在浏览器设置中清除华为云相关网站的Cookie和缓存后重试。
